Microsoft Teams の認証

前提条件

選択した認証の種類に応じて、次のいずれかの資格情報が必要です。

• スコープと Microsoft のユーザー名とパスワード (OAuth 2.0 認証コードの場合)
• スコープ、クライアント ID、クライアント シークレット (Bring your own OAuth 2.0 アプリの場合)

Scope は、通常のユーザーによる操作の既定のスコープを表します (例: Team.Create Channel.Create ChannelMember.ReadWrite.All ChannelMessage.Send Chat.ReadWrite ChannelMessage.Read.All Calendars.ReadWrite)。

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

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

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

サード パーティ アプリに権限を付与する

コネクションを確立する前に、管理センターから連携するアプリに対してアクセス許可が付与されていることを確認してください。

1. Microsoft 365 管理センターにログインします。

2. [Settings] に移動して [Org settings] を選択します。

   
   

   

   
   

3. [Services] タブで [User consent to apps] を選択します。

   
   

   

   
   

4. [Let users provide consent when apps request access to your organization's data on their behalf] チェックボックスが有効化されていることを確認して、[Save] を選択します。

   
   

   

   
   

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

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

1. Select Integration Service from Automation Cloud^TM.

2. [ コネクタ] のリストから [ Microsoft Teams] を選択します。 検索バーで検索して、表示されるコネクタの数を絞ることもできます。

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

4. これで、コネクションのページにリダイレクトされます。[OAuth 2.0 認可コード] または [独自の OAuth 2.0 アプリ (BYOA) を使用する] の 2 つの認証の種類から選択できます。

   
   

   

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

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

7. コネクションが追加されました。

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

範囲と権限

このコネクションを使用して、UiPath Studio で Microsoft Teams アクティビティ パッケージ を有効化することで、ユーザーとチャンネルの管理、メッセージなど協働のために必要な作業のオートメーションを作成できます。 実現できるさまざまな権限ベースのユース ケースは次のとおりです。

Scope	ユースケース	アクティビティ/イベント
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