Snowflake の認証

前提条件

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

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

注:

既知の制限事項:

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

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

• 選択した認証方法に関係なく、Snowflake インスタンスが IP でアクセスを制限している場合は、Integration Service で使用される IP の許可リストを設定する必要があります。詳しくは、『Automation Cloud 管理ガイド』 の「ファイアウォールを構成する 」をご覧ください。

Snowflake からの資格情報の取得

Snowflake から資格情報を取得するには、次の手順に従います。

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

   手記：データベース ホストの形式は、アカウント識別子の種類によって異なる場合があります。詳細については、このページで利用可能なデータベース ホストに関するセクション、および Snowflake の公式ドキュメントをご参照ください。
   
   

   

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

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

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

     
     

     

     
     

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

     
     

     

     
     

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

   
   

   

   
   

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

手記： OAuth2 認証情報を作成できるのは、ACCOUNTADMIN ロールを持つユーザーのみです。デフォルトでは、ACCOUNTADMIN、ORGADMIN、および SECURITYADMIN ロールを持つユーザーは、OAuth 2.0 認証を使用してコネクションを作成するのがブロックされます。詳細については、「 Snowflake OAuth 認可フロー」をご参照ください。

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

1. 次のクエリを実行して、OAuth 連携を作成します。
   このクエリではクライアント ID は表示されません。クライアントの詳細を表示するには、2 番目のクエリを実行する必要があります。正しいものを含めてください リダイレクト URL: 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 と OAUTH_CLIENT_SECRET_2の 2 つの項目を出力します。OAUTH_CLIENT_SECRETを使用する必要があります。

   select system$show_oauth_client_secrets('MY_OAUTH_INTEGRATION_UIPATH');

詳細については、 カスタム クライアント用に Snowflake OAuth を構成する をご参照ください。

Snowflake コネクションを追加する

1. 左側のレールから [Integration Service] を選択します。
2. [ コネクタ] のリストから [Snowflake] を選択します。 検索バーを使用してコネクタを検索することもできます。
3. [ Snowflake に接続 ] ボタンを選択し、使用する認証方法を選択します。
4. 必要な Snowflake の資格情報を入力します。
5. [接続] を選択します。

権限

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

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

Integration Service から Snowflake のコネクションを作成する際は、次の図に示すように、コネクタは常にユーザーの既定のロールを選択します。

セキュリティ上の理由から誰もが管理者ロールを付与されるわけではないため、Snowflakeの管理者はユーザーにカスタム ロールを設定できます。

次の例は、Integration Service の接続プロセスがスムーズに動作するために Snowflake で必要とされている情報を正確に示しています。この例では、DEAL_AMOUNT データベース スキーマと JULY_DEMO データベースを使用して接続を作成します。

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

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

詳しくは、Snowflake ドキュメントの「 アクセス制御権限 」をご覧ください。