Salesforce Data Cloud OAuthのセットアップ Snowflake OAuthのセットアップ

でデータソースへの接続を設定する OAuth

次のセクションでは、Canvas SageMaker からデータソースOAuthへの接続をセットアップするために必要な手順について説明します。OAuth は、パスワードを共有せずにリソースへのアクセスを許可するための一般的な認証プラットフォームです。を使用するとOAuth、Canvas からデータにすばやく接続し、インポートしてモデルを構築できます。Canvas は現在、Snowflake と Salesforce Data Cloud OAuthをサポートしています。

注記

データソースごとに確立できるOAuth接続は 1 つだけです。

Salesforce Data Cloud OAuthのセットアップ

Salesforce Data Cloud OAuth用にを設定するには、以下の一般的なステップに従います。

Salesforce Data Cloud にサインインします。
Salesforce Data Cloud で、新しいアプリ接続を作成して、次の操作を行います。
1. OAuth 設定を有効にします。
2. コールバック URL (またはデータにアクセスするリソースURLの ) を求められたら、Canvas URL アプリケーションのを指定します。Canvas アプリケーションは次の形式URLに従います。 https://<domain-id>.studio.<region>.sagemaker.aws/canvas/default
3. コンシューマーキーとシークレットをコピーします。
4. 認証URLとトークンをコピーしますURL。

Salesforce Data Cloud で上記タスクを実行する方法の詳細については、Salesforce Data Cloud からのデータのインポートに関する Data Wrangler のドキュメントの「Salesforce データクラウドからデータをインポートする」を参照してください。

Salesforce Data Cloud からのアクセスを有効にして接続情報を取得したら、シーAWS Secrets Managerクレットを作成して情報を保存し、Amazon SageMaker ドメインまたはユーザープロファイルに追加する必要があります。ドメインとユーザープロファイルの両方にシークレットを追加できますが、Canvas はまずユーザープロファイルでシークレットを検索することに注意してください。

ドメインまたはユーザープロファイルにシークレットを追加するには、次の手順を実行します。

Amazon SageMaker コンソールに移動します。
ナビゲーションペインでドメインを選択します。
ドメイン のリストからドメインを選択します。
1. シークレットをドメインに追加する場合は、次の操作を行います。
  1. ドメインを選択します。
  2. ドメイン設定ページで、ドメイン設定タブを選択します。
  3. [編集] を選択します。
2. ユーザープロファイルにシークレットを追加するには、次の手順に従います。
  1. ユーザーのドメインを選択します。
  2. ドメイン設定ページで、ユーザープロファイルを選択します。
  3. [ユーザーの詳細] ページで、[編集] を選択します。
ナビゲーションペインで、[Canvas の設定] を選択します。
OAuth 設定 で、OAuth設定の追加 を選択します。
[データソース] で、[Salesforce Data Cloud] を選択します。
[シークレット設定] で、[新しいシークレットを作成] を選択します。または、認証情報を使用して AWS Secrets Manager シークレットを既に作成している場合は、シークレットARNのを入力します。新しいシークレットを作成するには、次の手順に従います。
1. ID プロバイダーで、を選択しますSALESFORCE。
2. クライアント ID 、クライアントシークレット 、認証 URL、トークン にはURL、前の手順で Salesforce Data Cloud から収集したすべての情報を入力します。
ドメインまたはユーザープロファイルの設定を保存します。

これで、Canvas から Salesforce Data Cloud のデータへの接続を作成できました。

Snowflake OAuthのセットアップ

Snowflake の認証を設定するために、Canvas はユーザーが Canvas に認証情報を直接入力する代わりに使用できる ID プロバイダーをサポートしています。

Canvas がサポートする ID プロバイダーに関する Snowflake ドキュメントへのリンクは次のとおりです。

一般的な手順を以下に示します。これらの手順を実行する方法の詳細については、Snowflake からのデータのインポートに関する Data Wrangler のドキュメントの「Snowflake OAuth アクセスのセットアップ」セクションを参照してください。

Snowflake OAuth用にを設定するには、次の手順を実行します。

ID プロバイダーを含むアプリケーションとして Canvas を登録します。そのためには、Canvas URLへのリダイレクトを指定する必要があります。これは次の形式に従う必要があります。 https://<domain-id>.studio.<region>.sagemaker.aws/canvas/default
ID プロバイダー内で、Canvas APIが Snowflake にアクセスできるように、Canvas にOAuthトークンを送信するサーバーまたはを作成します。サーバーをセットアップする際は、認証コードと更新トークンの付与タイプを使用し、アクセストークンの有効期間を指定して、更新トークンポリシーを設定します。さらに、Snowflake の外部OAuthセキュリティ統合内で、を有効にしますexternal_oauth_any_role_mode。
ID プロバイダーから次の情報を取得します: トークン URL、認証 URL、クライアント ID、クライアントシークレット。Azure AD の場合は、OAuthスコープ認証情報も取得します。
前のステップで取得した情報を AWS Secrets Manager シークレットに保存します。
1. Okta と Ping Federate では、シークレットの形式は次のようになります。
```
{"token_url":"https://identityprovider.com/oauth2/example-portion-of-URL-path/v2/token",
"client_id":"example-client-id", "client_secret":"example-client-secret", "identity_provider":"OKTA"|"PING_FEDERATE",
"authorization_url":"https://identityprovider.com/oauth2/example-portion-of-URL-path/v2/authorize"}
```
2. Azure AD の場合、シークレットにはOAuthスコープ認証情報を datasource_oauth_scopeフィールドとして含める必要があります。

ID プロバイダーとシークレットを設定したら、シーAWS Secrets Managerクレットを作成して情報を保存し、Amazon SageMaker ドメインまたはユーザープロファイルに追加する必要があります。ドメインとユーザープロファイルの両方にシークレットを追加できますが、Canvas はまずユーザープロファイルでシークレットを検索することに注意してください。

ドメインまたはユーザープロファイルにシークレットを追加するには、次の手順を実行します。

Amazon SageMaker コンソールに移動します。
ナビゲーションペインでドメインを選択します。
ドメイン のリストから、ドメインを選択します。
1. シークレットをドメインに追加する場合は、次の操作を行います。
  1. ドメインを選択します。
  2. ドメイン設定ページで、ドメイン設定タブを選択します。
  3. [編集] を選択します。
2. ユーザープロファイルにシークレットを追加するには、次の手順に従います。
  1. ユーザーのドメインを選択します。
  2. ドメイン設定ページで、ユーザープロファイルを選択します。
  3. [ユーザーの詳細] ページで、[編集] を選択します。
ナビゲーションペインで、[Canvas の設定] を選択します。
OAuth 設定 で、OAuth設定の追加 を選択します。
[データソース] で、[Snowflake] を選択します。
[シークレット設定] で、[新しいシークレットを作成] を選択します。または、認証情報を使用して AWS Secrets Manager シークレットを既に作成している場合は、シークレットARNのを入力します。新しいシークレットを作成するには、次の手順に従います。
1. ID プロバイダーで、を選択しますSNOWFLAKE。
2. クライアント ID 、クライアントシークレット 、認証 URL 、トークンにはURL、前の手順で ID プロバイダーから収集したすべての情報を入力します。
ドメインまたはユーザープロファイルの設定を保存します。

これで、Canvas から Snowflake のデータへの接続を作成できました。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

インターネットにアクセスVPCせずにで Amazon SageMaker Canvas を設定する

Canvas にデータをインポートする