View a markdown version of this page

Salesforce 用戶端秘密 - AWS Secrets Manager
秘密值欄位秘密中繼資料欄位用量流程

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Salesforce 用戶端秘密

秘密值欄位

以下是必須包含在 Secrets Manager 秘密中的欄位：

{
  "consumerKey": "client ID", 
  "consumerSecret": "client secret", 
  "baseUri": "https://domain.my.salesforce.com", 
  "appId": "app ID", 
  "consumerId": "consumer ID"
}
consumerKey

取用者金鑰也稱為用戶端 ID，是 OAuth 2.0 憑證的憑證識別符。您可以直接從 Salesforce 外部用戶端 App Manager OAuth 設定擷取取用者金鑰。

consumerSecret

取用者秘密也稱為用戶端秘密，是與取用者金鑰搭配使用的私有密碼，用於使用 OAuth 2.0 用戶端登入資料流程進行驗證。您可以直接從 Salesforce 外部用戶端 App Manager OAuth 設定擷取取用者秘密。

baseUri

基本 URI 是您 Salesforce Org 用來與 Salesforce APIs互動的基本 URL。這採用以下範例的形式：https://domainName.my.salesforce.com。

appId

應用程式 ID 是 Salesforce 外部用戶端應用程式 (ECA) 的識別符。您可以呼叫 Salesforce OAuth 用量端點來擷取此項目。它必須以 開頭0x，且只包含英數字元。此欄位是指 Salesforce 輪換指南中的 external_client_app_identifier。

consumerId

取用者 ID 是 Salesforce 外部用戶端應用程式 (ECA) 取用者的識別符。您可以呼叫 Salesforce OAuth Credentials by App ID 端點來擷取此項目。此欄位是指 Salesforce 輪換指南中的 consumer_id。

秘密中繼資料欄位

以下是輪換 Salesforce 所持有秘密所需的中繼資料欄位。

{
  "apiVersion": "v65.0",
  "adminSecretArn": "arn:aws:secretsmanager:us-east-1:111122223333:secret:SalesforceClientSecret"
}
apiVersion

Salesforce API 版本是您 Salesforce 組織的 API 版本。版本應至少為 v65.0。其格式必須是 ，vXX.X其中 X 是數值字元。

adminSecretArn

（選用） 管理員秘密 ARN 是秘密的 Amazon Resource Name (ARN)，其中包含用來輪換此 Salesforce 用戶端秘密的管理 OAuth 登入資料。管理員秘密至少應在秘密結構中包含 consumerKey 和 consumerSecret 值。這是一個選用欄位，如果省略，在輪換期間 Secrets Manager 將使用此秘密中的 OAuth 登入資料來驗證 Salesforce。

用量流程

使用 時 AWS Secrets Manager，您可以使用相同秘密中的登入資料來輪換 Salesforce 秘密，或使用管理員秘密中的登入資料來進行輪換。您可以使用 CreateSecret 呼叫來建立秘密，其秘密值包含上述欄位，並將秘密類型作為 SalesforceClientSecret。您可以使用 RotateSecret 呼叫來設定輪換組態。此呼叫需要中繼資料欄位的規格，如上述範例所示 - 如果您選擇使用相同秘密中的登入資料進行輪換，您可以略過 adminSecretArn 欄位。此外，客戶必須在 RotateSecret 呼叫中提供角色 ARN，授予服務輪換秘密所需的許可。如需許可政策的範例，請參閱 安全與許可。

若要使用儲存在 Admin Secret 中的另一組登入資料來輪換秘密， AWS Secrets Manager 請遵循與消費者秘密相同的步驟，在 中建立 Admin Secret。您必須針對您的消費者秘密，在 RotateSecret 呼叫中的輪換中繼資料中提供此 Admin Secret 的 ARN。

輪換邏輯遵循 Salesforce 提供的指引。