メインコンテンツへスキップ

メール構成（SMTP）

スーパー管理者は複数の SMTP 送信者を維持し、1つをプラットフォームのデフォルトとしてマークし、任意でチームごとにそのデフォルトを上書きできます。プラットフォームメール（オンプレミスのパスワードリセットを含む）は、該当する場合にチームコンテキストに対して解決された構成を使用します。

これはエージェント/ワークフロー上の SMTP ツールキットとは別物です（それらの資格情報はツールキット上にあります）。Email Configuration は、招待、通知、パスワードリセットなどのシステムメッセージのためのプラットフォームのメール経路です。

前提条件​

  • スーパー管理者であること（Email Configuration はスーパー管理者専用；RBACをご覧ください）。
  • メールプロバイダーが EKB ホストからの SMTP を許可していること（必要に応じてファイアウォール / IP 許可リスト）。
  • プロバイダーのホスト、ポート、TLS（STARTTLS）か SSL（暗黙的 TLS）かがわかっていること。
  • オンプレミスのパスワードリセットとシステムメールのために、少なくとも1つの正常な構成が Default としてマークされていること。

場所​

Super Admin → Email Configuration を開きます。2つのサブタブ：

タブ目的
SMTP SettingsSMTP 構成の作成、編集、テスト、非アクティブ化、デフォルト設定
Templatesプラットフォームメールテンプレートの HTML/件名を編集

SMTP Settings のレイアウトは、左に構成の一覧、右に詳細フォームがあります。該当する場合は Default と Active のバッジが表示されます。New SMTP で空のフォームを開始します。

フィールドリファレンス​

保存に必須：Name、Host、Sender email。

フィールド必須説明
Nameはい一覧とチーム SMTP セレクタに表示されるラベル（例：Transactional Email や EU relay）。
HostはいSMTP サーバーのホスト名（例：smtp.example.com）。
Portいいえ（デフォルト 587）一般的な値：TLS なら 587、SSL なら 465、リレーでは有时候 25 や 2525。
Usernameいいえ認証付き SMTP のログインユーザー。認証なしリレーでは空欄。
PasswordいいえSMTP パスワードまたはアプリパスワード。編集時に保存済みパスワードを維持するには空欄のまま。
Clear saved password—新しいパスワードが入力されない既存構成に表示。次回保存時に保存されたシークレットを消去。Undo clear でキャンセル。
Sender emailはいプラットフォームメールに使用する From アドレス。
Sender nameいいえ（デフォルト System）From アドレスの隣に表示される表示名。
TLS—接続後の STARTTLS。ポート 587 で典型的。プロバイダーが特定の組み合わせを要求しない限り、TLS と SSL を同時に有効にしないでください。
SSL—初回接続からの暗黙的 SSL/TLS。ポート 465 で典型的。

パスワードはプラットフォームメールの暗号化が構成されている場合、暗号化されて保存されます。

一般的なプロバイダーのパターン​

プロバイダーパターンホスト（例）ポートセキュリティ
Gmail / Google Workspace（アプリパスワード）smtp.gmail.com587TLS オン
Microsoft 365 / Outlooksmtp.office365.com または smtp-mail.outlook.com587TLS オン
法人リレー（社内）リレーのホスト名25 / 587しばしば TLS；認証は任意の場合あり

ホスト、ポート、認証については常にプロバイダーの最新ドキュメントに従ってください。

構成の追加と編集​

  1. Super Admin → Email Configuration → SMTP Settings に移動します。
  2. New SMTP をクリックするか、一覧から既存の構成を選択します。
  3. フィールドリファレンスのフィールドを入力します。
  4. Save をクリックします。成功すると構成が保存されたことが確認できます。
  5. 新しい構成をデフォルトにマークしたりチームに割り当てる前に、Send test email を推奨します。

テストメールを送信する​

  1. 保存済みの構成を選択します（未保存の新規フォームは不可）。
  2. テストメールのアクションを開き、確認できる受信者アドレスを入力します。
  3. メッセージが期待した Sender email / Sender name から届くことを確認します。

テストが失敗した場合、UI は SMTP 試行のエラー詳細（認証失敗、接続拒否、TLS 不一致など）を表示します。ホスト/ポート/セキュリティ/資格情報を修正して再テストしてください。

プラットフォームのデフォルト​

アクティブな構成がちょうど1つだけ、プラットフォームのデフォルトにできます。

  1. デフォルトにしたい構成を選択します。
  2. Make default を選択して確認します。

SMTP 上書きを持たないチームはこのデフォルトを使用します。デフォルトを変更すると、Platform default に設定されたすべてのチームのメールが更新されます。

チームごとの SMTP 割り当て​

  1. Super Admin → Teams を開き、チームを選択 → Settings → Edit Settings。
  2. SMTP Configuration で以下を選択：
    • Platform default（現在の <名前>） — 現在のデフォルトを継続し今後のデフォルト変更に追従、または
    • 特定の名前付き構成 — プラットフォームのデフォルトが変わってもそのチームをその送信者に固定。
  3. チーム設定を保存します。

解決順序​

  1. チームが固定した smtp_config_id を持ち、その構成がアクティブなら → それを使用。
  2. それ以外 → プラットフォームのデフォルトを使用。
  3. 固定した構成が欠落または非アクティブなら → プラットフォームのデフォルトにフォールバック。

上書きが設定されている場合、チーム一覧のビューは SMTP ラベルの隣に実効の送信者メールアドレスを表示することがあります。

構成の非アクティブ化​

非アクティブ化は構成をソフト的に非アクティブ化します（アクティブ一覧から外れる；履歴の完全な削除ではありません）。

  • まだ使用中の送信者を非アクティブ化する前に、チームとプラットフォームのデフォルトを切り替えてください。
  • プラットフォームメールに依存している場合は、少なくとも1つの正常な Default を維持してください。

メールテンプレート​

Templates タブでプラットフォームメールテンプレート（件名と本文）を編集できます。サポートされているテンプレートにはプレビューとデフォルトへのリセットのアクションがあります。テンプレートは、関連チーム（またはプラットフォームのデフォルト）に対して解決された SMTP 経路でレンダリングされます。

パスワードリセット（オンプレミス）​

パスワードリセットメールは構成された SMTP 経路で送信され、リセットリンクはバックエンドを経由するためオンプレミスデプロイで正しく機能します。SMTP が欠落または誤構成の場合、リセットメールは失敗します（呼び出し側はサービス利用不能系のエラーを見る場合があります）。オンプレミスでセルフサービスリセットに依存する前に SMTP を構成・テストしてください。

典型的な設定​

設定アプローチ
単一の法人リレー構成を1つ、Default にマーク；すべてのチームをプラットフォームのデフォルトのまま
共有 vs テナント別送信者大半のチームはデフォルト；対話の多いテナントは各自の SMTP に上書き
プロバイダーの移行新しい構成を追加 → テスト → Default を切り替え → まだ古いホストを指すチーム別上書きを削除 → 古い構成を非アクティブ化

トラブルシューティング​

症状確認すること
テストメールが失敗EKB バックエンドからホスト/ポートへ到達可能か；TLS vs SSL；ユーザー名/パスワード；プロバイダーのアプリパスワード / IP 許可リスト
チームがまだ誤ったアドレスから送信チームの SMTP Configuration 上書き vs プラットフォームのデフォルト；意図した構成が Active かつ Default か
パスワードリセットメールが届かない（オンプレミス）プラットフォームのデフォルト SMTP が存在しテストに合格；スパムフォルダ；プロバイダーでの送信ドメインの SPF/DKIM
パスワードをクリアできないClear saved password を使用し、次に Save
SMTP ツールキットは動くがプラットフォームメールが動かない想定どおり — ツールキットの資格情報は Email Configuration とは別物

関連​