Microsoft Teams を Jira Service Management に接続する

Jira Service Management の Free プランとスタンダードプランの変更

2024 年 10 月 16 日より、Jira Service Management の高度なインシデント管理機能（メジャーインシデントやインシデント事後レビューなど）は、スタンダードプランからプレミアムプランに移行します。これ以降は、 プレミアムプランとエンタープライズプランのみがこれらの機能にアクセスできるようになります 。

Free プランとスタンダードプランの既存のプロジェクトは、既存のリクエストタイプと課題タイプを引き続きサポートします。この変更の詳細についてはこちらをご確認ください。

Microsoft Teams はチャット/ビデオ会議ツールです。Jira Service Management に接続することで、インシデント担当者がインシデントを容易にコミュニケーション、コラボレーション、解決できるようにします。これは、[インシデント] 作業カテゴリを有効にした IT サービス管理プロジェクトでサポートされています。サービスプロジェクトに作業カテゴリを追加する方法をご確認ください。

Jira Service Management を Microsoft Teams と接続することで、次のことが可能になります。

チャットや会議を簡単に作成して、インシデント中にコラボレーションを行う
応答者をチャットやミーティングに招待
チャットやミーティングでインシデントのすべての詳細情報を確認
関係者に最新情報を送信する
インシデントの優先度を更新して、チャットからインシデントを自分自身に割り当てる。
Teams でのチャットメッセージを内部メモとしてインシデントに追加したり、顧客への返信として追加したりする。

まず、サイト管理者が Jira Service Management サイトを Microsoft テナントに接続する必要があります。

Jira Service Management サイトを Microsoft テナントに接続する

Jira Service Management サイトを複数の Microsoft テナントに接続でき、その逆も可能です（1 つの Microsoft テナントを複数の Jira サイトに接続できます）。これは、チームが任意の Microsoft テナントのさまざまな Jira Service Management サイトからのアラートやインシデントに対応するのに役立ちます。

Jira 設定内の「チャット & ビデオ会議ツール」ページには、Slack、Microsoft Teams、Zoom があります。

Jira Service Management サイトを Microsoft テナントに接続するには、サイト管理者である必要があります。

Jira Service Management を開き、[設定] > [製品] > [オペレーション] > [チャット & ビデオ会議ツール] > [Microsoft Teams] に移動して、[新しいテナントを接続] を選択します。
Microsoft アカウントにサインインすると、Jira Service Management にリダイレクトされます。ここで、Microsoft Teams でチャットやミーティングを作成するには、Jira Service Management に Microsoft Teams 管理者の権限が必要であることが分かります。
Teams 管理者である場合は、[権限を付与] を選択します。
ご自身が Teams 管理者でない場合は、[リンクをコピー] を選択して Teams 管理者と共有し、Jira Service Management への権限の付与を承認してもらえるようにします。承認されたら、[権限を付与] を選択して続行します。Atlassian ChatOps で必要になる権限の詳細をご確認ください。

Microsoft テナントを Jira Service Management に接続すると、そのテナントがすべてのサービスプロジェクトで使用可能になり、インシデント用のチャットおよびミーティングの作成に利用できるようになります。Microsoft Teams のチャットまたはミーティングをインシデント用に作成する方法をご確認ください。

Microsoft テナントを特定のサービスプロジェクトで使用したくない場合は、次の方法で接続を解除できます。

サービスプロジェクトから、[プロジェクト設定] > [オペレーション] > [インシデント管理] の順に選択します。
[コミュニケーション設定] で [Microsoft Teams] オプションのオン/オフを切り替えます。

これにより、そのプロジェクトのインシデント用にチャットやミーティングを作成できなくなります。これはいつでも元に戻すことができます。

Jira Service Management サイトを Microsoft テナントから接続解除する

Jira Service Management サイトと Microsoft テナントとの接続を解除するには、サイト管理者である必要があります。

画面の右上で [設定] > [製品] の順に選択します。
[操作] で [チャット & ビデオ会議ツール] を選択します。
[Microsoft Teams] で、[アクション] の下の [X] アイコンを選択し、アクションを確認します。

接続を解除しても、Microsoft Teams 内のデータは削除されません。Jira Service Management との接続のみが削除され、Jira Service Management から新しい Microsoft Teams チャットまたはミーティングを作成できなくなるだけです。いつでも再接続できます。

Atlassian ChatOps で必要になる権限

Atlassian ChatOps で自動的にデータを読み取ったり、アクションを実行したりするには、いくつかの権限が必要です。次の表に詳細を示します。

名前	UI 参照	詳細
Channel.ReadBasic.All		タイプ: 権限委譲あなたに代わって、チャンネル名とチャンネルの説明を読み取ります。 Microsoft Teams 統合を作成する際に、チームに関連するチャンネル名を取得するために必要です。
Chat.Create		タイプ: 権限委譲あなたに代わってチャットを作成することをアプリに許可します。 Jira Service Management のインシデントビューで、ユーザーに代わって Microsoft Teams のチャットを作成するために必要です。
Chat.Create		タイプ: アプリサインインしているユーザーなしでチャットを作成することをアプリに許可します。 ChatOps アプリに代わって Microsoft Teams チャットを作成するための自動化フローで使用されます。委任された権限は使用されません。ルールを作成したユーザーがすべてのチャットに追加され、迷惑メールが届くからです。
ChatMember.ReadWrite		タイプ: 権限委譲あなたに代わってチャットへのメンバー追加や削除を行います。 Microsoft Teams で作成されたグループチャットに ChatOps アプリを (メンバーとして) 追加するために必要です。
ChatMember.ReadWrite.All		タイプ: アプリサインインしているユーザーなしで、すべてのチャットでメンバーの追加や削除を行います。 ChatOps アプリが作成したグループチャットでユーザーを管理するために、自動化フローで必要です。自動化ルールが実行されるたびに作成されるすべてのグループチャットに追加される「権限委譲」権限の代わりに、スパムを防ぐために「アプリ」権限が使用されます。これにより、ChatOps アプリがグループチャットを直接作成できるようになるため、自動化ルールの設定がすべてのチャットに追加されることを防止してノイズを減らせます。
offline_access		タイプ: 権限委譲アプリを使用していないときでも、アクセスを許可したデータの表示と更新をアプリに許可します。これによってアプリに追加の権限が付与されることはありません。offline_access スコープはリフレッシュトークンを取得するために必要です。
OnlineMeetings.ReadWrite		タイプ: 権限委譲あなたに代わってオンライン会議の読み取りや作成を行うことをアプリに許可します。 Jira Service Management のインシデントビューで、ユーザーに代わって Microsoft Teams のミーティングを作成するために必要です。
Team.ReadBasic.All		タイプ: 権限委譲あなたに代わってチームの名前と説明を読み取ります。 Jira Service Management で Microsoft Teams 統合の作成中に、ユーザーに代わって Microsoft Teams でチームのリストを取得するために必要です。
TeamsAppInstallation.ReadWriteSelfForChat		タイプ: 権限委譲ご自身がアクセス権を持つチャットにおいて、Microsoft Teams に読み取り、インストール、アップグレード、アンインストールを行う許可を与えます。これは、ChatOps アプリをチャットにインストールする必要がある、インシデントグループチャットまたはミーティングをセットアップする際に必要となります。
TeamsAppInstallation.ReadWriteSelfForChat.All		タイプ: アプリユーザーがサインインせずとも、Microsoft Teams にあらゆるチャットの読み取り、インストール、アップグレード、アンインストールを行う許可を与えます。これは自動化フローで必要となります。Microsoft Teams でインシデントグループチャットが作成されると、ChatOps アプリがそのチャットにインストールされます。
TeamsAppInstallation.ReadWriteSelfForTeam		タイプ: 権限委譲ご自身がアクセス権を持つチームにおいて、Microsoft Teams が読み取り、インストール、アップグレード、アンインストールを行う許可を与えます。 Microsoft Teams 統合が作成されたあと、ご自身に代わって ChatOps アプリをチームにインストールするために必要となります。
TeamsAppInstallation.ReadWriteSelfForUser		タイプ: 権限委譲ご自身の代わりに、Microsoft Teams が読み取り、インストール、アップグレード、アンインストールを行う許可を与えます。 Microsoft Teams ユーザーが ChatOps ボットと 1 対 1 でやり取りを行う場合、またはその逆の場合に必要です。これは設定などを行う際に必要となります。
User.Read		タイプ: 権限委譲ユーザーがアプリにサインインして、サインインしたユーザーのプロファイルやその他の基本的な企業情報を読めるようにします。 Jira Service Management と Microsoft Teams 間の接続を設定する際に、ユーザーの詳細を収集するために必要です。
User.Read.All		タイプ: アプリユーザーがサインインせずとも、アプリがユーザープロファイルを読み取ることを許可します。これは、メールアドレスを使用して Microsoft Teams ユーザーを取得するための自動化フローで必要となります。ユーザーが見つかると、作成したチャットに追加されます。自動化ルールの作成時に、Jira Service Management の「参加者」セクションのユーザーの中から、ルールの実行時に作成されるグループチャットに追加するユーザーを選択します。 Microsoft Teams のグループチャットに Jira Service Management/Atlassian ユーザーを追加するには、対応するユーザープロファイルが必要です。この権限によって、Microsoft Teams テナントのすべてのユーザープロファイルの読み取りが許可されます。自動化ルールを作成したユーザーがサインアウトすると、そのユーザーのトークンが利用できなくなり、自動化ルールが失敗します。このようなエッジケースが他にもいくつかあるため、自動化設定フローではこの権限が「委譲」権限ではなく「申請」権限となっています。
User.ReadBasic.All		タイプ: 権限委譲ご自身に代わって、アプリが組織内の他のユーザーの基本的なプロファイルプロパティを読み取ることを許可します。これには、表示名、名と姓、メールアドレス、画像が含まれます。アトラシアンのユーザー ID と Microsoft Teams のユーザー ID の間のユーザーマッピングを保持するために必要です。ユーザーに初めて管理者権限が与えられると、そのユーザーのトークンによって、Microsoft Teams からすべてのユーザーのメールアドレスが取得されます。次に、Microsoft Teams のユーザーのメールアドレスが、アトラシアンのメールアドレスとマッピングされます。Microsoft Teams で作成されたグループチャットやミーティングに対応者を追加するには、この権限が必要です。自動ユーザーマッピングがないと、ChatOps アプリを使用するために、各ユーザーが Microsoft Teams に一度サインインして、Atlassian アカウントをリンクする必要があります。
openid		タイプ: 権限委譲職場や学校のアカウントでアプリにサインインすることを許可します。また、アプリが基本的なプロファイル情報を読み取ることを許可します。 Jira Service Management と Microsoft Teams 間の接続を設定する際に、ユーザーの詳細を取得するために必要です。
プロファイル		タイプ: 権限委譲アプリに対して、ご自身の基本プロファイル (名前、画像、ユーザー名、メールアドレスなど) を確認することを許可します。 Jira Service Management と Microsoft Teams 間の接続を設定する際に、ユーザーの詳細を取得するために必要です。