Snowflake Open Catalogでのキーペア認証の構成¶

ステップ1：Snowflake Open Catalog用のSnowflake CLI 接続を追加します。¶

キーペア認証を構成するSnowflake Open Catalogアカウントの接続を追加します。

• 次の値で :ref:<label-snowcli_snow_connection_command_add> の接続を追加してください。他のすべてのパラメーターについては、 Enter を押して、パラメーターの値の指定をスキップします。

  接続構成パラメーター	値
  この接続の名前	接続の名前を指定します。例: myopencatalogconnection.
  アカウント名	Snowflake 組織名の後にOpen Catalogアカウント名を、次の形式で指定してください。 <orgname>-<my-snowflake-open-catalog-account-name>。 例: ABCDEFG-MYACCOUNT1。 これらの名前を見つけるには、始める前に_ をご参照ください。
  ユーザー名	Open Catalogのユーザー名を指定します。例: jsmith。
  パスワード[オプション]	Open Catalogの接続を作成する場合、このパラメーターはオプションではありません。 Open Catalogのパスワードを入力します。例: MyPassword123456789。
  接続のロール[オプション]	Open Catalogの接続を作成する場合、このパラメーターはオプションではありません。 POLARIS_ACCOUNT_ADMIN を入力する必要があります

ステップ2：Snowflake CLI 接続をテストします¶

• CLI 接続をテストするには、myopencatalogconnection の接続をテストするこの例に従ってください。

  snow connection test -c myopencatalogconnection
  

  Copy

  応答は次のようになります。

  +------------------------------------------------------------------------------+
  | key              | value                                                     |
  |----------------------------+-------------------------------------------------|
  | Connection name  | myopencatalogconnection                                   |
  | Status           | OK                                                        |
  | Host             | ABCDEFG-MYACCOUNT1.snowflakecomputing.com                 |
  | Account          | ABCDEFG-MYACCOUNT1                                        |
  | User             | jsmith                                                    |
  | Role             | POLARIS_ACCOUNT_ADMIN                                     |
  | Database         | not set                                                   |
  | Warehouse        | not set                                                   |
  +------------------------------------------------------------------------------+
  

  Copy

ステップ3：デフォルトのSnowflake CLI 接続のセットアップ¶

使用している接続に常に必要な POLARIS_ACCOUNT_ADMIN ロールが付与されているようにするには、Open Catalog用に作成したSnowflakeの CLI 接続をデフォルト接続として設定できます。デフォルト接続の詳細については、 :ref:label-cli_set_default_connection をご参照ください。

1. myopencatalogconnection 接続をデフォルトとして設定する次の例に従ってください。

   snow connection set-default myopencatalogconnection
   

   Copy

2. 正しいユーザーとロールを使用していることを確認するには、以下を実行します。

   snow sql -q "Select current_user(); select current_role();"
   

   Copy

   応答としてOpen Catalog ユーザー名が返され、CURRENT ROLE は POLARIS_ACCOUNT_ADMIN になります。

   +----------------+
   | CURRENT_USER() |
   |----------------|
   | JSMITH        |
   +----------------+
   select current_role();
   +-----------------------+
   | CURRENT_ROLE()        |
   |-----------------------|
   | POLARIS_ACCOUNT_ADMIN |
   +-----------------------+
   

   Copy

秘密キーとパブリックキーを生成する¶

このセクションでは、秘密キーとパブリックキーを生成する方法について説明します。

秘密キーを生成するには、次のコマンドを使用します。

openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

パブリックキーを生成するには、次のコマンドを使用します。

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub

ユーザーにパブリックキーを割り当てます。¶

Snowflake CLI 接続を使用して、パブリックキーを自分に割り当てます。

1. パブリックキーを自分に割り当てるには、以下を実行します。

   snow sql -q "alter user <your_username> set RSA_PUBLIC_KEY='<your_public_key>';"
   

   Copy

   条件:

   • <your_username> は、Open Catalogにサインインするために使用するOpen Catalog UI のユーザー名です。

   注釈

   パブリックキーを取得する必要がある場合は、以下を実行します。 cat rsa_key.pub。

2. ユーザーのパブリックキー（RSA_PUBLIC_KEY）が設定され、ユーザーの RSA パブリックキー（RSA_PUBLIC_KEY_FP）のフィンガープリントが設定されていることを検証します。

   snow sql -q "desc user <your_username>;"
   

   Copy

   条件:

   • <your_username> は、Open Catalogにサインインするために使用するOpen Catalog UI のユーザー名です。

JSON ウェブトークンを生成する¶

このセクションでは、アクセストークンを生成するために必要な JSON ウェブトークン（JWT）を生成します。

1. SnowSQL を使用して JWT を生成するには、以下を実行します。

   snowsql --private-key-path rsa_key.p8 --generate-jwt -h <your_org_name>-<your_open_catalogaccount_name>.snowflakecomputing.com -a <account-identifier> -u <your_user_name>
   

   Copy

   条件:

   • <your_org_name>-<your_open_catalogaccount_name> は、ハイフンで区切られた組織名とSnowflake Open Catalogアカウント名です。

     例: ABCDEFG-MYACCOUNT1。

     この形式でこれらの値を取得するには、組織名とアカウント名を取得するをご参照ください。

   • <account-identifier> is the account identifier for your Snowflake Open Catalog account. To retrieve it, refer to your Open Catalog account URL. For example, abc12345in https://app.snowflake.com/us-west-2/abc12345/#/。

   • <your_user_name> は、Open Catalogのユーザー名です。

2. 暗号化した場合は、パスキーを入力するか、Enterを選択して続行してください。JWT を受け取るまでに数秒かかる場合があります。

サービス管理者のアクセストークンを生成する¶

このセクションでは、プログラムでキーペア認証を構成するために使用するサービス管理者のアクセストークンを生成します。

1. サービス管理者のアクセストークンを生成するには、以下のコマンドを実行し、値をテキストエディターにコピーします。

   curl -i -X POST \
   -H "Content-Type: application/x-www-form-urlencoded" \
   -H "Accept: application/json" \
   --data-urlencode "scope=session:role:POLARIS_ACCOUNT_ADMIN" \
   --data-urlencode "grant_type=client_credentials" \
   --data-urlencode "client_secret=<your_JWT>" \
   "https://<your_org_name>-<your_open_catalogaccount_name>.snowflakecomputing.com/polaris/api/catalog/v1/oauth/tokens"
   

   Copy

   条件:

   • POLARIS_ACCOUNT_ADMIN は、Open Catalogの組み込みロールの名前であり、Open Catalogでキーペア認証の構成を含む管理タスクを実行できます。Open Catalog UI では、このロールはサービス管理者ロールと呼ばれます。

   • <your_JWT> は、前のステップで生成した JWT です。

   • <your_org_name>-<your_open_catalogaccount_name> は、ハイフンで区切られた組織名とSnowflake Open Catalogアカウント名です。

     例: ABCDEFG-MYACCOUNT1。

     この形式でこれらの値を取得するには、組織名とアカウント名を取得するをご参照ください。

カタログ管理者権限を持つカタログロールをカスタムロールに付与する¶

このセクションでは、カタログ管理者権限を持つカタログロールをカスタムロールに付与します。ワークフローは次のとおりです。

1. カタログロールを作成する。

2. カタログ管理者権限をカタログロールに付与する。

3. カタログロールをカスタムロールに付与する。

指定した権限セットを持つカタログロールをカスタムロールに付与する¶

ワークフローは次のとおりです。

1. カタログロールを作成する。

2. カタログロールに権限を付与する。これらの権限により、ユーザーはOpen Catalogでアクションを実行できます。

3. カタログロールをカスタムロールに付与する。

秘密キーとパブリックキーを生成する¶

このセクションでは、秘密キーとパブリックキーを生成する方法について説明します。

秘密キーを生成するには、次のコマンドを使用します。

openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

パブリックキーを生成するには、次のコマンドを使用します。

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub

ユーザーに公開キーを割り当てる¶

Snowflake CLI 接続を使用して、作成したユーザーにパブリックキーを割り当てます。

1. 作成したユーザーにパブリックキーを割り当てるには、以下を実行します。

   snow sql -q "alter user <username> set RSA_PUBLIC_KEY='<your_public_key>';"
   

   Copy

   注釈

   パブリックキーを取得する必要がある場合は、以下を実行します。 cat rsa_key.pub。

2. ユーザーのパブリックキー（RSA_PUBLIC_KEY）が設定され、ユーザーの RSA パブリックキー（RSA_PUBLIC_KEY_FP）のフィンガープリントが設定されていることを検証します。

   snow sql -q "desc user keypairuser1;"
   

   Copy

ユーザーの JWT を生成する¶

このステップでは、アクセストークンを生成するために必要な JWT を生成します。

1. SnowSQL を使用して JWT を生成するには、以下を実行します。

   snowsql --private-key-path rsa_key.p8 --generate-jwt -h <your_org_name>-<your_open_catalogaccount_name>.snowflakecomputing.com -a <account-identifier> -u <user_name>
   

   Copy

   条件:

   • <your_org_name>-<your_open_catalogaccount_name> は、ハイフンで区切られた組織名とSnowflake Open Catalogアカウント名です。

     例: ABCDEFG-MYACCOUNT1。

     この形式でこれらの値を取得するには、組織名とアカウント名を取得するをご参照ください。

   • <account-identifier> is the account identifier for your Snowflake Open Catalog account. To retrieve it, refer to your Open Catalog account URL. For example, abc12345in https://app.snowflake.com/us-west-2/abc12345/#/。

   • <user_name> は、ユーザーにパブリックキーが割り当てられたOpen Catalogユーザーのユーザー名です。

2. 暗号化した場合は、パスキーを入力するか、Enterを選択して続行してください。JWT を受け取るまでに数秒かかる場合があります。

ユーザーのアクセストークンを生成する¶

1. JWT を使用してカスタムまたは組み込みロールのアクセストークンを取得するには、以下を実行します。

   curl -i -X POST \
   -H "Content-Type: application/x-www-form-urlencoded" \
   -H "Accept: application/json" \
   --data-urlencode "scope=session:role:<custom_role_name>" \
   --data-urlencode "grant_type=client_credentials" \
   --data-urlencode "client_secret=<your_JWT>" \
   "https://<your_org_name>-<your_open_catalogaccount_name>.snowflakecomputing.com/polaris/api/catalog/v1/oauth/tokens"
   

   Copy

   条件

   • <custom_role_name> is the name of A custom role you created, such as ENGINEER。

   • <your_JWT> は、前のステップで生成した JWT です。

   • <your_org_name>-<your_open_catalogaccount_name> は、ハイフンで区切られた組織名とSnowflake Open Catalogアカウント名です。

     例: ABCDEFG-MYACCOUNT1。

     この形式でこれらの値を取得するには、組織名とアカウント名を取得するをご参照ください。

2. アクセストークンを変数（$ACCESS_TOKEN）に保存します。