> ## Documentation Index > Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Microsoft Teams 連携 > Living Security を Microsoft Teams に接続して、トレーニング通知、セキュリティアラート、チャンネルのお知らせを送信します。 Microsoft Teams 連携では、Living Security Teams アプリを通じて、Living Security の通知をユーザーおよびチャンネルに送信します。トレーニングの割り当て、人的リスクアラート、展開メッセージ、セキュリティチームからのお知らせにご利用ください。 この連携は通知専用です。ユーザーが Microsoft Teams 上でボットにコマンドを送信することはありません。アプリがインストールされると、ボットは今後のプロアクティブ通知に備えて Teams の会話参照を保存します。インストールメッセージは一方向であり、エンタープライズ展開の要件に合わせてカスタマイズまたは無効化できます。 Microsoft Teams 管理者が、Living Security Teams アプリのアップロード、承認、配布を引き続き行う必要があります。Microsoft Entra `User.Read.All` の管理者同意は任意であり、メールアドレスまたはユーザープリンシパル名（UPN）によるルックアップのフォールバックを有効にする場合にのみ必要です。 ナッジおよびプレイブックの配信設定は、**設定 → 通信 → チャンネル** から開始し、**Microsoft Teams** カードをクリックしてください。このページでは、基盤となる Teams アプリの構成について説明します。 ## 前提条件 Microsoft Teams を構成する前に、以下をご用意ください。 * 組織アプリをアップロードおよび承認できる Microsoft Teams 管理者。同一の担当者が両方の管理者ロールを兼ねることも可能です * テナント全体の `User.Read.All` アプリケーション同意によるメール/UPN ルックアップのフォールバックを有効にする場合のみ、Microsoft Entra 管理者 * Living Security の管理者権限 * 有効な Living Security 組織 * チャンネルのお知らせを有効にする場合は、セキュリティに関するお知らせの配信先となるチームおよびチャンネルの名前 * Microsoft Entra テナント ID（**Microsoft Entra admin center → アイデンティティ → 概要** で確認できます） ## 担当者ごとの役割 | ロール | 責任範囲 | | - | - | | **Living Security 管理者** | Microsoft テナントの接続、リージョン別パッケージのダウンロード、インストールメッセージの構成、セットアップの検証、テストの送信を行います | | **Microsoft Teams 管理者** | アプリのアップロードと許可、対象のユーザーまたはグループへの配布、アプリセットアップポリシーの割り当てを行います | | **Microsoft Entra 管理者**（任意） | メール/UPN ルックアップのフォールバックが必要な場合に、リージョン別 Bot アプリ ID に対して `User.Read.All` アプリケーション同意を付与します | | **Teams の所有者**（チャンネル配信を使用する場合） | 対象のチームおよびチャンネルにアプリをインストールまたは承認します | これらは別々の担当者でも構いません。パッケージのチェックサム、Teams アプリ ID、**Bot アプリ ID**、および展開対象のユーザー範囲を Microsoft Teams 管理者に共有してください。任意のメール/UPN ルックアップのフォールバックを有効にする場合にのみ、生成された同意 URL を Microsoft Entra 管理者に共有してください。関係のない Living Security の認証情報は共有しないでください。 ## セットアップ Living Security で **設定 → 通信 → チャンネル** に移動し、**Microsoft Teams** を選択します。 パネルには、組織のリージョン、パッケージのファイル名、Teams アプリ ID、ボットアプリ ID、SHA256 チェックサム、Microsoft テナントの構成ステータス、インストール手順、インストールメッセージの制御、検証ツール、テスト通知ツールが表示されます。 Living Security に表示されるリージョンが、組織がホストされているリージョンと一致しています。 **Connect your tenant** で、通知を受信するユーザーおよび Teams チャンネルを所有する Microsoft Entra テナント ID を入力し、**Save Microsoft tenant** をクリックします。1 つの Microsoft テナントは、1 つの Living Security 組織にのみ所属できます。 テナントのコントロールが利用できない場合は、アプリをインストールする前に、Living Security の導入担当者またはサポート窓口にご連絡のうえ、テナントの接続または変更を行ってください。 続行する前に、Living Security に **Microsoft tenant connected** と表示されます。 可能であれば、Teams アプリをインストールする前にテナントを接続してください。アプリがすでにインストールされている場合は、まずテナントを保存し、**Validate install** を選択してください。Living Security は既存のインストールを自動的に関連付けようとします。検証で検出できない場合にのみ、再インストールしてください。 **Download Teams package** をクリックします。Living Security が、組織のリージョン向けの ZIP パッケージを提供します。 変更を加える前に、ダウンロードしたファイルを Living Security に表示されている SHA256 チェックサムと照合して検証してください。アプリに独自の名前とアイコンを設定する場合は、この確認の後、パッケージをアップロードする前に、[リージョン別パッケージのリブランディング](#%E3%83%AA%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E5%88%A5%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E3%83%AA%E3%83%96%E3%83%A9%E3%83%B3%E3%83%87%E3%82%A3%E3%83%B3%E3%82%B0)の手順に従ってください。 ダウンロードしたファイルのチェックサムが、Living Security に表示されている SHA256 チェックサムと一致しています。 Microsoft Teams admin center で **Teams apps → Manage apps → Actions → Upload new app** に移動し、Living Security からダウンロードした ZIP ファイルをアップロードします。 以下を確認してください。 * Teams アプリ ID とボットアプリ ID が、Living Security に表示されている値と一致している * アプリ名が、リージョン別の Living Security の名前（パッケージをリブランディングした場合は、設定した名前）になっている * 発行元が **Living Security** になっている。パッケージをリブランディングしても、発行元は変わりません * アプリがブロックされていない * アプリが対象のユーザーまたはグループで利用可能になっている * 通知を受信するユーザーおよびチーム/チャンネルに対して、アプリセットアップポリシーまたはターゲットを指定したインストールでアプリがインストールされている Microsoft 側でアプリの提供状況やセットアップポリシーの変更が反映されるまで、時間がかかる場合があります。 アプリポリシーの変更直後に検証またはテストが失敗した場合は、Microsoft Teams admin center でポリシーの割り当てを確認し、Microsoft 側での反映が完了してから再試行してください。 個人用アプリを対象のユーザーに配布します。Living Security が検出されたインストールに対して個人向けテストを送信できるようにするには、少なくとも 1 人のユーザーが Microsoft Teams で Living Security の個人用アプリをインストールするか開く必要があります。これにより、ボットはユーザーの信頼できるアイデンティティと個人の会話参照を取得できます。チャンネルへのインストールだけでは、検出されたインストールに対する個人向けテストは実行できません。 チャンネル配信を行う場合は、ボットがそのチャンネルの会話参照を取得できるように、対象のチームおよびチャンネルにアプリをインストールします。 対象ユーザーが個人用アプリをインストールしたか開いた、またはアプリが対象のチャンネルにインストールされています。 **Install message controls** セクションで、Teams のインストールメッセージを送信するかどうかを選択し、組織向けに一方向の文面をカスタマイズします。 利用可能なコントロール: * Send install messages * Send personal install messages * Send channel install messages * Default message * Personal message * Channel message メッセージフィールドでは `{{installerName}}` を使用できます。これはアプリをインストールしたユーザーの表示名に置き換えられます。個人向けまたはチャンネル向けのメッセージを空欄にすると、構成済みのデフォルトメッセージが使用されます。デフォルトメッセージも空欄の場合、Living Security はそのスコープ向けの組み込みメッセージを使用します。 Living Security で **Validate install** をクリックします。検証では、リージョン別パッケージが利用可能であること、Microsoft テナントの構成が存在しこの Living Security 組織に固有であること、リージョン別ボットの認証情報が構成されていること、および接続されたテナントでアクティブなアプリのインストールが検出されていることが確認されます。 本番の通知を送信する前に、検証結果として **Validation passed** が表示されます。 デフォルトの個人向けテストでは、**Send test to detected installation** をクリックします。Living Security は、検出されたアクティブな個人用インストールを選択し、保存されている信頼できるアイデンティティと会話参照を使用します。このテストでは Microsoft Graph を呼び出さず、`User.Read.All` 同意も不要です。 個人用インストールが検出されない場合は、ユーザーに Living Security の個人用アプリをインストールするか開くよう依頼し、再度 **Validate install** を選択してから、テストを再送信してください。メール/UPN を指定する高度なテストは、任意のルックアップのフォールバックが有効な場合にのみ使用してください。 一方向のテスト通知が Microsoft Teams に表示されます。 配信の診断が必要な場合は、[Communication Log](/ja/features/communications/log) で該当する試行を確認してください。 ## リージョン別パッケージのリブランディング リージョン別パッケージは、`manifest.json`、`color.png`、`outline.png` の 3 つのファイルからなる ZIP アーカイブです。アップロードする前に、このパッケージ内で独自のアプリ名とアイコンを設定できます。Living Security は、Teams 管理者が直接アップロードするリージョン別パッケージについて、この方法をサポートしています。 この作業は、パッケージをダウンロードして検証した後、Teams admin center にアップロードする前に行ってください。 ZIP ファイルを展開します。アーカイブのルートには、`manifest.json`、`color.png`、`outline.png` の 3 つのファイルのみが含まれています。 `color.png` と `outline.png` を独自のアイコンに置き換えます。2 つのファイル名はそのまま維持してください。 | ファイル | 要件 | | - | - | | `color.png` | フルカラーの PNG、192 × 192 ピクセル、透過なし | | `outline.png` | 透過 PNG、32 × 32 ピクセル | `manifest.json` で、次の 2 つのフィールドを編集します。 * `name.short` — Teams のアプリヘッダーなど、スペースが限られた領域に表示される名前。最大 30 文字。 * `name.full` — アプリカタログおよびアプリの詳細に表示される名前。最大 100 文字。 Living Security のアプリがすでに Teams admin center にアップロードされている場合は、`version` を、そこにインストールされているバージョンより高く設定してください。Microsoft Teams は、バージョンが上がらない更新を拒否します。また、新しくダウンロードしたパッケージは、すでにインストールしているパッケージと同じバージョン、またはそれより低いバージョンである場合があります。 インストール済みのバージョンは、Teams admin center の **Teams apps → Manage apps** にあるアプリの詳細ページで確認できます。これを、ダウンロードしたばかりの `manifest.json` 内の `version` の値と比較し、両方より高い値を設定してください。3 つの数字からなる `MAJOR.MINOR.PATCH` の形式は維持してください。 たとえば、インストール済みのアプリが `1.1.1` で、新しくダウンロードしたものが `1.1.0` の場合は、`1.1.2` に設定します。ダウンロードした `1.1.0` を `1.1.1` に上げただけでは、インストール済みのバージョンと同じになり、Teams はアップロードを拒否します。 次のフィールドは変更しないでください。それぞれがアプリ、ボット、またはシングルサインオンのアイデンティティを保持しています。 * `id` * `bots` 内の `botId` * `webApplicationInfo` * `validDomains` * `staticTabs` 内の `contentUrl` と `websiteUrl` アイデンティティフィールドを変更すると、アプリをインストールできても、通知を配信できない、またはシングルサインオンを完了できない状態になる可能性があります。**Validate install** では、テナント、ボットの認証情報、および検出されたインストールが確認されます。マニフェストと Living Security が作成したパッケージとの比較は行われません。 3 つのファイルから新しい ZIP アーカイブを作成します。ファイルは、フォルダーで囲まずにアーカイブのルートに配置してください。Microsoft Teams は、`manifest.json` がフォルダー内にあるパッケージを拒否します。 リブランディングした ZIP ファイルを Teams admin center にアップロードし、Living Security に戻って **Validate install** をクリックします。その後、テスト通知を送信します。 検証結果として **Validation passed** が表示され、テスト通知が設定したアプリ名とアイコンで Microsoft Teams に届きます。 ### 発行元とチェックサム リブランディングで設定されるのはアプリ名とアイコンです。次の 2 点は変わりません。 * **発行元は Living Security のままです。** マニフェストの `developer` フィールドには、Living Security の名称と、Living Security の Web サイト、プライバシーポリシー、利用規約へのリンクが指定されています。これらは合わせて、サービスを運営する企業を示すため、Teams はアプリの詳細ページ、権限同意ダイアログ、アプリ使用状況レポートで、引き続き発行元として **Living Security** を表示します。ユーザーには、アプリヘッダー、アプリカタログ、通知に、設定した名前とアイコンが表示されます。 * **SHA256 チェックサムは一致しなくなります。** Living Security に表示されるチェックサムは、ダウンロードしたままのパッケージを示すものです。ファイルを編集する前に検証を行い、その後、リブランディングした独自のパッケージのチェックサムを展開記録用に控えておいてください。 ## 任意: メール/UPN ルックアップのフォールバックを有効にする 通常の個人向け配信では、Living Security がすでに把握している信頼できる Microsoft Entra オブジェクト ID と、ユーザーがアプリをインストールしたとき、または開いたときに取得されたボットの会話参照を使用します。チャンネル配信では、保存されているチャンネルの会話参照を使用します。どちらの経路でも Microsoft Graph は不要です。 受信者に信頼できる Entra オブジェクト ID がない場合、Living Security は任意で Microsoft Graph を使用し、メールアドレスまたは UPN によって受信者を解決できます。このフォールバックを有効にするには、Microsoft Entra 管理者に、Teams セットアップパネルで **Grant optional User.Read.All consent** をクリックし、リージョン別の Living Security Teams アプリケーションに対して Microsoft Graph の `User.Read.All` アプリケーション権限を承認するよう依頼してください。 管理者同意のフローは、次の Microsoft Entra のパターンに従います。 ```text theme={null} https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id} ``` Living Security は、接続されたテナント ID と、セットアップパネルに表示される **Bot アプリ ID** からこの URL を生成します。各 ID の用途は異なります。 * **Teams アプリ ID** は、Microsoft Teams admin center でインストール可能なアプリパッケージを識別します。 * **Bot アプリ ID** は、リージョン別ボットの Microsoft Entra アプリケーションを識別し、任意の管理者同意フローで使用されるクライアント ID です。 同意 URL で Teams アプリ ID を代用しないでください。Connected Integrations の **Microsoft Entra ID (Client Credentials)** 連携は、別個の汎用的な連携です。その認証情報や同意をリージョン別 Teams ボットで再利用することはできず、無関係な Entra アプリケーションに付与された同意では、このフォールバックは有効になりません。 同意を任意としても、既存のリージョン別 Living Security アプリケーション登録から `User.Read.All` が削除されるわけではありません。すでに同意を付与しているお客様は、再構成することなく、メール/UPN のフォールバックを引き続き使用できます。 ## 通知の種類 組織の権限および構成されたプレイブックに応じて、Living Security は以下を送信できます。 | 通知 | 説明 | | - | - | | トレーニングの割り当て | トレーニングが割り当てられたとき、期限が近づいたとき、または受講可能になったときにユーザーに通知します | | トレーニングのリマインダー | 今後の期限についてユーザーにリマインドします | | 人的リスクアラート | パーソナライズされた人的リスク指数の更新と推奨される次のステップを送信します | | 展開メッセージ | 導入時に、一方向のオンボーディング通知または展開通知を送信します | | チャンネルのお知らせ | 構成された Teams チャンネルに、セキュリティプログラムに関するお知らせを投稿します | ## カスタマイズ Teams の通知には、Living Security 組織の構成が使用されます。サポートされるフィールドには、お客様の表示名、サポート対象のロゴおよびブランドフィールド、メッセージ文面、コールトゥアクション、リンク先、展開に関するテキスト、サポート/問い合わせ先のテキストが含まれます。 インストールメッセージは、**設定 → 通信 → チャンネル → Microsoft Teams → Install message controls** から構成できます。インストールメッセージ全体を無効にすることも、個人向けまたはチャンネル向けのインストールメッセージのみを無効にすることもできます。また、デフォルト、個人向け、またはチャンネル固有の文面を設定できます。 Teams アプリの名前とアイコンは、リージョン別パッケージに由来します。独自の名前とアイコンを設定するには、[リージョン別パッケージのリブランディング](#%E3%83%AA%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E5%88%A5%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E3%83%AA%E3%83%96%E3%83%A9%E3%83%B3%E3%83%87%E3%82%A3%E3%83%B3%E3%82%B0)をご覧ください。 ## アプリの更新または削除 * Living Security が更新版のリージョン別パッケージを提供した場合は、Microsoft Teams チャンネルパネルからダウンロードし、Teams admin center 経由でそのパッケージをアップロードしてください。展開前に、表示されているアプリ ID、ボット ID、チェックサムを確認してください。 * ブランディングの編集内容は、パッケージの更新後は引き継がれません。新しいリージョン別パッケージでは、毎回 Living Security のアプリ名とアイコンに戻ります。新しいパッケージをアップロードする前に、[リージョン別パッケージのリブランディング](#%E3%83%AA%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E5%88%A5%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E3%83%AA%E3%83%96%E3%83%A9%E3%83%B3%E3%83%87%E3%82%A3%E3%83%B3%E3%82%B0)で編集内容を再適用してください。アップグレードのたびに同じ手順を短時間で繰り返せるよう、アイコン、2 つの名前の値、および最後にアップロードしたバージョンを、すぐに参照できる場所に保管してください。新しいパッケージのバージョンが、インストール済みのバージョンより必ずしも高いとは限りません。そのため、Teams にインストール済みとして表示されているバージョンを基準にバージョンを設定してください。 * アプリまたはポリシーの更新後は、**Validate install** を再実行し、あらためてテスト通知を送信してください。 * アプリを削除またはブロックすると、そのユーザーまたはチャンネルへのプロアクティブ通知が行われなくなります。アプリを再インストールし、新しいテストを送信して、Living Security が最新の Teams インストールイベントを受信できるようにしてください。 * Teams への配信を終了する場合は、Microsoft Teams からアプリを削除する前に、関連するプレイブックから Teams を削除してください。 ## トラブルシューティング * Living Security Teams の個人用アプリがインストールされており、Living Security が最新の会話参照を保持できるよう、ユーザーがアプリを開いていることを確認します * 構成されている Microsoft テナント ID が、ユーザーが所属するテナントであることを確認します * 診断でメール/UPN のフォールバックが試行されたことが示されている場合は、表示されている Bot アプリ ID に対して、正しいテナントで `User.Read.All` の管理者同意が付与されていることを確認します * メール/UPN のフォールバックを使用している場合は、Living Security に登録されているユーザーのメールアドレスまたは UPN が、Microsoft Entra ID と一致していることを確認します * ユーザーが以前にアプリを削除またはブロックしている場合は、ブロックを解除するか、アプリを再インストールするよう依頼します エラーカテゴリ `TEAMS_ADMIN_CONSENT_REQUIRED`、または Microsoft エラー `AADSTS7000229` は、メール/UPN による受信者ルックアップで任意の Microsoft Graph フォールバックが試行されたものの、リージョン別の Living Security Teams アプリが、接続された Microsoft Entra テナントにサービスプリンシパル（エンタープライズアプリケーション）を持っていないことを意味します。信頼できる ID と保存済みの会話を使用するデフォルトの経路では、この同意は不要です。これは Living Security のシークレットの有効期限切れではありません。 1. **設定 → 通信 → チャンネル → Microsoft Teams** を開きます。Communication Log のエラーから **Open Microsoft Teams setup** を使用することもできます。 2. 正しい Microsoft Entra テナント ID が接続されていることを確認します。 3. メール/UPN のフォールバックが必要な場合は、Microsoft Entra 管理者に、**Grant optional User.Read.All consent** をクリックし、表示されている **Bot アプリ ID** に対して `User.Read.All` を承認するよう依頼します。不要な場合は、受信者が個人用アプリを開いており、Living Security がその信頼できる Entra オブジェクト ID を保持していることを確認してください。 4. Microsoft 側で同意の処理が完了したら、Microsoft Teams のセットアップから、メール/UPN を指定する高度なテストを送信します。Communication Log には配信履歴と診断情報が表示されますが、失敗したメッセージは再配信されません。 **Microsoft Entra ID (Client Credentials)** を再構成しても、この連携は Teams 通知の配信には使用されないため、このエラーは解決しません。 * ボットがブロック、削除、またはアンインストールされていないか確認します * Living Security でテナントを接続する前にアプリがインストールされていた場合は、テナントを保存して **Validate install** を選択し、Living Security が既存のインストールを関連付けられるようにします * 検証で既存のインストールを検出できない場合にのみ、再インストールします * 対象のユーザーまたはチャンネルが、最新のアプリインストールイベントを受信していることを確認します * アプリを再インストールした後、新しいテスト通知を送信します トラブルシューティングに使用するインストールイベントのフィールドの例: ```json theme={null} { "type": "installationUpdate", "action": "add", "channelData": { "tenant": { "id": "278750d2-8df7-4262-a34d-08d79ad671d8" }, "team": { "id": "19:team-id@thread.tacv2" }, "channel": { "id": "19:channel-id@thread.tacv2" } }, "conversation": { "id": "19:channel-id@thread.tacv2", "conversationType": "channel", "tenantId": "278750d2-8df7-4262-a34d-08d79ad671d8" } } ``` ## セキュリティ Living Security は、任意のメール/UPN による受信者ルックアップのフォールバックにのみ、Microsoft Graph の `User.Read.All` を使用します。デフォルトでは、個人向け通知のルーティングには、Living Security のエンティティデータに含まれる信頼できる Entra オブジェクト ID と、Microsoft Teams から取得したボットの会話参照が使用されます。呼び出し元が指定したオブジェクト ID や会話参照は、信頼できるルーティングデータとはみなされません。Microsoft Teams のメッセージは、Microsoft Teams のプロアクティブメッセージ機能を使用して、Living Security の通知専用 Teams ボットを通じて配信されます。 標準的な Teams アプリのセットアップでは、お客様が独自の Microsoft Entra アプリ登録を作成したり、お客様所有のクライアントシークレットを共有したりする必要はありません。 リージョン別の Teams パッケージでは、アプリ ID、ボット ID、およびメッセージングエンドポイントが、組織がホストされている Living Security のリージョンと一致するように維持されます。 ## 関連情報 メールを配信チャンネルとして構成します。 Slack を配信チャンネルとして構成します。 Teams の配信ステータスと履歴を追跡します。 Microsoft Entra ID と SSO の構成。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.