Salesforce 組織への外部検索サービスの接続

認証済みコールアウト設定を作成し、Salesforce 組織の有効な AWS 検索プロバイダーを特定します。

必要なユーザー権限
指定ログイン情報とカスタム設定を作成する	「アプリケーションのカスタマイズ」

開始する前に、ゲートウェイ API の呼び出し URL と操作パスを記録します。

指定ログイン情報の作成

指定ログイン情報を定義することで、Amazon S3 バケットへの認証済み API コールアウトを保護し、簡素化します。認証済みコールアウトの設定を簡略化するには、外部ログイン情報を作成して認証プロトコルを指定し、指定ログイン情報をコールアウトエンドポイントとして指定します。

外部ログイン情報とプリンシパルを作成して、AWS 署名 v4 プロトコルを使用して Salesforce が HTTP 経由で Amazon Web Services のリソースへのコールアウトを認証する方法の詳細を指定します。
セキュリティを強化するために、STS を使用することをお勧めします。「AWS 署名 v4 の外部ログイン情報の作成または編集」を参照してください。
指定ログイン情報を定義して、コールアウトエンドポイントの URL を指定します。

URL の形式が https://{api-id}.execute-api.{region}.amazonaws.com/{stage-name} であることを確認します。

たとえば、https://a1b2c3d4e5.execute-api.us-west-2.amazonaws.com/prod です。「指定ログイン情報の作成」を参照してください。

メモ Salesforce の指定ログイン情報でエンドポイントを設定する場合、ホストに :443 を含めないでください。ポートを含めると、AWS 署名バージョン 4 ホストの不一致と 403 SignatureDoesNotMatch 応答が発生します。
プリンシパルを使用して外部ログイン情報を権限セットまたはユーザープロファイルにリンクし、ユーザーが指定ログイン情報を使用してコールアウトを実行できるようにします。
「外部ログイン情報プリンシパルの有効化」を参照してください。

[設定] から、[クイック検索] ボックスに「カスタム設定」と入力し、[カスタム設定] を選択します。
[新規] をクリックします。
次の値を使用してカスタム設定を作成します。
- 表示ラベル: External Search Config
- オブジェクト名: ExternalSearchConfig
- 実装に必要なカスタム設定種別を選択します。
カスタム設定を保存します。

次の項目を作成します。

項目	型	説明
NamedCredentialName	テキスト	指定ログイン情報の開発者名
OperationPath	テキスト	指定ログイン情報 URL に追加されたゲートウェイ API 操作パス。例: ゲートウェイ API エンドポイントが「https://a1b2c3d4e5.execute-api.us-west-2.amazonaws.com/prod/performsearch」の場合、OperationPath は「performsearch」です。
SearchProvider	テキスト	検索プロバイダー識別子:bedrock または kendra。重要: 必ずここで指定した値を指定してください。
TimeoutSeconds	テキスト	ゲートウェイ API コールアウトの最大許容時間
IsActive	Checkbox	Salesforce がこの設定を使用するかどうかを示します。一度に有効にできる設定は 1 つのみです。

外部ストレージ検索の実装に必要な項目の表示ラベル、API 参照名、データ型を使用します。
検索サービスの ExternalSearchConfig レコードを作成し、[IsActive] を選択します。

メモ一度に 1 つの設定のみを有効にします。複数の検索が有効になっている場合、検索の動作は予測できません。
検索設定へのアクセス権をユーザーに付与します。
「Grant Users Access to Custom Settings (カスタム設定へのアクセス権をユーザーに付与)」を参照してください。

この記事で問題は解決されましたか?

ご意見をお待ちしております。