O que são credenciais nomeadas?
Usando chamadas HTTP com Apex, você pode integrar o Salesforce a sistemas externos por meio de APIs SOAP e REST. As credenciais nomeadas oferecem uma maneira declarativa e segura de armazenar e gerenciar as credenciais necessárias para chamadas HTTP para que o Salesforce possa se autenticar com APIs externas.
Edições obrigatórias
| Disponível em: Salesforce Classic (não disponível em todas as organizações) e Lightning Experience |
| Disponível em: todas as edições |
Uma credencial nomeada especifica o URL de um ponto final de chamada e os parâmetros de autenticação necessários em uma definição. Para simplificar a configuração das chamadas autenticadas, você pode especificar uma credencial nomeada como o ponto de extremidade de chamada. Com a separação da autenticação e URL de ponto de extremidade da definição de chamada, as credenciais nomeadas facilitam a manutenção de chamadas. Por exemplo, se um URL de ponto final for alterado, você atualizará apenas a credencial nomeada em vez de atualizar seu Apex code. Todas as chamadas que referenciam a credencial nomeada continuarão funcionando.
Há suporte para credenciais nomeadas nestes tipos de definições de chamada.
- Chamadas do Apex
- Origens de dados externas
- Serviços externos
O Salesforce gerencia toda a autenticação de chamadas que especificam uma credencial nomeada como ponto de extremidade de chamada. Você também pode ignorar as configurações de site remoto, que geralmente são necessárias para chamadas de sites externos, para o site definido na credencial nomeada.
Para atender aos requisitos do sistema externo, as credenciais nomeadas oferecem suporte a vários protocolos de autenticação, e você pode configurar cada credencial nomeada para usar uma entidade de segurança nomeada para toda a organização ou autenticação por usuário. Uma entidade de segurança nomeada aplica a mesma configuração de credencial ou autenticação a toda a organização, enquanto a autenticação por usuário permite controlar ou acesso no nível de usuários individuais.
Se tiver várias organizações, você poderá criar uma credencial nomeada com o mesmo nome, mas com um URL de ponto final diferente em cada organização. Então você poderá empacotar e implementar uma definição de chamada em todas as organizações que referencie o nome compartilhado dessas credenciais nomeadas. Por exemplo, a credencial nomeada em cada organização pode ter um URL de ponto final diferente para acomodar as diferenças em ambientes de desenvolvimento e de produção. Se uma chamada de Apex especifica o nome compartilhado dessas credenciais nomeadas, a classe do Apex que define a chamada poderá ser empacotada e implantada em todas as organizações sem verificar programaticamente o ambiente.
Recomendamos criar credenciais nomeadas e externas por meio da interface de usuário do Salesforce. Você também pode criar credenciais usando a API de metadados, a API do conjunto de ferramentas e a API REST do Connect.
