YouTrack サーバー 2024.2 ヘルプ

メールボックス統合

メールボックス統合を使用すると、YouTrack とメールサーバー間の接続をセットアップできます。この接続が確立されたら、受信メールメッセージを YouTrack のチケット、課題、コメントに変換する追加の設定を構成できます。YouTrack のチケットおよび課題に投稿されたコメントは、元のメールメッセージへの返信としてメールサーバーを通じて配信されます。

設定と基本的な動作は、統合が有効になっている YouTrack プロジェクトのタイプによって異なります。

  • ヘルプデスクプロジェクトでは、メールチャネルで顧客のリクエストを処理するための基盤としてメールボックス統合が使用されます。このセットアップの詳細については、「メール」を参照してください。

  • 課題追跡の標準プロジェクトでは、統合により、接続されたメールサービス用に構成されたルールに従って、受信メッセージが課題とコメントに変換されます。これらのルールは、メールボックス統合設定で直接構成されます。この設定の詳細については、「メールボックスと標準の課題追跡プロジェクトの統合」を参照してください。

メールボックス統合を有効にする

YouTrack で受信メールメッセージを処理するには、まずメールボックス統合を有効にして構成する必要があります。

この手順には、次の手順が必要です。

  1. 接続されたメールボックスに対するシステム全体のポーリング頻度を設定します。

  2. メールサーバーの信頼できる証明書を YouTrack にインポートする

  3. メールサービスに接続します。

接続されたメールボックスのシステム全体のポーリング頻度を設定する

YouTrack は、スケジュールに従って、指定されたメールサービスからメールメッセージを取得します。デフォルトの間隔は 1 時間ごとです。スケジュールを事前定義された間隔に変更することも、cron 式を使用してカスタム間隔を指定することもできます。複数のメールサービスに対して個別にスケジュールを設定することはできません。同じスケジュールが、YouTrack サーバーと統合されているすべてのメールサービスに適用されます。

メールメッセージを取得する間隔を指定するには、次の手順を実行する

  1. 管理メニューから、統合> メールボックス統合を選択します。

  2. システム全体のポーリング頻度メニューから、事前設定された時間間隔を選択します。別の時間間隔を指定するには、カスタムを選択し、cron 式を入力します。例: 毎日、45 分ごとに新しいデータを取得するには、次の式を使用します。

    0 0/45 * * * ?
    Fetching interval

    IMAP メールボックスの場合、最短の間隔は 2 分です。

    cron 式を記述するための構文の詳細については、cron トリガーのチュートリアル(英語)を参照してください。

メールサーバーから信頼できる証明書をインポートする

メールサーバーでは、SSL を介した安全な接続の確立が必要になる場合があります。ホストされているサーバーを YouTrack に追加する前に、SSL 証明書をインポートする必要がある場合があります。

  • メールサーバーに既知の認証局（CA）によって署名された有効な証明書がある場合、公開キーと証明書は Web ブラウザーにすでに保存されています。SSL 証明書をインポートせずにメールサーバーに接続できる必要があります。

  • メールサーバーの証明書が自己署名されている場合は、証明書と公開キーをインポートして安全な接続を確立する必要があります。

YouTrack とメールサーバー間の安全な接続を有効にするには:

  1. メールサーバーの証明書と公開キーを DER エンコードファイルとしてエクスポートします。これらのファイルは、.der、.cer、.crt 拡張子を使用します。

  2. 管理メニューから、サーバー設定> SSL 証明書を選択します。

  3. 信頼できる証明書をインポートするボタンをクリックしてください。

  4. 信頼できる証明書をインポートするダイアログで、証明書の名前を入力します。

  5. ファイルの選択ボタンをクリックして、ローカルディレクトリから証明書ファイルを選択します。

    Import trusted certificate dialog

  6. インポートボタンをクリックしてください。

    • メールサーバーの証明書が YouTrack に追加されます。

メールサービスに接続する

統合を有効にするには、1 つ以上のメールサーバーに接続する必要があります。

  • Gmail の場合、メールサービスへの接続に使用するアカウントには特別な要件があります。詳細については、Gmail を参照してください。

  • Microsoft Exchange Server および Microsoft Exchange Online (Office 365) メールボックスの場合、追加のセットアップが必要です。この統合と互換性があるようにメールサービスを構成するには、マイクロソフトエクスチェンジオンラインまたはマイクロソフトエクスチェンジサーバーの指示を読み、それに従ってください。

Google アカウントには、安全性の低いサインインテクノロジーを使用するサードパーティアプリケーションへのアクセスを制限する設定があります。定義上、これはユーザー名とパスワードで認証する接続に適用されますが、これらはハイジャックに対して脆弱です。

セットアップ要件は、安全性の低いアプリを管理するための現在の設定に基づいています。要件は、Gmail サービスでの認証に使用する Google アカウントに適用されます。

  • 自分で管理している Google アカウントに接続している場合は、Google アカウントでアプリケーション固有のパスワード（アプリパスワード）を生成し、それを認証に使用します。Google アカウントオフで安全性の低いアプリへのアクセスを有効にするオプションを残します。

    アプリパスワードは、二段階認証プロセスが有効になっているアカウントでのみ使用できます。

  • 組織が GoogleWorkspace の一部として管理している Google アカウントを使用している場合は、安全性の低いアプリへのアクセスを無効にするオプションがオンになっていることを確認してください。

    メールボックス統合設定に保存する Google アカウントでは、二段階認証プロセスを有効にする必要があります。このアカウントで Gmail サービスに接続するには、Google アカウントでアプリケーション固有のパスワードを生成します。

    • ユーザー名には、Google アカウントのユーザー名を入力します。

    • パスワードの場合、Google で生成したアプリケーション固有のパスワードを入力します。

安全性の低いアプリへのアクセスを許可することはできますが、Google は、このタイプの認証のサポートを最終的に中止することを示しています。二段階認証プロセスを有効にし、アプリのパスワードを使用して Gmail サービスで認証することを強くお勧めします。

Gmail メールボックスに接続するには:

  1. 管理メニューから統合> メールボックス統合を選択します。

  2. メールボックス統合ページで、新しいメールサーバーを追加リンクをクリックしてください。

    • サイドバーにメールボックス設定が表示されます。

      connect to a mail server

  3. 以下の設定に値を入力します。

    設定

    説明

    サーバータイプ

    統合に使用するプロトコルを選択します。Gmail は、POP/POPS および IMAP/IMAPS プロトコルをサポートしています。

    ホスト

    メールサービスの URL を入力します。例: imap.gmail.com

    ポート

    メールサービスがリッスンするポートを入力します。メールサーバープロトコルを選択すると、デフォルトのポートが自動的に設定されます。

    ユーザー名

    メールサービスへのアクセスを許可するアカウントのユーザー名を入力します。

    パスワード

    Gmail サービスへのログインに使用するアカウントのパスワードを入力します。

  4. 拡張設定セクションを展開して、以下のオプション設定を構成します。

    設定

    説明

    SSL キー

    Gmail との統合の場合、この設定は無視できます。Gmail サービスとの接続は、TLS を使用して自動的に認証されます。

    接続タイムアウト

    メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。

    ソケットタイムアウト

    ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。

  5. 接続のテストボタンをクリックして、構成を確認します。接続を確立できない場合は、設定を修正し、接続を再度テストします。

  6. サーバーの追加ボタンをクリックしてください。

    • メールボックス統合設定が保存されます。

次の手順を使用して、汎用メールサービスとの接続を構成します。

一般的なメールサービスに接続するには:

  1. 管理メニューから、統合> メールボックス統合を選択します。

  2. メールボックス統合ページで、新しいメールサーバーを追加リンクをクリックしてください。

    • サイドバーにメールボックス設定が表示されます。

      connect to a mail server

  3. 以下の設定に値を入力します。

    設定

    説明

    サーバータイプ

    メールサーバーで使用されるプロトコルを選択します。メールボックス統合は、POP/POPS および IMAP/IMAPS プロトコルをサポートします。

    ホスト

    メールサービスの URL を入力します。例: mail.server.com

    ポート

    メールサービスがリッスンするポートを入力します。メールサーバープロトコルを選択すると、デフォルトのポートが自動的に設定されます。

    ユーザー名

    メールサービスへのアクセスを許可するアカウントのユーザー名を入力します。

    パスワード

    メールサービスへのログインに使用するアカウントのパスワードを入力します。

  4. 拡張設定セクションを展開して、以下のオプション設定を構成します。

    設定

    説明

    SSL キー

    メールサーバーでクライアント SSL 認証が必要な場合は、YouTrack サーバーを識別する SSL キーをリストから選択します。

    リストには、YouTrack にすでにインポートされている SSL 鍵のみが表示されます。SSL キーを生成してアップロードする方法については、SSL キーを参照してください。

    接続タイムアウト

    メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。

    ソケットタイムアウト

    ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。

  5. 接続のテストボタンをクリックして、構成を確認します。接続を確立できない場合は、設定を修正し、接続を再度テストします。

  6. サーバーの追加ボタンをクリックしてください。

    • メールボックス統合設定が保存されます。

Microsoft Exchange Online (一般に Exchange Online、Office 365、または Microsoft 365 とも呼ばれます) との統合では、次のアクションを実行する必要があります。

クライアントアプリケーションを Microsoft Azure に登録する

このセットアップでは、次の前提条件を満たしている必要があります。

  • Microsoft Exchange Online の有効なライセンス。

  • Microsoft Azure Active Directory (AD) への管理アクセス。

移行を完了するには、Microsoft プラットフォームから次の情報を取得する必要があります。

  • 受信メッセージを取得するメールボックスのメールアドレス。このメールボックスは、アプリを登録する同じ Azure AD サービスに属している必要があります。

  • Microsoft Azure ポータルに登録されているアプリのアプリケーション（クライアント）ID。

  • Azure Active Directory テナント組織のディレクトリ (テナント) テナント ID。

  • 登録済みアプリ用に作成したクライアントシークレット。

アプリケーション（クライアント）ID およびディレクトリ（テナント）ID は、以下に示すように、クライアントアプリケーションの基本セクションにあります。

The Essentials section of a registered client application in Microsoft Azure.

クライアントシークレットは、証明書とシークレット <クライアントシークレットセクションから生成できます。

The Certificates & secrets section of a registered client application in Microsoft Azure.

このセットアップの実行方法については、Microsoft Azure の製品ドキュメント(英語)の指示に従ってください。

必要なアクセス許可をクライアントアプリに追加する

次に下記の API 権限をアプリに追加する必要があります。

  • Mail.ReadWrite は、アプリケーションパーミッションとして付与する必要があります。

  • User.Read は、委譲されたアクセス許可として付与する必要があります。

権限のリストは、クライアントアプリの API 権限設定にあります。

The API permission settings of a registered client application in Microsoft Azure.

(前提条件に記載されているように) 管理者アカウントでログインしている場合は、アプリケーションのアクセス許可 Mail.ReadWrite を自分で付与できます。そうでない場合は、アプリケーション用に構成されたアクセス許可に管理者の同意を与えるよう管理者に依頼する必要があります。

クライアントアプリのアクセス許可を構成する方法については、Microsoft Azure の製品ドキュメント(英語)の手順に従ってください。

YouTrack でのメールボックス統合設定の更新

Microsoft プラットフォームから必要な情報を収集したら、YouTrack でメールボックス統合の設定を構成できます。

Microsoft Exchange Online メールボックスに接続するには:

  1. 管理メニューから、統合> メールボックス統合を選択します。

  2. メールボックス統合ページで、新しいメールサーバーを追加リンクをクリックしてください。

    • サイドバーにメールボックス設定が表示されます。

      connect to a mail server

  3. サーバータイプ設定では、マイクロソフトエクスチェンジオンラインを選択します。

    • 統合が更新され、このサーバータイプの特定の設定が表示されます。

  4. 以下の設定に値を入力します。

    設定

    説明

    メールボックスアドレス

    インテグレーションが受信メッセージを現在取得しているメールアドレスを入力します。

    テナント ID

    Azure Active Directory テナント組織のディレクトリ（テナント）ID を入力します。

    クライアント ID

    Microsoft Azure に登録されているクライアントアプリケーションのアプリケーション（クライアント）ID を入力します。

    クライアントシークレット

    Microsoft Azure でクライアントアプリ用に生成したシークレットの値を入力します。

  5. 拡張設定セクションを展開して、以下のオプション設定を構成します。

    設定

    説明

    SSL キー

    メールサーバーでクライアント SSL 認証が必要な場合は、YouTrack サーバーを識別する SSL キーをリストから選択します。

    リストには、YouTrack にすでにインポートされている SSL 鍵のみが表示されます。SSL キーを生成してアップロードする方法については、SSL キーを参照してください。

    接続タイムアウト

    メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。

    ソケットタイムアウト

    ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。

  6. YouTrack がメールサーバーとの接続を確立できることを確認するには、接続のテストボタンをクリックします。

  7. テストが成功したら、サーバーの追加ボタンをクリックします。

    • メールボックス統合設定が保存されます。

YouTrack のメールボックス統合は、POP/POPS および IMAP/IMAPS のみをサポートします。Microsoft Exchange のデフォルトプロトコルである MAPI はサポートされていません。Microsoft Exchange に接続する場合は、次の 2 つのオプションがあります。

  • Microsoft Exchange で POP または IMAP を有効にして構成し、認証済み SMTP 設定を構成します。これらのメールコネクターを有効にすると、以下の手順に従って接続を確立できます。

    Microsoft Exchange メールボックスの特別な指示に注意してください。

  • 中間ゲートウェイサーバーを介して接続を確立します。これにより、POP/IMAP および SMTP を無効にして Exchange Server に接続できます。たとえば、DavMail 交換ゲートウェイは、独自の Exchange 形式を YouTrack が理解できるメールプロトコルに変換します。セットアップ手順については、DavMail Gateway のドキュメント(英語)を参照してください。

    このセットアップでは、以下の手順に従ってゲートウェイサーバーへの接続を確立します。

Microsoft Exchange Server の場合、メールボックス統合は共有メールボックスへの接続をサポートします。共有メールボックスのメンバーである任意のユーザーのユーザー名とパスワードを使用して認証できます。

メールサービスに接続するには:

  1. 管理メニューから、統合> メールボックス統合を選択します。

  2. メールボックス統合ページで、新しいメールサーバーを追加リンクをクリックしてください。

    • サイドバーにメールボックス設定が表示されます。

      connect to a mail server

  3. 以下の設定に値を入力します。

    設定

    説明

    サーバータイプ

    メールサーバーで使用されるプロトコルを選択します。メールボックス統合は、POP/POPS および IMAP/IMAPS プロトコルをサポートします。

    ホスト

    メールサービスの URL を入力します。例: mail.exchange.com

    ポート

    メールサービスがリッスンするポートを入力します。メールサーバープロトコルを選択すると、デフォルトのポートが自動的に設定されます。

    ユーザー名

    メールサービスへのアクセスを許可するアカウントのユーザー名を入力します。

    パスワード

    メールサービスへのログインに使用するアカウントのパスワードを入力します。

  4. 拡張設定セクションを展開して、以下のオプション設定を構成します。

    設定

    説明

    SSL キー

    メールサーバーでクライアント SSL 認証が必要な場合は、YouTrack サーバーを識別する SSL キーをリストから選択します。

    リストには、YouTrack にすでにインポートされている SSL 鍵のみが表示されます。SSL キーを生成してアップロードする方法については、SSL キーを参照してください。

    接続タイムアウト

    メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。

    ソケットタイムアウト

    ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。

  5. 接続のテストボタンをクリックして、構成を確認します。接続を確立できない場合は、設定を修正し、接続を再度テストします。

  6. サーバーの追加ボタンをクリックしてください。

    • メールボックス統合設定が保存されます。

トラブルシューティング

メールボックス統合のセットアップで課題が発生した場合は、次の条件のいずれかが当てはまるかどうかを確認してください。

状態 — メールサービスへの接続を確立できません。

原因

ソリューション

外部サービスは利用できません。

メールサービスが実行されていることを確認します。

接続がファイアウォールによってブロックされています。

YouTrack とメールサービスが使用するファイアウォールのポートを開きます。

外部サービスへの接続がプロキシサーバーによってブロックされています。

間違ったポートで接続しようとしています。

YouTrack がプロキシサーバーを介して他のサービスに接続できるように、サーバーのシステムプロパティを設定します。手順については、プロキシ設定を参照してください。

メールサーバーには安全な接続が必要です。

メールサーバーの証明書を YouTrack にインポートします。手順については、SSL 証明書を参照してください。

メールサーバーの SSL 証明書の有効期限が切れています。

更新した証明書を更新して YouTrack にインポートします。手順については、SSL 証明書を参照してください。

Microsoft Exchange メールボックスに接続しようとしていますが、メールサービスまたは YouTrack のいずれかに構成の課題があります。

次のセットアップ要件を確認してください。

  • マイクロソフトエクスチェンジオンラインまたはマイクロソフトエクスチェンジサーバーに従って、Exchange メールボックスが POP/POPS または IMAP/IMAPS のいずれかを使用し、SMTP 経由で認証するように構成されていることを確認してください。

  • メールボックス統合のプロトコル設定が、Exchange メールボックスで有効になっているプロトコルと一致することを確認します。

  • MS Exchange 互換モードチェックボックスを有効にします。

それでも接続を確立できない場合は、サポートリクエストを送信してください(英語)。

状態 — セキュリティで保護されていないプロトコルを介してメールサーバーへの接続を確立できません。YouTrack はエラー bad_request を返します。

原因

ソリューション

IMAP サーバーは、STARTTLS を有効にする拡張機能を使用しています。YouTrack では、メールサーバーへの安全な接続が必要です。

メールサーバーの SSL 証明書を YouTrack にインポートします。手順については、SSL 証明書を参照してください。YouTrack とメールサーバーの両方がプライベートコンピューターネットワークで実行されている場合、メールサーバー用の自己署名 SSL 証明書を生成およびインポートできます。

カスタムインポート 元のメールメッセージを表示する

関連ページ：

メール

メールは、顧客にとって最もアクセスしやすいコミュニケーション形式の 1 つです。ほとんどの人がメールアドレスを持っており、いつでも世界中のどこからでもメッセージを送受信できます。これにより、メールは顧客が企業に連絡するための便利かつ柔軟な方法になります。また、メールを使用すると、顧客は課題や質問を詳しく説明し、ファイルやスクリーンショットをアタッチして、サポートチームが課題を理解して解決するのに役立つ具体的な情報を提供できます。また、顧客は、保留で待ったり、複雑な電話ツリーを移動したりすることな...

メールボックスと標準の課題追跡プロジェクトの統合

メールボックス統合の主な目的は、ヘルプデスクプロジェクトでメールメッセージのチケットへの変換をサポートすることです。ただし、この機能は YouTrack 2023.1 以降でのみサポートされます。以前の YouTrack バージョンでは、課題追跡のために標準プロジェクトとのメールボックス統合を設定し、これらのプロジェクトを使用して基本的なヘルプデスクのやり取りをサポートし、外部のメールフィードバックを処理することができました。標準プロジェクト用にメールボックス統合を構成することは可能ですが、ヘル...

SSL キー

YouTrack では、SSL キーストアを YouTrack にインポートできます。キーストアは、公開鍵と秘密鍵のペア、それらが関連付けられている証明書のコンテナーです。キーストアは、サードパーティーへの接続を試行するときに、YouTrack をクライアントとして識別します。キーストアを使用して、サードパーティサービスの公開キーを（証明書の形式で）キャッシュすることもできます。外部サービスのキーと証明書を含むキーストアがある場合は、このページでアップロードできます。それ以外の場合は、SSL 証...

SSL 証明書

YouTrack を使用すると、外部サービスから信頼できる SSL 証明書をインポートできます。これらの証明書は外部サービスを信頼できる情報源として識別し、YouTrack とサードパーティサーバーの間に安全な接続を確立させます。キーストアを YouTrack にインポートすることもできます。キーストアは、YouTrack がサードパーティーに接続しようとしたときに YouTrack をクライアントとして識別します。キーストアは YouTrack の別のページで管理されています。詳しくは、SSL...

カスタムインポート

外部ソースから YouTrack にデータをインポートするには、YouTrack に組み込まれているインポートスクリプトの 1 つをカスタマイズしたり、新しいインポートスクリプトを最初から作成したりできます。カスタムインポートスクリプトは、中間データスキームとして JSON を使用して JavaScript で記述されています。YouTrack にインポートされたすべてのデータは、JSON に変換されてから、YouTrack エンティティに変換されます。新しいカスタムインポートを設定する：外部...

元のメールメッセージを表示する

プロジェクトでメールボックス統合を設定すると、接続されたメールサービスからの受信メールメッセージが自動的に新しい課題とコメントに変換されます。メールメッセージは通常、プレーンテキストと HTML の 2 つの部分で構成されます。メールメッセージの HTML バージョンには、テキストのフォーマット、色、スタイル、イメージが含まれます。フィードバックやサポートのために顧客から受信トレイに送信される一般的なメールメッセージには、通常、多くのフォーマットは含まれていませんが、スクリーンショットやハイパー...