Editar o manipulador preciso do SAML
Conclua o processo do provisionamento preciso (JIT) do SAML personalizado editando a classe do manipulador de provisionamento do Apex. Você pode personalizar a maneira como o Salesforce provisiona os usuários quando eles fazem login no Salesforce pela primeira vez com o login único (SSO) do SAML.
Edições obrigatórias
| Disponível em: Salesforce Classic e Lightning Experience |
A Autenticação federada está disponível em: Todas as edições A Autenticação delegada está disponível em: Edições Professional, Enterprise, Performance, Unlimited, Developer e Database.com Os provedores de autenticação estão disponíveis em: Edições Professional, Enterprise, Performance, Unlimited e Developer |
| Permissões necessárias do usuário | |
|---|---|
| Para exibir as configurações: | Visualizar configuração |
| Para editar as configurações: | Personalizar aplicativo E Modificar todos os dados |
Antes de editar o SAML JIT personalizado com manipulador do Apex, configure o SSO do SAML com o Salesforce como provedor de serviços e habilite o provisionamento preciso com o Tipo de provisionamento do usuário Personalizar SAML JIT com manipulador Apex.
Se você tiver configurado o provisionamento preciso padrão, não será necessário editar a classe do manipulador do Apex. Teste a conexão de SSO diretamente.
Edite a classe do manipulador do Apex na Configuração do Salesforce.
- Em Configuração, use a caixa Busca rápida para localizar e selecionar Classes do Apex.
-
Para mapear campos entre o SAML e o Salesforce, edite o manipulador JIT SAML do Apex gerado. Além disso, é possível modificar o código gerado para oferecer suporte a estas opções.
- Campos personalizados
- Correspondência parcial de perfis
- Correspondência parcial de papéis
- Pesquisa de contatos por email
- Pesquisa de contas por número da conta
- Provisionamento de usuários padrão em um site do Experience Cloud
- Login de usuário padrão em um site do Experience Cloud
- Uso de ID de perfil padrão para o provisionamento preciso de portais
- Uso de papel de portal padrão para o provisionamento preciso de portais
- Geração de nome de usuário para o provisionamento preciso de portais
Por exemplo: para oferecer suporte a campos personalizados no código de manipulador gerado, localize o comentário “Handle custom fields here” no código gerado. Insira o código do campo personalizado depois desse comentário no código.
Você também pode personalizar o modo como seu manipulador JIT processa as declarações SAML criptografadas. Se a declaração for criptografada, o Salesforce a descriptografará e enviará para o manipulador JIT no mapa de atributos. Com acesso à declaração descriptografada, você pode escrever um código personalizado para extrair as informações de usuário necessárias.
Para obter mais informações e exemplos, consulte Documentação da Interface SamlJitHandler no Guia de referência do Apex.
Nota Se seu provedor de identidade enviar atributos JIT para o objeto Contato ou Conta na mesma declaração que o objeto Usuário, o manipulador gerado poderá não ser capaz de realizar atualizações. Para obter uma lista de campos Usuário que não podem ser atualizados ao mesmo tempo que os campos Contato ou Conta, consulte Objetos que não podem ser usados juntos em operações DML no Guia do desenvolvedor do Apex. - Salve suas alterações.
Após editar a classe do manipulador JIT SAML personalizado do Apex, teste a conexão SSO tentando acessar o aplicativo do provedor de identidade. Seu provedor de identidade direciona o navegador do usuário para PUBLICAR um formulário contendo declarações SAML para a página de login do Salesforce. Cada declaração é verificada e, caso seja bem-sucedida, o usuário poderá fazer o login com SSO.
Se você tem dificuldades em usar o SSO, use o Validador de declaração SAML.
Se seus usuários tiverem problemas com o uso de SSO, revise o histórico de login SAML para determinar o problema e compartilhar o que você descobriu com seu provedor de identidade.
Se você estiver usando o SAML versão 2.0, o campo Ponto de extremidade do token OAuth 2.0 será preenchido após você configurar SAML. Use o token com Fluxo do servidor Web do OAuth 2.0.
