Microsoft Azure Active Directory の認証

前提条件

Microsoft Azure Active Directory コネクタは、以下の認証方法をサポートしています。

• Application access - OAuth2.0 (クライアント資格情報)
• Delegated access - OAuth2.0 (認可の付与)
• クライアント証明書の認証 - OAuth2.0 (クライアント証明書)

Before creating a connection, you need an active Microsoft Azure application registration. To set one up:

1. Sign in to the Azure Portal and navigate to Azure Active Directory > App registrations.
2. Select New registration.
3. Enter a name for your application (for example, UiPath IS Azure AD).
4. Under Supported account types, select one of the following:
   • Accounts in this organizational directory only — for a single-tenant application.
   • Accounts in any organizational directory — for a multi-tenant application.
5. [登録] を選択します。

After registration, collect the following values from the app's Overview page — you will need them when creating the connection in Integration Service:

値 (Value)	Where to find it
アプリケーション (クライアント) ID	Overview page of the app registration
ディレクトリ (テナント) ID	Overview page of the app registration

コネクションを作成するには、次の資格情報が必要です。

• [Application access] の場合
  • クライアント ID
  • クライアント シークレット
  • テナント ID
• [Delegated access] の場合
  • クライアント ID
  • クライアント シークレット
  • テナント ID
  • ユーザー名
  • パスワード
• クライアント証明書認証の場合:
  • クライアント ID
  • OAuth Base64 クライアント証明書
  • 証明書のパスワード
  • テナント ID
  • OAuth スコープ

認証資格情報の詳細および Azure Active Directory との連携の設定方法について詳しくは、『Automation Cloud ガイド』の「 Azure AD 連携を設定する 」をご覧ください。

その他の情報については、Microsoft の公式ドキュメントをご覧ください (「Authentication and authorization basics」、「Introduction to permissions and consent」、「Retrieving credentials」)。

Application access

Use this option to authenticate as the application itself, without a signed-in user context. This is the recommended option for unattended automation scenarios.

Setting up the client secret in Azure

1. In your Azure app registration, go to Certificates & secrets > Client secrets > New client secret.
2. Enter a description and select an expiry period.
3. Select Add and immediately copy the Value — it is shown only once.

重要:

Client secrets expire. Rotate the secret before the expiry date to avoid connection failures.

必要な API のアクセス許可

In your Azure app registration, go to API permissions > Add a permission > Microsoft Graph > Application permissions and add the following:

Minimum required

アクセス許可	入力	説明
User.Read.All	アプリケーション	Read all users' full profiles
Group.Read.All	アプリケーション	Read all groups
Directory.Read.All	アプリケーション	Read directory data
RoleManagement.Read.Directory	アプリケーション	Read all directory RBAC settings

Optional (add only if your automation creates or modifies objects)

アクセス許可	入力	説明
Group.ReadWrite.All	アプリケーション	Read and write all groups
Directory.ReadWrite.All	アプリケーション	Read and write directory data
RoleManagement.ReadWrite.Directory	アプリケーション	Read and write all directory RBAC settings

After adding the permissions, select Grant admin consent for [your organization].

接続フィールド

フィールド	説明
クライアント ID	The Application (client) ID from the Overview section of your Azure app registration.
クライアント シークレット	The secret value from the Certificates & secrets section. Use the Value, not the Secret ID.
テナント ID	The Directory (tenant) ID from the Overview section of your Azure app registration.

委任されたアクセス

Use this option to perform actions on behalf of a signed-in user. The connection authenticates using OAuth 2.0 delegated permissions and prompts the user for consent during connection creation.

Setting up delegated access in Azure

1. In your Azure app registration, go to Authentication > Add a platform > Web.

2. In the Redirect URIs field, enter the callback URL displayed on the UiPath connection screen: https://{baseURL}/provisioning_/callback (for example, https://cloud.uipath.com/provisioning_/callback for Automation Cloud).

   注:

   The exact callback URL is shown on the connection creation screen in Integration Service. Copy it from there, as it may differ depending on your deployment (Automation Cloud, Automation Suite, or private cloud).

3. Under Implicit grant and hybrid flows, leave both checkboxes unselected.

4. [構成] を選択します。

必要な API のアクセス許可

In your Azure app registration, go to API permissions > Add a permission > Microsoft Graph > Delegated permissions and add the following:

Minimum required (needed to establish the OAuth connection)

アクセス許可	入力	説明
openid	委任されたアクセス許可	Sign users in
profile	委任されたアクセス許可	View users' basic profile
email	委任されたアクセス許可	View users' email address
offline_access	委任されたアクセス許可	Maintain access to data when the user is not present
User.Read	委任されたアクセス許可	Sign in and read user profile

Optional (add based on the operations your automation performs; permissions marked with * require admin consent)

アクセス許可	入力	説明
User.ReadWrite	委任されたアクセス許可	Read and update user profile
User.Read.All*	委任されたアクセス許可	Read all users' full profiles
Group.Read.All*	委任されたアクセス許可	Read all groups
Group.ReadWrite.All*	委任されたアクセス許可	Read and write all groups
Directory.Read.All*	委任されたアクセス許可	Read directory data
Directory.ReadWrite.All*	委任されたアクセス許可	Read and write directory data

For permissions that require admin consent, select Grant admin consent for [your organization] after adding them.

接続フィールド

フィールド	説明
クライアント ID	The Application (client) ID from the Overview section of your Azure app registration.
クライアント シークレット	The secret value from the Certificates & secrets section. Use the Value, not the Secret ID.
テナント ID	The Directory (tenant) ID from the Overview section of your Azure app registration. For multi-tenant applications, use common. For single-tenant applications, enter your specific tenant ID.

After filling in the fields, select Connect. A Microsoft sign-in window opens — sign in with the user account to be used for automation and grant the requested permissions.

クライアント証明書の認証

Use this option to authenticate using a client certificate instead of a client secret.

Setting up a certificate in Azure

1. In your Azure app registration, go to Certificates & secrets > Certificates.
2. Select Upload certificate and upload your .cer or .pem public key file.
3. After upload, note the thumbprint value for your records.

Generating the certificate locally

To generate a certificate locally (if you do not already have one):

1. Create a self-signed certificate with Subject set to CN=uipath.com and Content Type set to PEM.
2. Download the certificate in .pfx format.
3. Convert the .pfx file to Base64-encoded format before entering it in the connection field.

You can also use a Powershell script. For example, the following script generates a self-signed certificate and exports it in the required formats:

# Generate self-signed cert
$cert = New-SelfSignedCertificate `
    -Subject "CN=uipath.com" `
    -CertStoreLocation "Cert:\CurrentUser\My" `
    -KeyExportPolicy Exportable `
    -KeySpec Signature `
    -KeyLength 2048 `
    -HashAlgorithm SHA256 `
    -NotAfter (Get-Date).AddYears(2)

# Export public key (.cer) — upload this to Azure
Export-Certificate -Cert $cert -FilePath ".\uipath.cer" -Type CERT

# Export private key (.pfx)
$pfxPassword = Read-Host "Enter PFX password" -AsSecureString
Export-PfxCertificate -Cert $cert -FilePath ".\uipath.pfx" -Password $pfxPassword

# Convert .pfx to Base64 — paste this value into the connection field
$base64 = [Convert]::ToBase64String([IO.File]::ReadAllBytes(".\uipath.pfx"))
$base64 | Out-File ".\uipath_base64.txt"

Write-Host "Thumbprint: $($cert.Thumbprint)"
Write-Host "Base64 saved to uipath_base64.txt"
Write-Host "Upload uipath.cer to Azure > Certificates & secrets > Certificates"

必要な API のアクセス許可

In your Azure app registration, go to API permissions > Add a permission > Microsoft Graph > Application permissions and add the following:

Minimum required

アクセス許可	入力	説明
User.Read.All	アプリケーション	Read all users' full profiles
Group.Read.All	アプリケーション	Read all groups
Directory.Read.All	アプリケーション	Read directory data

Optional (add only if your automation creates or modifies objects)

アクセス許可	入力	説明
Group.ReadWrite.All	アプリケーション	Read and write all groups
Directory.ReadWrite.All	アプリケーション	Read and write directory data

After adding the permissions, select Grant admin consent for [your organization].

接続フィールド

フィールド	説明
OAuth Base64 クライアント証明書	The client certificate in Base64-encoded format, converted from the .pfx file downloaded from Azure.
証明書のパスワード	The password set during certificate creation.
クライアント ID	The Application (client) ID from the Overview section of your Azure app registration.
テナント ID	The Directory (tenant) ID from the Overview section of your Azure app registration.

コネクションを追加する

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

1. 製品ランチャーから [Orchestrator] を選択します。
2. フォルダーを選択して [ コネクション ] タブに移動します。
3. [ コネクションを追加] を選択します。
4. コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。
5. [ 認証の種類 ] ドロップダウンから、利用可能なオプション [ クライアント証明書の認証]、[ アプリケーション アクセス]、[ 委任されたアクセス] のいずれかを選択します。既定では、[ Application access ] が選択されています。
6. 必要な資格情報を入力し、[接続] を選択します。