Microsoft Teams の認証

前提条件

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

• スコープ、クライアント ID、クライアント シークレット (Bring your own OAuth 2.0 アプリの場合)

スコープ フィールドは、通常のユーザー操作の既定のスコープを表します ( OnlineMeetingTranscript.Read.All、 OnlineMeetingRecording.Read.All、 Team.ReadBasic.All、 TeamMember.ReadWrite.All、 Channel.Create、 Channel.ReadBasic.All、 ChannelMember.ReadWrite.All、 ChannelMessage.Send、 ChannelMessage.Read.All、 Chat.ReadWrite、 ChatMember.ReadWrite、 Calendars.ReadWrite、 OnlineMeetings.ReadWrite、 Files.Read.All、 User.Read、 profile、 openid、 email、 offline_access。

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

プライベート OAuth2 アプリを作成するには、Microsoft Teams のドキュメント「 サード パーティの OAuth 認証を構成する - Teams」で説明されている手順に従います。

さらに、サードパーティのアプリに情報にアクセスする権限を付与する必要があります。

アクセス許可を付与する

UiPath Application for Microsoft Teams または独自のプライベート 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	アクティビティ (チャンネル メッセージの送信など) で選択するチームのリストを取得します。	チャンネルを作成 すべてのチャンネルをリスト表示 Send Chat Message 個々のチャット メッセージを送信 チャネルにメンバーを招待 Reply to a Channel Message チャネル メッセージを送信 名前からチームを取得
TeamMember.ReadWrite.All	サインインしているユーザーに代わってチームにメンバーを追加します。 チーム内のメンバーの一リストを取得します。	すべてのチーム メンバーのリストを取得 ユーザーをチームに招待 [レコードを挿入] → Team Members [すべてのレコードのリストを取得] → Team Members
Channel.Create	チームの各ユーザーを招待して協働を可能にするためのチャネル (標準/プライベート) を作成します。	チャンネルを作成
Channel.ReadBasic.All	チャネル メッセージの送信などのアクティビティで選択するチームのチャネルのリストを取得します。	チャネルにメンバーを招待 名前からチャネルを取得 チャネル メッセージに返信 チャネル メッセージを送信
ChannelMember.ReadWrite.All	サインインしているユーザーに代わってチャネルにメンバーを追加します。 チャネル内のメンバーのリストを取得します。	チャネルにメンバーを招待 [すべてのレコードのリストを取得] → Team channel Members
ChannelMessage.Send	チャネルでメッセージを送信します。 また、必要に応じて、スレッド内のメッセージに返信します。	チャネル メッセージに返信 チャネル メッセージを送信
ChannelMessage.Read.All	サインインしているユーザーなしで、アプリが Microsoft Teams 内のすべてのチャネル メッセージを読み取ることを許可します。 また、チャネルにメッセージが投稿されるたびに、またはチャネルでキーワードが言及されるたびにイベントをトリガーするためにも使用されます	チャネル メッセージに返信 すべてのチャネル メッセージのリストを取得 [すべてのレコードのリストを取得] → Team channels Members チャンネルネルにメッセージが投稿された場合 (未来) チャネルでキーワードまたはユーザー名が投稿された場合 (未来)
Chat.ReadWrite	アプリが 1 対 1 のチャットを読み取りかつ送信することを許可します。 アプリがグループ チャット メッセージを読み取りかつ送信することを許可します。 また、チャットメッセージが投稿されるたびにイベントをトリガーするためにも使用されます	グループ チャット メッセージを送信 個々のチャット メッセージを送信 すべてのチャット メッセージのリストを取得 [すべてのレコードのリストを取得] → Chats チャット メッセージが投稿された場合 (未来)
ChatMember.ReadWrite	サインインしているユーザーに代わってチャットにメンバーを追加します。 チャット内のメンバーのリストを取得します。	[レコードを挿入] → Chat Members [すべてのレコードのリストを取得] → Chat Members
Calendars.ReadWrite	オンライン Teams 会議の Outlook 予定表エントリを作成します。	オンライン Teams 会議を作成
OnlineMeetings.ReadWrite	Microsot Teams でオンライン会議を作成し、現在のユーザーに代わって会議 ID、パスコード、および URL を取得します。	オンライン Teams 会議を作成
Files.Read.All	Teams チャネルまたはチャットで共有するために SharePoint にアップロードされたファイル情報を取得します。	チャネル メッセージを送信 グループ チャット メッセージを送信 個々のチャット メッセージを送信 チャネル メッセージに返信