多くの組織で利用されているMicrosoft TeamsのMessage Extensionは、チャットからスムーズにデータ検索やタスク連携を実現できる便利な機能です。しかし、開発や運用の段階で「The tenant admin disabled this bot」というエラーが突然表示されると、トラブルシューティングに苦戦するケースもあります。ここでは、その原因や対処法、再発防止策を詳しく紹介します。
Microsoft TeamsのMessage Extensionとは
Message Extensionは、Teams内のメッセージ入力欄などから呼び出して利用できる拡張機能です。特定のデータを検索したり、外部のアプリケーションと連携したりといった操作を、自然なチャット体験の中で実行できるのが特徴です。一般的なチャットボットとの違いとして、会話に直接介入することなくユーザーが必要なタイミングで呼び出し、検索と結果の投稿が行えるメリットがあります。
主な利用シーン
- 社内ドキュメントの検索と共有
- チケット管理システムへの問い合わせ情報の追加
- プロジェクト管理ツールへのタスク登録
- 外部Webサービスとの連携による情報取得や通知
上記のようにMessage Extensionを活用することで、Teamsのチャット内に仕事で必要な情報を簡単に呼び出して共有することができます。
「The tenant admin disabled this bot」エラーの概要
開発環境で正常に動作していたMessage Extensionをテナントにデプロイしたとき、「The tenant admin disabled this bot」と表示される場合があります。これは以下のような状況で発生することがあります。
- Microsoft 365管理センターのポリシー設定で、対象のボットやアプリの利用が制限されている
- Message Extension自体が何らかのサービス障害の影響を受けている
- アプリIDやシークレットキーなどの登録に不備がある
このエラーは見た目に「管理者が利用を禁止している」というメッセージですが、実際には管理ポリシー設定やTeamsサービスの不具合など複合的に起きることが多いため、単純に「管理者が本当に無効化しているか」を確認するだけでなく、他の可能性もチェックする必要があります。
エラーコードの一例
エラー発生時に返却されるJSONなどで、下記のエラーコードが記録されることがあります。
| エラーコード | 内容 |
|---|---|
| 0 | 特定のメッセージは表示されず、Teams側で「tenant admin disabled this bot」と出る |
| 209/1 | チャットボットやMessage Extensionが停止または無効化されているとみなされる |
上記のようなコードを確認した場合は、Teams管理センターのエラー状況だけでなく、同時にサービス全体のステータスも点検するとよいでしょう。
サービスヘルスアドバイザリ（TM710191）とは
過去にMicrosoft Teams側で発生した既知のサービス障害として「TM710191」という事例が報告されています。この障害の影響で、特定のテナント、特に教育機関や一部エンタープライズ環境下のTeamsで、チャットボットやMessage Extensionがエラーを返す問題がありました。
発生状況と原因
- 発生状況: 一部のユーザーがTeams内でボットやMessage Extensionを利用しようとした際に呼び出しに失敗したり、エラーが出たりして正常に動作しない事象が頻発
- 原因: コードのアップデートに起因したバグにより、ボットの認証リクエストやアプリの呼び出しが正しく処理されなくなった
MicrosoftはサービスヘルスアドバイザリとしてTM710191を掲示し、管理センターの「サービス正常性ダッシュボード（Service Health）」でも通知を行っていました。
Microsoftの対処
- エラー再現の調査: 特定の環境下で問題が起きることを確認
- コード更新のロールバック: 問題が発生した原因のコード修正を取り下げ、安定版に戻す対応を実施
- 順次解消: Microsoft 365全体のデプロイが完了するにつれ、問題が自然解消
そのため、もし自分のMessage Extensionに同様の不具合が見られたときは、管理センターのサービス健康状態をチェックしたうえで、Microsoftがエラーを把握しているかどうかも確認することが大切です。
設定や構成を再点検する手順
サービス障害が解消してもエラーが改善しない場合は、Teams管理者のポリシーや開発時の設定を見直すことが有効です。以下に代表的な点検項目を示します。
Teams管理者ポリシーの確認
組織内のTeamsのアプリ・ボット許可ポリシーにより、開発テナントや特定のユーザーへの使用が制限されている可能性があります。
- Microsoft 365管理センター → Teams管理 → Teamsのアプリ許可ポリシー
- 管理者が追加したカスタムポリシーの有無
アプリ許可ポリシーの見直し
企業のセキュリティポリシーによっては、外部から取得したアプリやボットを自動的にブロックする設定が導入されている場合があります。開発フェーズでは想定外のブロック対象となっていないかを点検することが重要です。
ボットチャネル登録情報のチェック
Azure Botチャネル登録やアプリID、シークレットキーの期限切れや間違いがないかを再度確認します。特に以下の点を重点的にチェックするとよいでしょう。
| 項目 | チェック内容 |
|---|---|
| アプリID | 正しいアプリケーションIDがTeamsアプリに設定されているか |
| シークレット | 有効期限が切れていないか、また正しく登録されているか |
| OAuth設定 | OAuth認証のリダイレクトURLなどが想定通りか |
| Messaging Endpoint | HTTPS接続で正しいエンドポイントが公開されているか |
再発防止策と活用のポイント
Message Extensionを円滑に運用するためには、エラーの根本原因を把握し、今後もメンテナンスを続けることが重要です。
- 定期的なサービス状態のチェック
Microsoft 365管理センターのサービス健康状態をこまめに確認し、Teams関連のアドバイザリや障害報告に早めに気付くようにします。特に教育機関向けテナントや特殊なエンタープライズテナントの場合は、注意が必要です。 - 本番テナントと開発テナントの環境差異を最小化
ローカルで動くからといって、本番テナントでも同様に動くとは限りません。本番環境の準備として、極力似通った設定をテスト用テナントで確認するプロセスを取りましょう。 - 定期的なアプリID・シークレットの更新
セキュリティ要件が厳しい環境では、アプリIDやシークレットの定期更新スケジュールを設けているケースがあります。設定失効が原因で動作しなくなるリスクを避けるためにも、スケジュール管理は欠かせません。 - ドキュメント整備とコミュニティ活用
Message ExtensionやTeams Botに関する情報はMicrosoft公式ドキュメントだけでなく、コミュニティフォーラムでも豊富に共有されています。日本語のコミュニティも存在するため、最新情報の収集やエラー事例の共有など、積極的に参加すると良いでしょう。
まとめ
Microsoft TeamsのMessage Extensionで「The tenant admin disabled this bot」というエラーが発生した場合、必ずしもテナント管理者がボットを明示的に無効化しているとは限りません。サービスヘルスアドバイザリ（TM710191）のように、Teams側の障害が影響していることもあります。また、アプリ許可ポリシーやAzure Bot登録、シークレットなどの設定に起因するケースも多々あるため、エラーの原因を総合的に洗い出すのが解決への近道です。もし類似の問題が継続的に再発するようであれば、管理センターで最新の障害情報をチェックしながら、アプリ構成や認証設定の見直しを行っていきましょう。
コメント