Configurar KeyCloak para uso com Adobe SSO

Última atualização em 2 de nov de 2026

Configure o KeyCloak como um provedor de identidade (IdP) SAML para que os usuários possam fazer logon nos aplicativos e serviços da Adobe com as credenciais da organização.

Antes de começar

Certifique-se de ter:

  • Função Administrador de sistema no Adobe Admin Console
  • Acesso de administrador ao realm do KeyCloak que autentica os usuários da Adobe
  • Um domínio que você pode verificar e adicionar ao diretório
Dica

Verifique se o endereço de email de cada usuário pertence a um domínio reivindicado no Admin Console. O KeyCloak usa o endereço de email como identificador do usuário.

Criar um diretório e baixar os metadados da Adobe.

Faça logon no Admin Console e navegue até Configurações > Identidade > Diretórios e selecione Criar Diretório.

Insira um nome de diretório, selecione Federated ID e escolha Próximo.

Selecione Outros provedores de SAML e Próximo.

Na tela Configurar IdP, selecione Baixar arquivo de metadados da Adobe. Mantenha essa tela aberta para a próxima etapa.

Importar o cliente Adobe para o KeyCloak.

Faça logon no Admin Console do KeyCloak e selecione o realm que autentica os usuários da Adobe.

Selecione Clientes > Importar cliente.

Em Arquivo de recurso, selecione Explorar e faça upload do arquivo de metadados da Adobe.O KeyCloak preenche o ID da entidade, a URL do ACS, o certificado e outras configurações de SAML da Adobe a partir do arquivo.

Nota

Importe o arquivo de metadados da Adobe em vez de criar o cliente manualmente. Isso garante que o KeyCloak use as configurações exatas de SAML da Adobe.

Em Nome, insira Adobe Identity Management – <nome da organização> e, em seguida, selecione Salvar.

Verifique as configurações importadas:

  • URIs de redirecionamento válidos mostram a URL do ACS da Adobe.
  • Formato de ID de nome é email.
  • A assinatura está ativada em Assinatura e criptografia.
  • A guia Chaves mostra o certificado da Adobe.

Mapear atributos de usuário

A Adobe requer o nome, o sobrenome e o email do usuário na afirmação SAML. Criar um escopo de cliente que os envie.

No painel de navegação, selecione Escopos do cliente > Criar escopo do cliente.

Insira Adobe Identity Scope como o nome, selecione SAML como o protocolo e, em seguida, selecione Salvar.

Na guia Mapeadores, selecione Configurar um novo mapeador (ou Adicionar mapeador > Por configuração) e, em seguida, selecione Atributo do usuário.

Insira os valores do primeiro atributo na tabela a seguir. Deixe Atributo SAML NameFormat como Não especificado e Valores de atributo agregado como desativado e, em seguida, selecione Salvar.

Insira atributos do usuário
Insira atributos do usuário.

Repita as etapas 3 e 4 para cada atributo na tabela.

 

Nota

CountryCode não é um atributo integrado do Keycloak.Para enviá-lo, primeiro adicione um atributo de usuário personalizado em Configurações de domínio > Perfil de usuário que armazene um código de país de duas letras no padrão ISO 3166-1.

Selecione Clientes, o cliente Adobe e, em seguida, selecione a guia Escopos do cliente.

Selecione Adicionar escopo de cliente, selecione Adobe Identity Scope e, em seguida, selecione Adicionar > Padrão.

Faça upload dos metadados da KeyCloak para o Admin Console

No KeyCloak, navegue até Configurações de domínio > Geral > Pontos de acesso e selecione Metadados de provedor de identidade SAML 2.0.

Salve o XML aberto como um arquivo, por exemplo, keycloak-idp-metadata.xml.

Volte para a tela Configurar IdP no Adobe Admin Console, faça upload do arquivo de metadados do KeyCloak e selecione Próximo.

Deixe a criação automática de conta ativada. Se a organização provisionar usuários manualmente, desative essa configuração.

Em Mapeamentos de atributo, selecione um país padrão e, em seguida, selecione Concluído.

Em seguida, verifique a propriedade do domínio e adicione o domínio ao diretório, caso ainda não tenha feito isso.

Testar o Single Sign-On

No Admin Console, navegue até Configurações > Identidade > Diretórios e selecione o diretório.

No painel de detalhes do diretório, selecione Teste.

Faça logon como um usuário do KeyCloak. Confirme que a página Validação de IdP bem-sucedida lista os valores esperados de cada atributo.

Página de validação de IdP bem-sucedida no Admin Console.
Confirmar o sucesso da validação do IdP.

Se um atributo estiver faltando, verifique o seu mapeador e confirme se o Escopo de identidade da Adobe é um escopo padrão no cliente da Adobe. Para outros problemas, consulte Resolver erros de logon do Federated ID (SSO) ou execute um rastreamento SAML. Para obter ajuda com a configuração, acesse Admin Console > Suporte e contate o Atendimento ao cliente da Adobe.