Microsoft Teams の認証

このドキュメントでは、OAuth 2.0 を使用して UiPath Integration Service で Microsoft Teams を認証する方法について説明します。Microsoft Teams コネクタは 、ユーザーベースの OAuth 認証をサポートし、オプションで カスタム OAuth アプリケーション と ボットが有効なシナリオをサポートします。

概要

次の表は、サポートされている認証オプションとその前提条件をまとめたものです。

認証シナリオ	説明	前提条件
UiPath で管理される OAuth (認可コード)	UiPath で管理されるアプリケーションを使用します	Microsoft Teams アカウント、同意を付与する機能
独自の OAuth アプリ (BYOA) を使用する	顧客管理の Azure AD アプリケーションを使用します	Azure AD アプリ、クライアント ID、クライアント シークレット、テナント ID、管理者の同意

OAuth 2.0 認証

ボットを含める

[ボットを含める] オプションは、ユーザーが委任した OAuth アクセス許可に加えて、コネクションに Microsoft Teams ボットベースのアクセスを含めるかどうかを決定します。このオプションを選択すると、コネクション Uipath notification としてメッセージを送信できます。

設定	動作
No (既定値)	ユーザー委任 OAuth のみ
はい	Microsoft Teams ボット機能を有効にします

注:

• ボット認証には、Azure に登録されている Microsoft Teams ボットが必要です。
• ボットのサポートは、ほとんどの Microsoft Teams アクティビティでは必要ありません。
• このオプションは、オートメーションがボット機能を明示的に必要とする場合にのみ使用してください。

独自の OAuth アプリ (BYOA) の構成

[独自の OAuth アプリを使用する] を選択した場合は、Azure AD アプリケーションを次のように設定します。

Azure アプリケーションの設定

設定	値 (Value)
OAuth フロー	認可コード
リダイレクト/コールバック URL	https://{baseURL}/provisioning_/callback(例: Automation Cloud の場合はhttps://cloud.uipath.com/provisioning_/callback )。
サポートされているアカウントの種類	シングルテナントまたはマルチテナント
API	Microsoft Graph

テナント ID

アプリの種類	テナント ID
マルチテナント	common
シングルテナント	Azure テナント ID

注:

UiPath は、単一テナント アプリケーションとマルチテナント アプリケーションの両方をサポートしています。

範囲と権限

スコープは、UiPath が Microsoft Teams で実行できるアクションを制御します。スコープは、コネクションの作成時に設定できます。

必須のスコープ

次のスコープは 必須 であり、 削除しないでください。これらは接続を正常に完了するために必要なものです。

スコープ	目的
openid	ユーザー認証および ID トークンの生成
offline_access	更新トークンの発行を可能にします
User.Read	サインインしているユーザー プロファイルを読み取ります。

注:

必須のスコープを削除すると、接続またはランタイムの認証が失敗します。

すべてのスコープ

次のスコープは、一般的な Microsoft Teams の自動化シナリオを有効にします。

スコープ	ユースケース	アクティビティまたはイベント
openid	このアクセス許可を使うと、アプリはユーザーの一意の識別子をサブ要求の形式で受け取ることができます。 このアクセス許可により、アプリに UserInfo エンドポイントへのアクセス権も付与されます。 openid スコープは、Microsoft ID プラットフォーム トークン エンドポイントで ID トークンを取得するために使用できます。アプリはこれらのトークンを認証に使用できます。	N/A
offline_access	認証要求エンドポイントで更新トークンを受け取るために必要です。OAuth 2.0 認可コード フローで offline\_access スコープなしで認可コードを引き換えると /token エンドポイントから更新トークンを受け取れません。	N/A
profile	現在のユーザー プロファイル (名前、ユーザー名、メール アドレスなど) を取得して、コネクションの作成時に既定/認証済みユーザーとして使用できるようにする	N/A
email	メッセージを送信したりチャネルに招待したりするために、すべてのユーザーのメインのメール アドレスを読み取ることをアプリに許可します。	個々のチャット メッセージを送信、チャネルにメンバーを招待、チームにユーザーを招待
User.Read	ユーザーがアプリにサインインできるようにし、サインインしているユーザーのプロフィールをアプリが読み取ることを許可します。 また、サインインしているユーザーの基本的な会社情報を読み取ることもアプリに許可します。	[レコードを取得] → Me
Team.Create	各ユーザーを招待して協働を可能にするチームを作成します。	[レコードを挿入] → Teams
Team.ReadBasic.All	アクティビティ (チャンネル メッセージの送信など) で選択するチームのリストを取得します。	チャネルを作成、すべてのチャネルのリストを取得、チャット メッセージを送信、個々のチャット メッセージを送信、チャネルにメンバーを招待、チャネル メッセージに返信、チャネル メッセージを送信、名前でチームを取得
TeamMember.ReadWrite.All	サインインしているユーザーに代わってチームにメンバーを追加します。 チーム内のメンバーのリストを取得します。	[すべてのチーム メンバーのリストを取得]、[ユーザーをチームに招待]、[名前でチームを取得]、[チーム メンバー→レコードを挿入]、[チーム メンバー→すべてのレコードのリストを取得]
Channel.Create	チームの各ユーザーを招待して協働を可能にするためのチャネル (標準/プライベート) を作成します。	チャンネルを作成
Channel.ReadBasic.All	チャネル メッセージの送信などのアクティビティで選択するチームのチャネルのリストを取得します。	名前でチャネルを取得、チャネルにメンバーを招待、すべてのチャネルのリストを取得、名前でチャネルのリストを取得、チャネル メッセージに返信、チャネル メッセージを送信
ChannelMember.ReadWrite.All	サインインしているユーザーに代わってチャネルにメンバーを追加します。 チャネル内のメンバーのリストを取得します。	チャネルにメンバーを招待、すべてのレコードのリスト→ Teams チャネル メンバー
ChannelMessage.Send	チャネルでメッセージを送信します。 また、必要に応じて、スレッド内のメッセージに返信します。	チャネル メッセージに返信、チャネル メッセージを送信
ChannelMessage.Read.All	サインインしているユーザーなしで、アプリが Microsoft Teams 内のすべてのチャネル メッセージを読み取ることを許可します。 チャネルにメッセージが投稿されるたびに、またはチャネル内でキーワードが投稿されるたびにイベントをトリガーするためにも使用されます。	チャネル メッセージに返信、すべてのチャネル メッセージのリストを取得、すべてのレコードのリストを取得 → Teams チャネル メッセージ、チャネルにメッセージが投稿された場合 (未来)、チャネルでキーワードまたはユーザー名が投稿された場合 (未来)
Chat.ReadWrite	アプリが 1 対 1 のチャットを読み取りかつ送信することを許可します。アプリがグループ チャット メッセージを読み取りかつ送信することを許可します。また、チャット メッセージが投稿されるたびにイベントをトリガーするためにも使用されます。	グループ チャット メッセージを送信、個々のチャット メッセージを送信、すべてのチャット メッセージのリストを取得、すべてのレコードのリスト→チャット、チャット メッセージの投稿時 (未来)
ChatMember.ReadWrite	サインインしているユーザーに代わってチャットにメンバーを追加します。 チャット内のメンバーのリストを取得します。	チャット メンバー→レコードを挿入、すべてのレコードのリストを取得、→チャット メンバー
Calendars.ReadWrite	オンライン Teams 会議の Outlook 予定表エントリを作成します。	オンライン Teams 会議を作成
OnlineMeetings.ReadWrite	Microsoft Teams でオンライン会議を作成し、現在のユーザーに代わって会議 ID、パスコード、URL を取得します。	オンライン Teams 会議を作成
Files.Read.All	Teams チャネルまたはチャットで共有するために SharePoint にアップロードされたファイル情報を取得します。	チャネル メッセージを送信 グループ チャット メッセージを送信、個々のチャット メッセージを送信、チャネル メッセージに返信

スコープを追加または削除して 、最小特権 の原則に従うことができます。

OAuth アプリケーションの更新トークン

OAuth アプリケーションの更新トークンは、Microsoft によっていつでも無効にされたり、取り消されたりされます。これは、タイムアウトや失効など、さまざまな理由で発生する可能性があります。 詳細については、Microsoft の公式ドキュメントをご覧ください。

注:

トークンを無効にするとコネクションが失敗し、コネクションを修正しないとオートメーションを実行できません。

この問題は、すべての Microsoft Graph ベースのコネクタに影響します。

OAuth アプリケーションを作成する際は、Microsoft のベスト プラクティスに従ってください。OAuth 2.0 アプリケーションの作成方法の詳細については、Microsoft の ドキュメントをご覧ください。

Microsoft Teams コネクションを追加する

お使いの Microsoft Teams インスタンスへのコネクションを作成するには、次の手順を実行する必要があります。

1. 製品ランチャーから [Orchestrator] を選択します。

2. フォルダーを選択して [ コネクション ] タブに移動します。

3. [ コネクションを追加] を選択します。

4. コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。

5. [OAuth 2.0 認可コード] または [独自の OAuth 2.0 アプリ (BYOA) を使用する] の 2 つの認証の種類から選択できます。

6. 必要な資格情報を入力します。

   For any secret-type field, you can select the menu next to the field and choose Use credential asset to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see Use credential assets for connections.

7. [接続] を選択します。

Microsoft Teams での認証の詳細については、Microsoft の認証と承認 のページをご覧ください。