Snowflake Cortex の認証

アカウント識別子と関連する資格情報を提示することにより、プログラムによるアクセス トークン、OAuth 2.0 認可コード、OAuth 2.0 クライアント資格情報と Microsoft Entra ID、または外部 OAuth 2.0 認可コードと PKCE を使用して、UiPath を Snowflake Cortex に接続します。

前提条件

このコネクタは、 プログラムによるアクセス トークン (既定)、 OAuth 2.0 認可コード、 OAuth 2.0 クライアント資格情報と Microsoft Entra ID、外部 OAuth 2.0 認可コードと PKCE の 4 つの認証方法をサポートしています。

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

• プログラムによるアクセス トークン:
  • アカウント識別子
  • 個人用アクセス トークン
• OAuth 2.0 認可コード:
  • アカウント識別子
  • クライアント ID
  • クライアント シークレット
  • スコープ - 既定値は session:role:SYSADMINです。接続するユーザーにそのロールが付与されていれば、別のロールに変更できます。
• OAuth 2.0 クライアント資格情報と Microsoft Entra ID:
  • アカウント識別子
  • クライアント ID と クライアント シークレット - Microsoft Entra ID アプリケーションの登録から取得します。
  • スコープ - Snowflake を表す Microsoft Entra ID アプリケーションのスコープです ( の形式 api://<application-id-uri>/.default。
  • テナント ID - Microsoft Entra ID のディレクトリ (テナント) ID です。Microsoft Entra ID アプリケーションの登録 の概要セクションで 確認できます。
• PKCE を使用した外部 OAuth 2.0 認可コード:
  • アカウント識別子
  • 認可 URL、 トークン URL、 更新トークン URL - ID プロバイダーの OAuth 2.0 エンドポイントです。
  • クライアント ID - ID プロバイダーへのアプリケーションの登録から取得します。この方法ではパブリック クライアントを使用するため、クライアント シークレットは必要ありません。
  • スコープ - offline_access は常に含まれます。これは、コネクションでトークンを更新するために必要であるためです。ID プロバイダーが Snowflake に対して必要とするスコープを追加します。

資格情報を取得する

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

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

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

注:

既定では、 ACCOUNTADMIN、 ORGADMIN、または SECURITYADMIN のロールを持つユーザーは、OAuth 2.0 認証を使用してコネクションを作成することがブロックされています。[ スコープ ] に入力するロールは、接続するユーザーに付与する必要があり、これら 3 つのロールのいずれかであってはなりません。詳しくは、「 Snowflake OAuth 認証フロー」をご覧ください。

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

1. 次のクエリを実行して、OAuth 連携を作成します。正しいリダイレクト URL を含めてください。 https://{baseURL}/provisioning_/callback (例: 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. 次のクエリを実行して、クライアント シークレットを表示します。OAUTH_CLIENT_SECRETをコピーします (OAUTH_CLIENT_SECRET_2ではありません)。

   select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');
   

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

OAuth 2.0 クライアント資格情報を Microsoft Entra ID 認証方法で使用する

このメソッドは、 Snowflake 独自の OAuth エンドポイントではなく Microsoft Entra ID を使用して Snowflake 外部 OAuth を介して認証します。コネクタは、Microsoft Entra ID アプリケーションのクライアント ID とシークレットをアクセス トークンと交換し、そのトークンを Snowflake に送信します。

Microsoft Entra ID 認証で OAuth 2.0 クライアント資格情報を設定するには、Microsoft Entra ID と Snowflake の両方を設定します。

1. Microsoft Entra ID でアプリケーションを登録し、そのクライアント シークレットを作成します。これによりクライアント ID と クライアント シークレットが提供され、 テナント ID はアプリケーションの [概要 ] セクションで確認できます。
2. Microsoft Entra ID で、Snowflake を表すアプリケーションを識別 (または登録) し、そのアプリケーション ID URI をメモします。これを使用して [スコープ] の値 ( api://<application-id-uri>/.default) を構築します。
3. Snowflake で、外部 OAuth のセキュリティ連携を作成します。アプリケーションの種類を Azure に設定し、オーディエンスを手順 2 のアプリケーション ID URI に設定し、Snowflake ユーザーをサービス プリンシパルのトークン要求にマッピングします。

正確な設定構文については、Snowflake のドキュメントの「 Snowflake External OAuth with Microsoft Entra ID 」をご覧ください。

PKCE 認証方法で外部 OAuth 2.0 認証コードを使用する

この方法では、OAuth 2.0 認可コード フローと Proof Key for Code Exchange (PKCE) を使用して、クライアント シークレットなしで、ユーザー自身の ID プロバイダーを介してサインインします。これは、外部 OAuth セキュリティ連携を通じて Snowflake が受け入れるトークンを持つすべての ID プロバイダーで機能します。Microsoft Entra ID は参照 ID プロバイダーです。

この認証方法を設定するには、ID プロバイダーと Snowflake を設定します。

1. ID プロバイダーで、アプリケーションをパブリック クライアントとして登録し、リダイレクト URI https://{baseURL}/provisioning_/callback を追加します (例: Automation Cloud https://cloud.uipath.com/provisioning_/callbackの場合は )。アプリケーションのクライアント ID は、接続の クライアント ID です。
2. Snowflake で、ID プロバイダーの外部 OAuth セキュリティ連携を作成します。この連携により、トークン内の upnなどのクレームが、ユーザーの LOGIN_NAMEを通じて Snowflake ユーザーにマッピングされます。
3. トークンによって、コネクションで使用するロールが付与されていることを確認してください。ロールはトークンのスコープ内に含まれている必要があります (連携で EXTERNAL_OAUTH_ANY_ROLE_MODE が に設定されている場合を除き、session:role:<role>などENABLE。
4. コネクションを作成する際は、[ 認可 URL]、[ トークン URL]、[ 更新トークン URL ] の値を、ID プロバイダーのエンドポイントに置き換えます。

正確な設定構文については、Snowflake のドキュメントの「 外部 OAuth の概要 」をご覧ください。

Snowflake Cortex 接続を追加する

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

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

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

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

5. 認証の種類を、[ プログラムによるアクセス トークン]、[ OAuth 2.0 認可コード]、[ OAuth 2.0 クライアント資格情報と Microsoft Entra ID]、または [ 外部 OAuth 2.0 認可コードと PKCE] から選択します。

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

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