Microsoft Graph API プロトコルを使用してメール チャンネルをセットアップする

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

お客様は、自分のメールボックスを使用して、キューにリクエストを送信できます。メールを受信して Jira Service Management でリクエストに変換するには、メール チャンネルをセットアップする必要があります。選択できるプロトコルの 1 つに Microsoft Graph API があります。このプロトコルを使用するには、いくつかの手順を踏む必要があります。

Jira Service Management 5.8 では、Microsoft Graph API は受信メールにのみ使用できます。

Microsoft Graph API は OAuth 2.0 に基づいているため、メール チャンネルのセットアップを開始する前に、Azure Active Directory 統合を設定し、Jira Service Management にアプリケーション リンクを追加する必要があります。OAuth 2.0 と Microsoft Azure の統合の設定方法をご確認ください

受信メールに Microsoft Graph API を使用するには、Azure Active Directory アプリ レジストリで自分の API 権限に次の権限を追加する必要があります。

  • Mail.ReadWrite
  • offline_access
  • Mail.ReadWrite.Shared (for shared mailboxes only)

また、Jira のアプリケーション リンク構成の [スコープ] セクションに次の URL を追加する必要があります:
https://graph.microsoft.com/Mail.ReadWrite
https://graph.microsoft.com/offline_access
https://graph.microsoft.com/Mail.ReadWrite.Shared (for shared mailboxes only)

アプリケーション リンクを設定するには、Jira 管理者または Jira システム管理者のグローバル権限を持つユーザーとしてログインする必要があります。

Microsoft Azure の API 権限

Jira Service Management でのアプリケーション リンクの設定

Azure Active Directory との統合と Jira Service Management アプリケーション リンクが準備できたら、メール チャンネルの追加に進むことができます。

  1. [プロジェクト設定] > [メール リクエスト] に移動して、新しいチャンネルを作成します。

  2. [電子メール サービス プロバイダー] として [Microsoft] を選択し、[電子メール プロトコル] として [Microsoft Graph API] を選択します。

  3. メール アドレスを入力し、認証方式として設定したアプリケーション リンクを選択します。

メール チャンネルの設定 — 認証方式の選択 

新しいメール チャンネルの作成 — メール プロトコルの選択 

4. [保存] を選択すると、Microsoft の認証ページにリダイレクトされます。ログインして、Jira に必要な権限を付与してください。それが完了したら、プロジェクト設定の [メール リクエスト] ページに戻ります。

Jira Service Management で、新たに作成された Microsoft Graph API メール チャンネルとの接続がテストされ、最初のメールがプルされます。このプロセスのステータスを確認するには、プロジェクト設定の [メール リクエスト] ページで新しいメール チャンネルの横にある アクション ボタン (アクション) > [ログを表示] を選択します。

メール チャンネルとの接続のステータス (接続ログ)

Jira Service Management では、1 分間に 1 回、未読メールがメールボックスからプルされます。メッセージが処理されると、そのメッセージは既読としてマークされます。これは新着メッセージと古いメッセージを区別するためです。メール チャンネルで処理された内容を確認するには、プロジェクト設定の [メール リクエスト] ページでチャンネルの横にある アクション ボタン (アクション) > [ログを表示] を選択します。

処理ログ内の処理済みメールのステータス

最終更新日 2024 年 7 月 21 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.