Snowflake の認証

前提条件

選択した認証の種類に応じて、次のいずれかの資格情報が必要です。

• カスタム認証 (JDBC 認証) の場合:
  • データベース ホスト
  • ユーザー名
  • パスワード
  • ウェアハウス
  • データベース スキーマ名
  • データベース名
• OAuth 2.0 Authorization code:
  • クライアント ID
  • クライアント シークレット
  • データベース ホスト
  • ウェアハウス
  • データベース スキーマ名
  • データベース名
  • ロール
• RSA (キー ペア認証およびキー ペア ローテーション)
  • データベース ホスト
  • ユーザー名
  • RSA 秘密キー
  • ウェアハウス
  • データベース スキーマ名
  • データベース名

注:

既知の制限事項:

• RSA を使用して認証するには、暗号化されていない RSA 秘密キーを使用する必要があります。

• AWS PrivateLink 経由の接続はサポートされていません。

• Irrespective of the selected authentication method, if your Snowflake instance restricts access by IP, you must configure an allow list for the IPs used by Integration Service. For details, refer to the Configuring the firewall section from the Automation Cloud Admin guide.

Retrieving your credentials from Snowflake

To retrieve the credentials from Snowflake, take the following steps:

1. データベース ホストは、Snowflake アプリへの接続に使用した URL で取得できます。

   Note: The Database host format may differ depending on your account identifier type. To learn more, refer to the section on Database Host available on this page, as well as the official Snowflake documentation.
   
   

   

   
   
   For example, for the following URL https://app.snowflake.com/east-us-2.azure/za96341/dashboards, the accountID is za96341 and the region is east-us-2.azure.
   データベース・ホストを構成するには、 accountID.region.snowflakecomputing.com形式を使用する必要があります。 したがって、前の URL については、構築されるデータベース ホストは za96341.east-us-2.azure.snowflakecomputing.comです。

2. ログインしたら、左側のメニューで [Data]、[Databases] の順に選択します。

   • Database name: データベースのリストが表示されます。

     
     

     

     
     

   • データベース スキーマ名 - データベース スキーマ名のリストを表示するデータベースを選択します。

     
     

     

     
     

3. ウェアハウスを取得するには、左側のメニューで [Admin] > [Warehouses] に移動します。

   
   

   

   
   

Using the OAuth 2.0 Authorization code authentication method

Note: Only users with an ACCOUNTADMIN role can create OAuth2 credentials. By default, users with ACCOUNTADMIN, ORGADMIN, and SECURITYADMIN roles are blocked from using OAuth 2.0 authentication to create a connection. For details, refer to Snowflake OAuth authorization flow.

To create an OAuth 2.0 client for Snowflake, take the following steps:

1. Run the following query to create the OAuth integration.
   This query does not show the Client ID. You must run a second query to view the client details. Make sure to include the correct redirect URL in the query: 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. Run the following query to view the client details. Copy the OAUTH_CLIENT_ID.

    DESCRIBE SECURITY INTEGRATION my_oauth_integration_uipath

3. Run the following query to view the client secret. Copy the OAUTH_CLIENT_SECRET.
   This query outputs two items: OAUTH_CLIENT_SECRET and OAUTH_CLIENT_SECRET_2. You must use OAUTH_CLIENT_SECRET.

    select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');

For details, refer to Configure Snowflake OAuth for custom clients.

Adding the Snowflake connection

1. Automation Cloud^TM で [Integration Service] を選択します。

2. [ コネクタ] のリストから [Snowflake] を選択します。 検索バーを使用してコネクタを検索することもできます。
3. Select the Connect to Snowflake button and select your preferred authentication method.
4. 必要な Snowflake の資格情報を入力します。

5. [接続] を選択します。

6. コネクションが追加されました。

権限

接続すると、ユーザーの代わりに UiPath が Snowflake のデータの読み込み、書き込み、変更および削除をできるようになります。

Snowflake に接続するために必要なロール

While creating a connection for Snowflake from Integration Service, the connector always selects the default role of the user, as shown in the following image.

Snowflake administrators can set up custom roles for users, because not everyone is granted administrator roles for security reasons.

The following example shows what exactly is needed in Snowflake for the Integration Service connection process to work smoothly. In this example, you create a connection using the DEAL_AMOUNT database schema and JULY_DEMO database.

最初の手順では、既定のロール (この場合は SAMRAT) が、Snowflake のデータベース (JULY_DEMO) とデータベース スキーマ (DEAL_AMOUNT) 　の両方に対して USAGE 権限を持っていることを確認します。

Snowflake の正常な認証は、これらの設定に依存します。管理者は、ロールに対して追加の権限をいつでも割り当てることができます。