# Salesforce
<a name="identity-idp-salesforce"></a>

Salesforce 可以設定為用於傳出資源存取的 AgentCore Identity 登入資料提供者。這可讓您的客服人員透過 Salesforce 的 OAuth2 服務驗證使用者，並取得 Salesforce API 資源的存取權杖。

## 傳出
<a name="identity-idp-salesforce-outbound"></a>

**注意**  
AgentCore Identity 會為您建立的每個登入資料提供者發出唯一的 OAuth2 回呼 URL。唯一的回呼 URL 可啟用工作階段繫結，透過確保授權回應只能針對啟動它的特定憑證提供者進行兌換，以保護 OAuth2 授權碼交換免受跨供應商重播和 CSRF 型攻擊。由於每個提供者的 URL 都是唯一的，因此在呼叫 **之前**，您都不會知道它`CreateOauth2CredentialProvider`。首先建立您的 Salesforce OAuth2 用戶端，然後返回 Salesforce 開發人員主控台，在 AgentCore Identity 發出回呼 URL 後註冊回呼 URL。

 **步驟 1：建立 Salesforce OAuth2 用戶端** 

使用下列程序來設定 Salesforce OAuth2 應用程式，並取得 AgentCore Identity 的必要用戶端憑證。在 AgentCore Identity 發出唯一的回呼 URL 之後，您將在步驟 3 中註冊重新導向 URI。

 **設定 Salesforce OAuth2 應用程式** 

1. 在 Salesforce 的開發人員入口網站中，建立連線的應用程式，並輸入應用程式的名稱和其他請求的資訊。

1. 啟用和設定應用程式的 OAuth 設定。現在將回呼 URL 欄位保留空白 — 您將在步驟 3 中新增唯一的回呼 URL。

1. 選擇應用程式所需的必要範圍和許可。

1. 針對**支援的授權流程，選擇程式碼交換 (PKCE) 延伸需要證明金鑰**。

1. 選擇 **Web 伺服器流程需要秘密**。

1. 選擇**啟用授權碼和登入資料流程**。

1. 如果您想要使用 Salesforce 做為 ClientCredentials/M2M 供應商，請選擇**啟用用戶端登入資料流程**，然後依照提示操作。

1. 儲存您的應用程式，並複製為應用程式發出的用戶端 ID 和用戶端秘密。您需要這些項目才能在 AgentCore Identity 中設定 Salesforce。

如需詳細資訊，請參閱 Salesforce 文件[定義 OpenID Connect 供應商](https://help.salesforce.com/s/articleView?id=xcloud.service_provider_define_oid.htm)。

 **步驟 2：建立 AgentCore Identity 登入資料提供者** 

若要設定傳出 Salesforce 資源提供者，請使用下列項目：

```
{
        "name": "NAME",
        "credentialProviderVendor": "SalesforceOauth2",
        "oauth2ProviderConfigInput": {
            "SalesforceOauth2ProviderConfigInput": {
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
            }
        },
    }
```

[CreateOauth2CredentialProvider](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_CreateOauth2CredentialProvider.html) 回應包含 `callbackUrl` 欄位。此 URL 對此登入資料提供者是唯一的，如下所示：`https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`。儲存此值以供下一個步驟使用。

 **步驟 3：向 Salesforce 註冊唯一的回呼 URL** 

返回 Salesforce 開發人員主控台，並將唯一的回呼 URL 新增至 OAuth2 應用程式的重新導向 URI 清單。

1. 登入 Salesforce 開發人員主控台，並開啟您在步驟 1 中建立的 OAuth2 應用程式。

1. 將 傳回`callbackUrl`的值`CreateOauth2CredentialProvider`新增至應用程式的重新導向 URI 組態。

1. 儲存您的變更。