Configurar a Autenticação de NiCE CXone Usando o Salesforce como um Provedor de identidade Externa

Esta página orienta você na configuração da autenticação para o seu sistema NiCE CXone usando o Salesforce como seu provedor de identidade externo (IdP).

Antes de iniciar

  • Obtenha uma compreensão básica dos conceitos e terminologia de autenticação e autorização se você nunca configurou um processo como esse antes.
  • Revisar o processo específico do NiCE CXone se esta for a primeira vez que você trabalha com autenticação em NiCE CXone.
  • Considere seus usuários humanos e os níveis de acesso que eles precisam. Decida se as pessoas com maior acesso devem ter maiores níveis de segurança.
  • Decida se você usará requisitos de senha personalizados, autenticação multifator (MFA) ou ambos para aplicar.
  • Com base em suas decisões, crie uma lista de autenticadores de login. A lista deve incluir os requisitos de senha e o status de MFA que você deseja usar para cada autenticador de login.
  • Considere se você precisa incluir autenticação e autorização para aplicativos como bots ou assistentes virtuais inteligentes (IVAs). Nesse caso, você precisará criar chaves DE acesso.
  • Compreenda seu protocolo de autenticação. NiCE CXone oferece suporte a SAML 2.0 para integração de Salesforce.
  • Avalie a combinação de IdP e protocolo para garantir que seus casos de uso e fluxos de usuários sejam compatíveis e para identificar possíveis problemas. Isso deve incluir testes reais.

Sua equipe do NiCE CXone pode apoiar e orientar você neste processo de planejamento. Um bom planejamento contribui para uma implementação mais suave. A implementação de autenticação e autorização conforme as necessidades imediatas surgem é mais propensa a gerar problemas.

Complete cada uma dessas tarefas na ordem indicada.

Configurar um Aplicativo de IdP no Salesforce

A configuração de um aplicativo de IdP no Salesforce requer várias etapas. Siga estas tarefas na ordem apresentada.

Criar um Aplicativo

  1. Conecte-se no Salesforce como administrador.
  2. Crie um aplicativo.
  3. Enable Identity for your application:
    1. Vá para Configurar.
    2. No campo de localização rápida, digite Identity e selecione Provedor de identidade em Identity.
    3. Clique em Habilitar Provedor de identidade. Salesforce gera um Certificado Salesforce exclusivo para SAML. Isso é necessário para assinar as declarações SAML.
    4. Salve o certificado gerado.
  4. Enable single sign-on for your application:
    1. Em Identity, vá até Configurações de Single Sign-On.
    2. Selecione SAML Enabled em Federated Single Sign-On Using SAML.
  5. Terminar de criar o aplicativo.

Criar um Aplicativo conectado e configurar as Configurações de SAML

Na primavera de 2026, Salesforce não permitirá mais que você crie aplicativos conectados. Você poderá continuar usando os aplicativos conectados existentes, mas precisará contatar o Suporte da Salesforce para criar novos. Consulte o anúncio da Salesforce Icon of a square with an arrow pointing out from the top right corner para mais informações.

  1. Na página de gestão do seu novo aplicativo, vá até a seção Manage.
  2. Clique em Single Sign-On e selecione SAML como o método de Single Sign-On.
  3. Vá para Ferramentas da plataforma > aplicativos > aplicativos de cliente Externo > Configurações.
  4. Enable the following options:
    • Permitir acesso aos segredos do consumidor do aplicativo cliente Externo via REST API
    • Permitir a criação de apps conectados
  5. Clique em Novo Aplicativo conectado.
  6. Em Informações básicas, insira Connected App Name, API Name e Contact Email. Você pode usar o mesmo nome para o aplicativo IdP e o Aplicativo conectado. Para o e-mail de contato, use um e-mail ao qual você tenha acesso.
  7. Em Configurações do Web App, selecione Habilitar SAML.
  8. No campo ACS URL, enter um placeholder URL, como https://need_to_change. Você obterá a URL real do Serviço de Consumo de Asserção (ACS) a partir do seu autenticador de login NiCE CXone em uma etapa posterior.
  9. No campo Audience Restriction, insira outra URL de placeholder semelhante à da etapa anterior. Em uma etapa posterior, você substituirá o placeholder pelo ID da Entidade do seu autenticador de login NiCE CXone.
  10. Em Configurações do provedor de serviços SAML, selecione o Tipo de Assunto que você está usando para identificar usuários.

    Atualize o campo Name ID Format com o formato apropriado. Sua seleção aqui determina como você configura o campo External ID nos perfis de funcionário dos usuários do NiCE CXone. Você configurará isso em uma etapa posterior.

  11. Selecione o IdP Certificate que você salvou anteriormente. Para recriar o certificado, vá para Configurações > Segurança > Gestão de Certificado e Chave.
  12. Selecione o Signing Algorithm for SAML Mensagens que você deseja usar. O algoritmo recomendado é SHA-256.
  13. Clique em Salvar.

  14. Vá para Ferramentas da plataforma > aplicativos > Aplicativos conectados e clique em Gerenciar Aplicativos conectados e, em seguida, selecione seu aplicativo.
  15. Na página de gestão do aplicativo, vá até a seção Perfis e clique em Gerenciar Perfis.
  16. Selecione Standard Platform User, Standard User e System Administrator na página Atribuição de Perfil de Aplicativo.
  17. Salve suas alterações.
  18. Deixe a janela aberta. Você fará alterações em sua configuração com base nas configurações de NiCE CXone que você obterá mais adiante.

Atribuir Usuários ao Aplicativo

Depois de criar e configurar seu aplicativo de IdP, você precisa adicionar usuários. Você deve adicionar todos os usuários Salesforce que usarão Salesforce como um IdP externo para fazer login em NiCE CXone.

  1. No seu novo aplicativo, vá para Administração > Usuários > Usuários > Novo usuário.

  2. Certifique-se de que, para todos os usuários, o nome na coluna Username na página Todos os usuários em Salesforce seja o nome que você deve usar como Id externo no perfil de funcionário correspondente de cada usuário em NiCE CXone. Os nomes DE usuário devem corresponder exatamente, caso contrário, eles não poderão fazer login em NiCE CXone.

  3. Adicione usuários ao aplicativo.

Criar um Autenticador de login com SAML 2.0

Permissões necessárias: Criar Autenticador de login

  1. Clique no seletor de aplicativos icon of app selector e selecioneAdmin.
  2. Clique em Segurança > Autenticador de login.
  3. Clique em Novo Autenticador de login.
  4. Digite o Nome e a Descrição do autenticador de login. Para a descrição, use apenas texto simples. não é possível salvar URLs ou marcações como html.
  5. Selecione SAML como o Tipo de autenticação.
  6. Caso queira solicitar que os usuários efetuem o login a partir de determinado Endereço IP, selecione a Localização configurada na seção anterior.

  7. Clique em Escolher arquivo e selecione o certificado de assinatura público que você baixou de Okta na tarefa anterior. Esse certificado deve ser um arquivo PEM. Será um arquivo de texto e a primeira linha conterá BEGIN CERTIFICATE com algum texto adicional.
  8. Selecione a guia Usuários atribuídos. Selecione os usuários que você deseja atribuir ao autenticador de login que você está criando. Você também pode atribuir usuários diretamente ao autenticador de login em seu perfil de funcionário.

  9. Clique em Salvar e ativar.
  10. Abra o autenticador de login.
  11. Você notará dois campos adicionais somente leitura exibidos: o Entity ID e a URL do ACS. Anote esses valores. Você precisará deles na próxima tarefa.

Adicionar valores NiCE CXone a Salesforce

Concluir esta etapa em Salesforce.

  1. Conecte-se no Salesforce como administrador.

  2. Em Configurações do aplicativo da Web, no aplicativo conectado que você criou, cole os valores que você copiou do autenticador de login em NiCE CXone:

    • No campo ACS URL, exclua a URL do Placeholder e cole a que você copiou do campo ACS URL em seu autenticador de login NiCE CXone na tarefa anterior.
    • No campo Audience Restriction, exclua a URL de espaço reservado e cole a que você copiou do campo Entity ID no seu NiCE CXone autenticador de login na tarefa anterior.

Configure o Valor do Estado de Relay

O valor do estado de retransmissão é obrigatório ao configurar o aplicativo SAML Okta na próxima tarefa. Use o valor correspondente ao seu ambiente.

Valores de Estado do Relay por Ambiente

A tabela a seguir lista os ambientes atualmente suportados:

Ambiente Valor do estado de retransmissão
Produção {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
FedRAMP {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
AUSOV1 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
EUSOV1 eyJjbGllbnRJZCI6IjBiNjk3ZWJiLTRlYTItNDA1Mi1iMTJiLWQzY2YxMmE1M2VjYSJ9
UKSOV1 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
UKSOV2 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}

Embora o valor do Relay State seja atualmente o mesmo em todos os ambientes, cada ambiente tem seu próprio id DO cliente exclusivo. ambientes futuros podem usar valores diferentes. Sempre use o valor listado para o seu ambiente para garantir a compatibilidade com versões futuras.

  1. Identifique o ambiente que sua organização usa.

  2. Copie o valor de Relay State correspondente da tabela.

  3. Use este valor ao configurar o aplicativo SAML Okta na próxima tarefa.

Testar a Integração do SAML

Antes de atribuir o autenticador de login SAML aos usuários em NiCE CXone, você deve testar a integração SAML. Se o teste falhar, revise suas configurações e faça alterações nas configurações.

  1. Faça login no Salesforce como administrador e abra o aplicativo IdP que você criou anteriormente.
  2. Acesse a página de gestão do aplicativo.

  3. Em Informações de login do SAML, copie a URL de Login Iniciada por IdP.

  4. Cole na barra de endereço de um navegador da web, mas não pressione Enter ainda.

  5. Acrescente o valor do estado de retransmissão que você gerou em uma tarefa anterior ao final da URL na barra de endereço usando este parâmetro: ?RelayState=[value].Por exemplo:

    https://IdP-initiated.URL.from..com/idp/login?app=123abc45?RelayState=eyJjbGllbnRJZCI6InsxMGc5ZjhlN2Q2YzViNGEzejJ5MXh9In0=

  6. Pressione entrar. Se o login no NiCE CXone for realizado com sucesso, você pode adicionar usuários ao autenticador de login.

Atualizar o URL de Início em Políticas do App Salesforce

  1. Em Salesforce, navegue até Setup Icon of a gear. > Platform Tools > Apps > Manage Connected Apps.

  2. Selecione o aplicativo conectado que você criou anteriormente.

  3. Clique em editar políticas.

  4. Em Iniciar URL, cole a URL de login modificada que inclui o relay state. Esta é a URL que você usou na tarefa anterior. Por exemplo, https://IdP-initiated.URL.from..com/idp/login?app=123abc45?RelayState=eyJjbGllbnRJZCI6InsxMGc5ZjhlN2Q2YzViNGEzejJ5MXh9In0=.

  5. Salve suas alterações.

Configurar usuários e adicionar ao autenticador de Fazer login do SAML

Conclua esta tarefa em NiCE CXone para todos os NiCE CXone usuários que necessitam de login único com Salesforce. Você pode modificar vários usuários ao mesmo tempo usando o modelo de upload em massa.

Após concluir esta tarefa, os usuários podem fazer login no NiCE CXone a partir de Salesforce. Para isso, eles podem acessar Setup > Platform Tools > Apps > Manage Connected Apps, selecionar o aplicativo desejado e clicar em Start URL.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneAdmin.

  2. Clique em Funcionários.

  3. Selecione o perfil do funcionário a ser modificado e clique em Editar.

  4. Se ainda não o fez, vá até a guia Segurança e selecione o autenticador de login que você criou anteriormente.

  5. Certifique-se de que a Identidade externa esteja definida com o valor correto. O valor deve corresponder exatamente ao Salesforce id DO usuário exclusivo correspondente do usuário. O tipo e o formato desse ID são configurados no aplicativo conectado que você criou em uma etapa anterior em Salesforce.

  6. Salve suas alterações.