Microsoft Teams の認証

前提条件

認証するには、次の資格情報が必要です。

• 独自の OAuth 2.0 アプリを使用する: スコープ、クライアント ID、クライアント シークレット、テナント ID

プライベート OAuth2 アプリを作成するには、Microsoft Teams のドキュメント「 Configure third party OAuth authentication - Teams」に記載されている手順に従います。また、サードパーティのアプリに情報にアクセスする権限を付与する必要があります。

注:

認証方法として [Bring your own OAuth 2.0 app] を使用することで、マルチテナント アプリケーションと単一テナント アプリケーションの両方がサポートされています。マルチテナント アプリケーションを使用する場合は、[ テナント ID ] の既定値 (common) のままにします。シングルテナント アプリケーションを使用している場合は、Azure からテナント ID を取得します。「 Microsoft Entra テナント ID の確認方法」をご覧ください。

[スコープ] フィールドは、通常のユーザー操作の既定のスコープを表します。

OnlineMeetingTranscript.Read.AllOnlineMeetingRecording.Read.AllTeam.ReadBasic.AllTeamMember.ReadWrite.AllChannel.CreateChannel.ReadBasic.AllChannelMember.ReadWrite.AllChannelMessage.SendChannelMessage.Read.AllChat.ReadWriteChatMember.ReadWriteCalendars.ReadWriteOnlineMeetings.ReadWriteFiles.Read.AllUser.Readprofileopenidemailoffline_access

スコープを追加または削除して、コネクションのユーザー権限をカスタマイズできます。詳しくは、「スコープ」セクションと、Microsoft ドキュメントの「 Microsoft Graph のアクセス許可のリファレンス」をご覧ください。

アクセス許可を付与する

Microsoft Teams 用の UiPath アプリケーション、または独自のプライベート OAuth 2.0 アプリを使用するには、アプリケーションのアクセス許可に同意する必要があります。「 アプリの権限に対して組織全体の管理者の同意を付与する」に記載された手順に従います。

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

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

1. Automation Suite で [Integration Service] を選択します。
2. [コネクタ] のリストから [Microsoft Teams] を選択します。 検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ Microsoft Teams に接続] を選択します。
4. これで、コネクションのページにリダイレクトされます。
5. 必要な資格情報を入力します。
6. [接続] を選択します。
7. コネクションが追加されました。

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

範囲と権限

このコネクションを使用して、UiPath Studio で 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 内のすべてのチャネル メッセージを読み取ることを許可します。 チャネルにメッセージが投稿されるたびに、またはチャネル内でキーワードが投稿されるたびにイベントをトリガーするためにも使用されます。	チャネル メッセージに返信 すべてのチャネル メッセージのリストを取得 すべてのレコードのリストを取得 → チームのチャネル メッセージ チャネルにメッセージが投稿された場合 (未来) チャネルでキーワードまたはユーザー名が投稿された場合 (未来)
Chat.ReadWrite	アプリが 1 対 1 のチャットを読み取りかつ送信することを許可します。アプリがグループ チャット メッセージを読み取りかつ送信することを許可します。また、チャット メッセージが投稿されるたびにイベントをトリガーするためにも使用されます。	グループ チャット メッセージを送信 個々のチャット メッセージを送信 すべてのチャット メッセージのリストを取得 すべてのレコードのリストを取得 チャット → チャット メッセージが投稿された場合 (未来)
ChatMember.ReadWrite	サインインしているユーザーに代わってチャットにメンバーを追加します。 チャット内のメンバーのリストを取得します。	チャット メンバー→レコードを挿入 すべてのレコードのリストを取得 → チャット メンバー
Calendars.ReadWrite	オンライン Teams 会議の Outlook 予定表エントリを作成します。	オンライン Teams 会議を作成
OnlineMeetings.ReadWrite	Microsot Teams でオンライン会議を作成し、現在のユーザーに代わって会議 ID、パスコード、および URL を取得します。	オンライン Teams 会議を作成
Files.Read.All	Teams チャネルまたはチャットで共有するために SharePoint にアップロードされたファイル情報を取得します。	チャネル メッセージを送信 グループ チャット メッセージを送信 個々のチャット メッセージを送信 チャネル メッセージに返信