認証の準備

Snowflake用のセキュリティ統合の作成

1. 1Snowflakeにログインします。
2. 2［ワークシート］タブから、ユーザー名とウェアハウス名をコピーします。
注:
接続を作成する際に必要となるため、これらの情報を手元に控えておいてください。
3. 3操作するデータベースとスキーマを選択します。
4. 4アクセスするリソース名を選択します。
5. 5Snowflakeコンソールで、［ACCOUNTADMIN］ロールを選択し、セキュリティ統合コマンドを実行します。
6. 6プロンプトが表示されるので、次の詳細を入力します。
• - セキュリティ統合の名前
• - OAuthアプリケーションを登録した際に指定したOAuthリダイレクトURI
• - Snowflakeの事前承認済みユーザーロール（SYSADMINやPUBLICなど）は、認証後に明示的に同意する必要がありません。
例:
Create security integration oauth_int_ac
type = oauth
enabled = true
oauth_client = custom
oauth_client_type = 'CONFIDENTIAL'
oauth_redirect_uri = 'https://<Informatica cloud hosting facility for your organization>/ma/proxy/oauthcallback'
oauth_issue_refresh_token = true
pre_authorized_roles_list = ('SYSADMIN','PUBLIC')
7. 7変更を適用するためにセキュリティ統合コマンドを再実行します。
Snowflakeコンソールでセキュリティ統合が作成されます。

Okta用のセキュリティ統合の作成

1. 1Oktaアカウントを作成します。
注:
Snowflakeアカウント名とOktaアカウント名が同じであることを確認してください。
2. 2AdminコンソールからOktaでアプリケーションを登録します。
Oktaへのアプリケーションの登録に関する詳細については、Oktaのマニュアルの「Set up your application」を参照してください。
3. 3Oktaで認証サーバーを作成します。
Okta認証サーバーの作成に関する詳細については、Snowflakeのマニュアルの「Create an OAuth authorization server」を参照してください。
4. 4Oktaの認証情報を取得します。
注:
SnowflakeでOkta用のセキュリティ統合を作成する際に必要となるため、これらの詳細情報を手元に控えておいてください。
5. 5Snowflakeで管理者としてログインします。
6. 6SnowflakeでOkta用のセキュリティ統合を作成するには、有効なパラメータ値で次のコマンドを実行します。
create security integration external_oauth_okta_2
type = external_oauth
enabled = true
external_oauth_type = okta
external_oauth_issuer = '<Okta_Issuer>'
external_oauth_jws_keys_url = '<Okta_JWS_Key_Endpoint>'
external_oauth_audience_list = ('<Snowflake_audience>')
external_oauth_token_user_mapping_claim = 'sub'
external_oauth_snowflake_user_mapping_attribute = 'login_name';

Microsoft Entra ID用のセキュリティ統合の作成

1. 1Microsoft Entra IDでSnowflakeをOAuthリソースとして設定します。
注:
OAuth認証中にアプリケーションが要求する必要のある権限を定義するスコープを追加します。
2. 2Microsoft Entra IDでOAuthクライアントを作成し、API権限を［委任権限］に設定します。
3. 3Microsoft Entra ID認証の詳細を取得します。
注:
SnowflakeでMicrosoft Entra ID用のセキュリティ統合を作成する際に必要となるため、これらの詳細情報を手元に控えておいてください。
4. 4Snowflakeで管理者としてログインします。
5. 5Microsoft Entra ID用のセキュリティ統合を作成するには、有効なパラメータ値で次のコマンドを実行します。
create security integration external_oauth_azure_2
type = external_oauth
enabled = true
external_oauth_type = azure
external_oauth_issuer = '<Microsoft Entra ID_Issuer>'
external_oauth_jws_keys_url = '<Microsoft Entra ID_JWS_Key_Endpoint>'
external_oauth_audience_list = ('<Snowflake application ID URI>')
external_oauth_token_user_mapping_claim = 'upn'
external_oauth_snowflake_user_mapping_attribute = 'login_name';

パブリックキーとプライベートキーの生成

1. 1Open SSLコマンドラインから、プライベートキーを生成します。
• - 復号化されたプライベートキーを生成するには、次のコマンドを実行し、表示されたプロンプトに従ってパスフレーズを入力します。
$ openssl genrsa 2048 | openssl pkcs8 -topk8 -<cryptographic algorithm> -inform PEM -out rsa_key.p8 -nocrypt
• - 暗号化されているプライベートキーを生成するには、次のコマンドを実行し、表示されたプロンプトに従ってパスフレーズを入力します。
$ openssl genrsa 2048 | openssl pkcs8 -topk8 -<cryptographic algorithm> -inform PEM -out rsa_key.p8
注:
Snowflakeのマニュアルを参照して、コマンドで推奨される暗号化アルゴリズムを使用してプライベートキーを生成します。
パスフレーズは、Snowflakeへの接続中に、プライベートキーファイルを暗号化するために使用されます。
2. 2パブリックキーを生成します。次のコマンドを実行し、ファイルにあるrsa_key.p8などの暗号化されたプライベートキーを指定します:
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub
3. 3Secure Agentがアクセスできるディレクトリにパブリックおよびプライベートキーファイルをコピーします。
例: C:\Program Files\Informatica Cloud Secure Agent\apps\Data_Integration_Server\data\snowflake\rsa_key.p8
Snowflake接続を設定するときにパスの詳細が必要になります。
4. 4Snowflakeで、ALTER USERコマンドを使用してパブリックキーをSnowflakeユーザーに割り当てます。
alter user <user> set rsa_public_key='<content of the public key
after removing the header and footer lines>';
5. 例えば、alter user jsmith set rsa_public_key='MIIXBIjABCdef...';

詳細クラスタでのプライベートキーの設定

Spark.NeedUserCredentialFileForAdapter=true

Spark.UserCredentialDirOnDISに指定した場所のプライベートキーの内容を、Secure AgentマシンからSparkドライバおよびエグゼキュータにコピーします。資格情報ファイルを含むフォルダには、1MBの制限はありません。クラスタアプリケーションにコピーするシークレットキーコンテンツの資格情報ファイルは、1MBを超えないようにする必要があります。値をtrueに設定する必要があります。デフォルトはfalseです。

このフラグを設定していない場合、またはこのフラグをfalseに設定した場合、プライベートキーファイルはクラスタアプリケーションにコピーされず、マッピングは失敗します。

Spark.UserCredentialDirOnDIS=<プライベートキーファイルディレクトリ>

プライベートキーコンテンツをクラスタアプリケーションにコピーするために指定したディレクトリで、プライベートキーを含むデフォルトのSecure Agentディレクトリをオーバーライドします。デフォルトのディレクトリは/infa/user/credentialsです。ディレクトリにプライベートキーのファイル名が含まれていないことを確認します。

このフラグを設定しない場合は、デフォルトの場所が使用されます。デフォルトの場所を使用するには、/infa/user/credentialsディレクトリをSecure Agentマシンに作成し、そこにプライベートキーファイルをコピーします。

マッピングタスクの詳細セッションプロパティで指定した場所をオーバーライドするフラグを設定する場合、Spark.UserCredentialDirOnDISに指定したオーバーライドの場所にプライベートキーファイルが含まれていることを確認します。オーバーライドの場所とプライベートキーファイルに書き込み権限があることを確認します。

次の画像に、マッピングタスクで設定された詳細カスタムプロパティを示します。

Okta用のセキュリティ統合の作成

1. 1Oktaアカウントを作成します。
注:
Snowflakeアカウント名とOktaアカウント名が同じであることを確認してください。
2. 2AdminコンソールからOktaでアプリケーションを登録します。
Oktaへのアプリケーションの登録に関する詳細については、Oktaのマニュアルの「Set up your application」を参照してください。
3. 3Oktaで認証サーバーを作成します。
Okta認証サーバーの作成に関する詳細については、Snowflakeのマニュアルの「Create an OAuth authorization server」を参照してください。
4. 4Oktaの認証情報を取得します。
注:
SnowflakeでOkta用のセキュリティ統合を作成する際に必要となるため、これらの詳細情報を手元に控えておいてください。
5. 5Snowflakeで管理者としてログインします。
6. 6SnowflakeでOkta用のセキュリティ統合を作成するには、有効なパラメータ値で次のコマンドを実行します。
create security integration external_oauth_okta_2
type = external_oauth
enabled = true
external_oauth_type = okta
external_oauth_issuer = '<Okta_Issuer>'
external_oauth_jws_keys_url = '<Okta_JWS_key_Endpoint>'
external_oauth_audience_list = ('<Snowflake_audience>')
external_oauth_token_user_mapping_claim = 'sub'
external_oauth_snowflake_user_mapping_attribute = 'login_name';

Microsoft Entra ID用のセキュリティ統合の作成

1. 1Microsoft Entra IDでSnowflakeをOAuthリソースとして設定します。
注:
OAuth認証に必要なスコープやその他のアプリケーション設定を管理するために、マニフェストを編集します。
2. 2Microsoft Entra IDでOAuthクライアントを作成し、API権限を［アプリケーション権限］に設定します。
3. 3Microsoft Entra ID認証の詳細を取得します。
注:
SnowflakeでMicrosoft Entra ID用のセキュリティ統合を作成する際に必要となるため、これらの詳細情報を手元に控えておいてください。
4. 4Snowflakeで管理者としてログインします。
5. 5Microsoft Entra ID用のセキュリティ統合を作成するには、有効なパラメータ値で次のコマンドを実行します。
create security integration external_oauth_azure_2
type = external_oauth
enabled = true
external_oauth_type = azure
external_oauth_issuer = '<Microsoft Entra ID_Issuer>'
external_oauth_jws_keys_url = '<Microsoft Entra ID_JWS_Key_Endpoint>'
external_oauth_audience_list = ('<Snowflake application ID URI>')
external_oauth_token_user_mapping_claim = 'sub'
external_oauth_snowflake_user_mapping_attribute = 'login_name';