Snowflake Cortex の認証

個人用アクセス トークン、OAuth 2.0 認可コード、または OAuth 2.0 クライアント資格情報を使用して、アカウント識別子と関連する資格情報を指定して、UiPath を Snowflake Cortex に接続します。

前提条件

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

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

• プログラムによるアクセス トークン:
  • アカウント識別子
  • 個人用アクセス トークン
• OAuth 2.0 認可コード:
  • アカウント識別子
  • クライアント ID
  • クライアント シークレット
  • スコープ - 既定値は session:role:SYSADMINです。接続するユーザーにそのロールが付与されていれば、別のロールに変更できます。
• OAuth 2.0 クライアント資格情報:
  • アカウント識別子
  • クライアント ID と クライアント シークレット - Microsoft Entra ID アプリケーションの登録から取得します。
  • スコープ - Snowflake を表す Microsoft Entra ID アプリケーションのスコープです ( の形式 api://<application-id-uri>/.default。
  • テナント ID - Microsoft Entra ID のディレクトリ (テナント) ID です。Microsoft Entra ID アプリケーションの登録 の概要セクションで 確認できます。

資格情報を取得する

アカウント識別子は、[アカウントの詳細] またはアカウント サーバーの 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 クライアント資格情報の認証方法を使用する

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

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 」をご覧ください。

Snowflake Cortex 接続を追加する

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

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

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

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

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

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

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