Microsoft Teams Scope

Microsoft Teams アクティビティは、 Microsoft ID プラットフォーム を使用して、[ Microsoft スコープ ] アクティビティを介して UiPath と Microsoft Teams アプリケーション間の認証されたコネクションを確立します。この接続によって、ロボットは Microsoft Graph API を呼び出して、ユーザーの代わりにリソースを読み書きすることができます。

認証されたコネクションを確立するには、まず、Microsoft Teams アプリケーションを Azure Active Directory に登録します (個人、仕事、学校などの Microsoft Office 365 アカウントを使用)。アプリケーションを登録するときに、 Microsoft Graph API アクセス許可 を割り当て、ユーザーに代わってロボットがアクセスできるリソースを指定します。

Microsoft Teams アプリケーションを登録すると、Azure Active Directory は一意のアプリケーション (クライアント) ID を割り当てます。この ID を [Microsoft Teams スコープ ] アクティビティに入力します。アプリケーション ID を使用して登録済みアプリケーションに関する必要な情報を収集し、認証を開始します。

注:

アプリケーションの登録とアクセス許可の割り当てに関する詳細は、 セットアップ ガイドをご覧ください。このガイドでは、Microsoft Teams アプリケーションを自動化するための設定手順を、ステップバイステップで解説しています。

動作のしくみ

次の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入出力プロパティ) から実行時までのアクティビティの動作の例です。

1. 「セットアップ」の手順を完了します。

2. プロジェクトに [ Microsoft Teams スコープ ] アクティビティを追加します。

3. [認証]、[入力]、[Unattended] (該当する場合) プロパティの値を入力します。

   

無人オートメーションと有人オートメーション

[ Microsoft Teams スコープ ] アクティビティには、アクティビティをプロジェクトに追加するときに選択できる 3 種類の認証フロー ([認証の種類]) があります。選択するフローは、実行する自動化モードの種類 (Unattended または Attended) とアプリケーションの認証要件によって異なります (使用するアプリケーションに適用される認証要件が不明の場合は、管理者に問い合わせてください)。

認証の種類	Attended	Unattended
対話型トークン	X	N/A
統合 Windows 認証	X	X
ユーザー名とパスワード	X	X

重要:

無人オートメーションでは、多要素認証をサポートしていません。アプリケーションが多要素認証を必要とする場合は、認証の種類として [対話型トークン] を使用する有人オートメーションしか実行できません。

対話型トークン

認証の種類の 1 つである [対話型トークン] は、多要素認証 (MFA) が必要な場合に、有人オートメーションで使用できます。これは既定のオプションであり、今回の例で使用します。アクティビティ パッケージに手を加えてみたい場合、このオプションは設定が容易で、個人アカウントで十分に機能します (セットアップ ガイドの「アプリケーションの登録」セクションのステップ 7 に記載された既定のリダイレクト URI を使用します)。

この認証の種類を使用してはじめて [ Microsoft Teams スコープ ] アクティビティを実行する場合、 同意 を求めるダイアログ ボックスが表示され、リソース (アプリの登録時にアクセス許可を与えたもの) へのアクセスを認可するよう促されます。

このオプションを選択した場合、[ユーザー名]、[パスワード]、[テナント] プロパティは空のままにする必要があります。

この認証の種類は、OAuth 2.0 認証コード フローに準拠しています。

統合 Windows 認証

認証の種類の 1 つである [統合 Windows 認証] は有人オートメーションおよび無人オートメーションの両方に使用できます。このオプションは、Windows ドメインまたは Azure Active Directory に参加しているコンピューター上で実行される Windows がホストするアプリケーションに適用できます。

このオプションは、登録済みアプリケーションが統合 Windows 認証をサポートするように設定されている場合にのみ選択してください (詳細は GitHub 社のサイトをご覧ください)。

このオプションを選択した場合、[ユーザー名]、[パスワード]、[テナント] プロパティは空のままにする必要があります。

ユーザー名とパスワード

認証の種類として [ユーザー名とパスワード ] は、有人オートメーション (多要素認証が不要な場合) と無人オートメーションの両方に使用できます。

Microsoft では推奨していませんが、この認証の種類をパブリック クライアント アプリケーションに使用できます。この認証の種類を使用すると、アプリケーションに制約が課されます。たとえば、このフローを使用するアプリケーションには、多要素認証を実行する必要があるユーザーはサインインできません (条件付きアクセス)。また、シングル サインオンのメリットも得られなくなります。ユーザー名/パスワードによる認証は、最新の認証の原則に反するものであり、レガシーへの対応のみを目的に提供されています (詳細は GitHub社のサイトをご覧ください)。

このオプションを選択する場合、[ユーザー名] および [パスワード] プロパティが必須であり、単一テナントのアプリケーションの場合、[テナント] プロパティは任意です (マルチテナント アプリケーションの場合は必須)。

注:

[認証の種類] で [ユーザー名とパスワード] を選択する場合は、[アプリケーション ID] プロパティが必須になります。個人、仕事、学校のアカウントで Microsoft Office 365 アプリケーションを登録できます。

プロパティ

以下のプロパティの値は、このアクティビティを UiPath Studio でプロジェクトに追加するときに指定します。

共通

表示名

アクティビティの表示名です。

属性	詳細
入力	String
Required	はい
既定値	Microsoft Teams Scope
許容値	String または String 型変数を入力します。
備考	N/A

認証

アプリケーション ID

セットアップでアプリケーションを登録するときに Azure Active Directory によって割り当てられた一意のアプリケーション (クライアント) ID。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	アプリケーション (クライアント) ID は、Microsoft Teams アプリケーションのインスタンスを表します。 1 つの組織が、組織の Microsoft Office 365 アカウントで、複数のアプリケーション (クライアント) ID を持つことができます。 各アプリケーション (クライアント) ID には、それぞれ専用のアクセス許可と認証要件が含まれます。 たとえば、あるユーザーとその同僚の両方が、会社の Azure Active Directory に Microsoft Teams アプリケーションを登録し、独自のアプリケーション (クライアント) ID を生成できます。

認証の種類

登録済みアプリケーションに必要な認証の種類。

属性	詳細
入力	ドロップダウン選択
Required	はい
既定値	対話型トークン
許容値	次の 3 つのオプションから 1 つを選択します: InteractiveToken、Integrated、WindowsAuthentication、UsernameandPassword
備考	これらのオプションの詳細、および選択すべきオプションについては、上記の 「有人オートメーションと無人オートメーション 」のセクションをご覧ください。

テナント

アプリケーションの登録時に Azure Active Directory によって割り当てられた一意のディレクトリ (テナント) ID。

属性	詳細
入力	String
Required	いいえ (マルチテナント アプリケーションの場合は必須)
既定値	空
許容値	String または String 型変数を入力します。
備考	ディレクトリ (テナント) ID は登録済みアプリケーションの概要ページ (アプリケーション (クライアント) ID の下) で確認できます。

対話型トークン

OAuth アプリケーション

使用するアプリケーション (クライアント) を指定します。

属性	詳細
入力	enum
Required	いいえ
既定値	カスタム
許容値	カスタム、UiPath
備考	「UiPath」を選択した場合、アプリケーション ID とテナントは無視されます。

ユーザー名とパスワード (Unattended)

これらのプロパティは、無人オートメーションを実行する場合にのみ適用されます。これらのプロパティに値を指定する場合、[認証の種類] プロパティが [ユーザー名とパスワード] に設定されていることを確認してください。詳細は、上記の「ユーザー名とパスワード」のセクションをご覧ください。

パスワード

Microsoft Office 365 アカウントのパスワードです。

属性	詳細
入力	String
Required	いいえ ([認証の種類] が [ユーザー名とパスワード] の場合は必須)
既定値	空
許容値	String または String 型変数を入力します。
備考	N/A

セキュリティで保護されたパスワード

Microsoft Office 365 アカウントのパスワードです。

属性	詳細
入力	SecureString
Required	いいえ ( [認証の種類 ] が [ユーザー名とパスワード] の場合は必須)、パスワードは null です。
既定値	空
許容値	SecureString または SecureString 型変数を入力します。
備考	N/A

ユーザー名

Microsoft Office 365 アカウントのユーザー名です。

属性	詳細
入力	String
Required	いいえ ([認証の種類] が [ユーザー名とパスワード] の場合は必須)
既定値	空
許容値	String または String 型変数を入力します。
備考	N/A