Microsoft Teams Scope

The Microsoft Teams activities use the Microsoft identity platform to establish an authenticated connection between UiPath and your Microsoft Teams application via the Microsoft Scope activity. This connection enables a Robot to call the Microsoft Graph API to read and write resources on your behalf.

To establish your authenticated connection, you first register your Microsoft Teams application in your Azure Active Directory (using your personal, work, and/or school Microsoft Office 365 account). When registering your application, you assign the Microsoft Graph API permissions that specify the resources a Robot can access on your behalf.

After registering your Microsoft Teams application, Azure Active Directory assigns a unique application (client) ID that you enter in the Microsoft Teams Scope activity. The ApplicationID is used to collect the necessary information about your registered app to initiate authentication.

注:

To learn more about registering your application and assigning permission, see the Setup guide. This guide provides step-by-step instructions to configure your Microsoft Teams application for automation.

動作のしくみ

The following steps and message sequence diagram is an example of how the activity works from design time (that is, the activity dependencies and input/output properties) to run time.

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

2. Add the Microsoft Teams Scope activity to your project.

3. Enter values for the Authentication, Input, and Unattended (if applicable) properties.

   

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

The Microsoft Teams Scope activity has three different authentication flows (AuthenticationTypes) that you can choose from when adding the activity to your project. Your selection is dependent on the type of automation mode you plan to run (unattended or attended) and your application authentication requirements (consult with your administrator if you're unsure which authentication requirements apply to your application).

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

重要:

Unattended automation does not support multi-factor authentication. If you're application requires multi-factor authentication, you can only run attended automation using the InteractiveToken authentication type.

対話型トークン

The InteractiveToken authentication type can be used for attended automation and when multi-factor authentication (MFA) is required. This is the default option and what we use in our examples. If you're interested in "playing around" with the activity package, this option is easy to configure and works well for personal accounts (using the default redirect URI noted in step 7 of the Register your application section of the Setup guide).

When the Microsoft Teams Scope activity is run for the first time using this authentication type, you are prompted to authorize access to the resources (you granted permissions to when registering your app) via a consent dialogue box.

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

This authentication type follows the OAuth 2.0 authorization code flow.

統合 Windows 認証

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

You should only select this option if your registered application is configured to support Integrated Windows Authentication (additional information can be found on GitHub).

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

ユーザー名とパスワード

The UsernameAndPassword authentication type can be used for both attended (when multi-factor authentication is not required) and unattended automation.

Though it's not recommended by Microsoft, you can use this authentication type in public client applications. Using this authentication type imposes constraints on your application. For instance, apps using this flow won't be able to sign in a user who needs to perform multi-factor authentication (conditional access). It won't enable your application to benefit from single sign-on either. Authentication with username/password goes against the principles of modern authentication and is only provided for legacy reasons (additional information can be found on GitHub).

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

注:

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

プロパティ

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

共通

表示名

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

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

認証

アプリケーション ID

The unique application (client) ID assigned by the Azure Active Directory when you registered your app during Setup.

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	アプリケーション (クライアント) ID は、Microsoft Teams アプリケーションのインスタンスを表します。 1 つの組織が、組織の Microsoft Office 365 アカウントで、複数のアプリケーション (クライアント) ID を持つことができます。 各アプリケーション (クライアント) ID には、それぞれ専用のアクセス許可と認証要件が含まれます。 For example, you and your colleague can both register a Microsoft Teams application in your company's Azure Active Directory and generate your own application (client) ID.

認証の種類

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

属性	詳細
入力	ドロップダウン選択
Required	はい
既定値	対話型トークン
許容値	Select one of the three options: InteractiveToken IntegratedWindowsAuthentication UsernameAndPassword
備考	For more information about these options and which one to select, see the Unattended and Attended Automation section above.

テナント

The unique directory (tenant) ID assigned by the Azure Active Directory when you registered your app during.

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

対話型トークン

OAuth アプリケーション

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

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

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

These properties apply when you run unattended automation only. When specifying values for these properties, be sure the AuthenticationType property is set to UsernameAndPassword. For more information, see the Username and Password section above.

パスワード

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

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

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

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

属性	詳細
入力	SecureString
Required	No (required if AuthenticationType is UsernameAndPassword) and Password is null.
既定値	空
許容値	SecureString または SecureString 型変数を入力します。
備考	N/A

ユーザー名

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

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