Microsoft Teams の認証

前提条件

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

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

[スコープ] フィールドは、通常のユーザー操作の既定のスコープを表します。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 インスタンスへのコネクションを作成するには、次の手順を実行する必要があります。

Automation Cloud^TM で [Integration Service] を選択します。
[ コネクタ] のリストから [ Microsoft Teams] を選択します。検索バーで検索して、表示されるコネクタの数を絞ることもできます。
[ Microsoft Teamsに接続] を選択します。
これで、コネクションのページにリダイレクトされます。[OAuth 2.0 認可コード] または [独自の OAuth 2.0 アプリ (BYOA) を使用する] の 2 つの認証の種類から選択できます。
必要な資格情報を入力します。
[接続] を選択します。
コネクションが追加されました。

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 にアップロードされたファイル情報を取得します。	チャネルメッセージを送信グループチャットメッセージを送信個々のチャットメッセージを送信チャネルメッセージに返信