Snowflake Cortex の認証

Connect UiPath to Snowflake Cortex using a Personal Access Token, OAuth 2.0 Authorization code, or OAuth 2.0 Client credentials, by providing your account identifier and related credentials.

前提条件

This connector supports three authentication methods: Programmatic Access Token (default), OAuth 2.0 Authorization code, and OAuth 2.0 Client credentials.

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

• Programmatic Access Token:
  • アカウント識別子
  • 個人用アクセス トークン
• OAuth 2.0 Authorization code:
  • アカウント識別子
  • クライアント ID
  • クライアント シークレット
  • Scope - Defaults to session:role:SYSADMIN. You can change this to a different role, provided that role is granted to the connecting user.
• OAuth 2.0 クライアント資格情報:
  • アカウント識別子
  • Client ID and Client Secret - From the Microsoft Entra ID application registration.
  • Scope - The scope of the Microsoft Entra ID application representing Snowflake, in the form api://<application-id-uri>/.default.
  • Tenant ID - The Microsoft Entra ID directory (tenant) ID, available in the Overview section of your Microsoft Entra ID application registration.

資格情報を取得する

アカウント識別子は、[アカウントの詳細] またはアカウント サーバーの URL から抽出できます。たとえば、URL YQXMADF-EWA19151.snowflakecomputing.com 識別子は YQXMADF-EWA19151です。

個人用アクセス トークン (PAT) は、Snowflake ダッシュボードの [設定 ] > [ 認証 ] > [プログラムによるアクセス トークン] で作成できます。PAT オプションは、ロールで作成が許可されている場合にのみ表示されます。詳細については、管理者にお問い合わせください。

OAuth 2.0 認可コード認証メソッドを使用する

注:

By default, users with the ACCOUNTADMIN, ORGADMIN, or SECURITYADMIN role are blocked from using OAuth 2.0 authentication to create a connection. The role you enter in Scope must be granted to the connecting user and must not be one of these three. For details, refer to Snowflake OAuth authorization flow.

SnowflakeのOAuth 2.0クライアントを作成するには、次の手順に従います。

1. Run the following query to create the OAuth integration. Make sure to include the correct redirect URL: https://{baseURL}/provisioning_/callback (for example, for Automation Cloud, https://cloud.uipath.com/provisioning_/callback).

   CREATE SECURITY INTEGRATION my_oauth_integration_uipath
      TYPE=OAUTH
      OAUTH_CLIENT=CUSTOM
      OAUTH_REDIRECT_URI='https://cloud.uipath.com/provisioning_/callback'
      OAUTH_CLIENT_TYPE='CONFIDENTIAL'
      OAUTH_ISSUE_REFRESH_TOKENS=true
      OAUTH_REFRESH_TOKEN_VALIDITY=86400
      ENABLED=true;
   

2. 次のクエリを実行して、クライアントの詳細を表示します。OAUTH_CLIENT_IDをコピーします。

   DESCRIBE SECURITY INTEGRATION my_oauth_integration_uipath
   

3. Run the following query to view the client secret. Copy OAUTH_CLIENT_SECRET (not OAUTH_CLIENT_SECRET_2).

   select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');
   

詳しくは、「 カスタム クライアント用に Snowflake OAuth を構成する」をご覧ください。

Using the OAuth 2.0 Client credentials authentication method

This method authenticates through Snowflake External OAuth with Microsoft Entra ID instead of Snowflake's own OAuth endpoint: the connector exchanges the Microsoft Entra ID application's client ID and secret for an access token, then sends that token to Snowflake.

To set up OAuth 2.0 Client credentials authentication, configure both Microsoft Entra ID and Snowflake:

1. In Microsoft Entra ID, register an application and create a client secret for it. This provides the Client ID and Client Secret, and the Tenant ID is available in the application's Overview section.
2. In Microsoft Entra ID, identify (or register) the application representing Snowflake and note its Application ID URI. Use it to build the Scope value: api://<application-id-uri>/.default.
3. In Snowflake, create a security integration for external OAuth with the application type set to Azure, the audience set to the Application ID URI from step 2, and a Snowflake user mapped to the service principal's token claim.

For the exact configuration syntax, refer to Snowflake External OAuth with Microsoft Entra ID in the Snowflake documentation.

Snowflake Cortex 接続を追加する

1. 製品ランチャーから [Orchestrator] を選択します。

2. フォルダーを選択して [ コネクション ] タブに移動します。

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

4. コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。

5. Select the authentication type: Programmatic Access Token, OAuth 2.0 Authorization code, or OAuth 2.0 Client credentials.

6. 必要な資格情報を入力し、[接続] を選択します。

   利用可能な場合は、フィールドの横にあるメニューを選択し、[ 資格情報アセットを使用 ] または [ Orchestrator アセットを使用 ] を選択して、値を直接入力するのではなく Orchestrator アセットを参照します。詳細については、「 コネクションに資格情報アセットを使用する」をご覧ください。