Snowflake の認証

OAuth 2.0 または Automation Suite のカスタム JDBC 認証を使用して UiPath を Snowflake に接続します。

前提条件

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

• 独自の OAuth 2.0 アプリ (BYOA) を使用する:
  • クライアント ID
  • クライアント シークレット
  • データベース ホスト
  • ウェアハウス
  • データベース スキーマ名
  • データベース名
  • ロール
• 個人用アクセス トークン (認証にプログラムによるアクセス トークンを使用)
  • ユーザー名
  • 個人用アクセス トークン
  • ウェアハウス
  • データベース スキーマ名
  • データベース名
  • ロール
• カスタム認証 (非推奨の JDBC 認証):
  • データベース ホスト
  • ユーザー名
  • パスワード
  • ウェアハウス
  • データベース スキーマ名
  • データベース名
• RSA (キー ペア認証およびキー ペア ローテーション)
  • データベース ホスト
  • ユーザー名
  • RSA 秘密キー
  • ウェアハウス
  • データベース スキーマ名
  • データベース名

注:

既知の制限事項:

• RSA を使用して認証するには、暗号化されていない RSA 秘密キーを使用する必要があります。
• AWS PrivateLink 経由の接続はサポートされていません。
• Snowflake インスタンスが IP によってアクセスを制限している場合は、Integration Service で使用される IP の許可リストを構成する必要があります。詳しくは、『Automation Suite インストール ガイド』の「 コネクタ ドメインの許可リストを設定する 」をご覧ください。

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] に移動します。

Snowflake から OAuth 資格情報を取得する

注:

OAuth2 資格情報を作成できるのは、ACCOUNTADMIN ロールを持つユーザーのみです。既定では、ACCOUNTADMIN、ORGADMIN、および SECURITYADMIN ロールを持つユーザーは、OAuth 2.0 認証を使用してコネクションを作成することがブロックされています。詳しくは、「 Snowflake OAuth の認証フロー」をご覧ください。

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

1. 次のクエリを実行して、OAuth 連携を作成します。

このクエリではクライアント ID は表示されません。クライアントの詳細を表示するには、2 番目のクエリを実行する必要があります。クエリには正しいリダイレクト URL (https://{yourDomain}/provisioning_/callback) を含めてください。

CREATE SECURITY INTEGRATION my_oauth_integration_uipath
   TYPE=OAUTH
   OAUTH_CLIENT= CUSTOM
   OAUTH_REDIRECT_URI='https://{yourDomain}/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 ドキュメントの「 アクセス制御権限 」をご覧ください。