As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Segredo do cliente Salesforce
Campos de valor secreto
A seguir estão os campos que devem estar contidos no segredo do Secrets Manager:
{
"consumerKey": "client ID",
"consumerSecret": "client secret",
"baseUri": "https://domain.my.salesforce.com",
"appId": "app ID",
"consumerId": "consumer ID"
}- consumerKey
-
A chave do consumidor, também conhecida como ID do cliente, é o identificador de credencial das credenciais do OAuth 2.0. Você pode recuperar a chave do consumidor diretamente das configurações OAuth do Salesforce External Client App Manager.
- consumerSecret
-
O segredo do consumidor, também conhecido como segredo do cliente, é a senha privada usada com a chave do consumidor para autenticar usando o fluxo de credenciais do cliente OAuth 2.0. Você pode recuperar o segredo do consumidor diretamente das configurações OAuth do Salesforce External Client App Manager.
- baseUri
-
O URI base é o URL base da sua organização Salesforce usado para interagir com as APIs do Salesforce. Isso assume a forma do seguinte exemplo:
https://.domainName.my.salesforce.com - appId
-
O ID do aplicativo é o identificador do seu aplicativo cliente externo Salesforce (ECA). Você pode recuperar isso chamando o endpoint de uso do Salesforce OAuth. Ele deve começar com
0xe conter somente caracteres alfanuméricos. Esse campo se refere ao external_client_app_identifier no guia de rotação do Salesforce. - ID do consumidor
-
O ID do consumidor é o identificador do seu consumidor do Salesforce External Client Application (ECA). Você pode recuperar isso chamando o endpoint Salesforce OAuth Credentials by App ID. Esse campo se refere ao consumer_id no guia de rotação do Salesforce
.
Campos de metadados secretos
A seguir estão os campos de metadados necessários para alternar um segredo mantido pela Salesforce.
{ "apiVersion": "v65.0", "adminSecretArn": "arn:aws:secretsmanager:us-east-1:111122223333:secret:SalesforceClientSecret" }
- apiVersion
-
A versão da API do Salesforce é a versão da API da sua organização do Salesforce. A versão deve ser pelo menos v65.0. Ele deve estar no formato em
vXX.XX - administrador SecretArn
-
(Opcional) O ARN secreto do administrador é o Amazon Resource Name (ARN) do segredo que contém as credenciais administrativas do OAuth que serão usadas para alternar esse segredo do cliente Salesforce. No mínimo, o segredo do administrador deve conter um valor ConsumerKey e ConsumerSecret dentro da estrutura secreta. É um campo opcional e, se omitido, durante a rotação, o Secrets Manager usará as credenciais do OAuth dentro desse segredo para se autenticar com o Salesforce.
Fluxo de uso
Com AWS Secrets Manager, você pode alternar um segredo do Salesforce usando as credenciais no mesmo segredo ou usar as credenciais no segredo do administrador para rotação. Você pode criar seu segredo usando a CreateSecretchamada com o valor secreto contendo os campos mencionados acima e o tipo de segredo como SalesforceClientSecret. As configurações de rotação podem ser definidas usando uma RotateSecretchamada. Essa chamada requer a especificação dos campos de metadados, como no exemplo acima. Se você optar por uma rotação usando credenciais no mesmo segredo, poderá pular o campo admin. SecretArn Além disso, os clientes devem fornecer um ARN de função na RotateSecretchamada que conceda ao serviço as permissões necessárias para alternar o segredo. Para ver um exemplo de política de permissões, consulte Segurança e permissões.
Para alternar seus segredos usando um conjunto separado de credenciais armazenadas em um segredo administrativo, crie o segredo administrativo AWS Secrets Manager seguindo as mesmas etapas do segredo do consumidor. Você deve fornecer o ARN desse segredo administrativo nos metadados de rotação em uma RotateSecretchamada para seu segredo de consumidor.
A lógica de rotação segue a orientação fornecida pela Salesforce.
