Gerenciar Federação com Azure

Azure é apenas um dos provedores de identidade externa (IdPs) com suporte que você pode usar com NiCE CXone. Esta página orienta você, etapa por etapa, na configuração da autenticação para o seu sistema NiCE CXone usando Azure.

Se você estiver fazendo a implementação inicial do seu sistema NiCE CXone, há etapas adicionais a serem consideradas. Recomendamos a leitura das seguintes páginas da ajuda online que incluem estas considerações:

Antes de começar, certifique-se de que você tenha acesso ao console de gestão de identidades Microsoft Azure ID. Você precisará criar um aplicativo.

Gerenciar federação com o Azure com SAML 2.0

Complete cada uma dessas tarefas na ordem indicada.

Configure o valor de Estado do Relay

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

Valores de Estado de Relay por Ambiente

A tabela a seguir lista os ambientes atualmente suportados:

Ambiente Valor do estado de retransmissão
Produção eyJjbGllbnRJZCI6IjBiNjk3ZWJiLTRlYTItNDA1Mi1iMTJiLWQzY2YxMmE1M2VjYSJ9
FedRAMP eyJjbGllbnRJZCI6IjBiNjk3ZWJiLTRlYTItNDA1Mi1iMTJiLWQzY2YxMmE1M2VjYSJ9
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 de 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. Use sempre o valor listado para o seu ambiente para garantir a compatibilidade com versões futuras.

  1. Identifique o ambiente usado por sua organização.

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

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

Criar e configurar um Aplicativo de Azure com SAML 2.0

  1. Faça login na sua conta de gestão do AD do Azure com sua conta de administrador do AD do Azure.
  2. Create an application:
    1. Clique em Aplicativos empresariais > New Application.
    2. Clique em Create your own aplicativo.
    3. Digite um Nome (por exemplo, NiCE CXone).
    4. Selecione Integrar qualquer outro aplicativo que você não encontrar na galeria (Fora da galeria).
    5. Clique em Criar.
  3. Atribua usuários e grupos ao aplicativo conforme apropriado. Vá até a guia Usuários e Grupos e clique em Adicionar usuário/grupo.
  4. Na página de gestão do aplicativo, localize a seção gestão. Em Configurar login único, clique em Get Started e, depois, selecione SAML.
  5.  On the Basic SAML Configuration panel, click Edit and configure SAML:
    1. Insira um App Name.
    2. Em Identificador (Entity ID), clique em Add Identifier e insira https://need_to_change. Em uma etapa posterior, você substituirá o placeholder pelo Entity ID do seu NiCE CXone autenticador de login.
    3. Em URL de resposta, clique em adicionar URL de resposta e, no campo URI do público, digite https://need_to_change. Você obterá o URI real do Serviço de Consumo de Asserção (ACS) a partir do autenticador de login NiCE CXone em uma etapa posterior.
    4. No campo Estado de Retransmissão da URL de Login, insira o valor do estado de retransmissão codificado que você gerou na tarefa anterior.
  6. Clique em Save e feche o painel Basic SAML Configuration.
  7. Na seção Attributes & Claims, selecione o Unique User Identifier correto. O valor escolhido será a Identidade externa em NiCE CXone.
  8. Azure O AD deve criar automaticamente um certificado de assinatura SAML. Baixe o certificado chamado Certificate (Base64). Você fará o upload deste certificado para o seu autenticador de login em NiCE CXone em uma etapa posterior.
  9. On the SAML Signing Certificate panel, click Edit and then:
    1. Escolha uma Opção de assinatura.
    2. Clique em Salvar e feche o painel Certificado de assinatura SAML. Mantenha este arquivo para sua configuração de NiCE CXone em uma etapa posterior.
  10. Se você quiser habilitar o login iniciado pelo SP, conclua esta etapa. Na seção Configurar <nome do aplicativo>, copie o valor de URL de fazer login. Guarde isso para sua configuração NiCE CXone.
  11. Manter sua janela aberta. Você fará alterações nas configurações do aplicativo Azure com base nos valores recebidos na próxima tarefa.

Configurar uma Localização

Permissões necessárias: Criação de Gerenciamento de localização

Se você quiser exigir que os usuários façam login a partir de um determinado Endereço IP, crie uma localização com os Endereços IP, intervalos de endereços IP ou sub-redes de endereços IP que deseja permitir. Quando se requer uma localização configurada para um usuário, este deverá dispor das credenciais corretas e de um Endereço IP para efetuar o login. Caso contrário, a tentativa de login falhará e eles receberão um erro. É possível ter até 20 localizações simultâneas e até dez regras por localização.

  1. Clique no seletor de aplicativos icon of app selector e selecioneAdmin.
  2. Vá para Localizações > Definições de localização.
  3. Clique em Nova localização.
  4. Dê um nome descritivo à localização. Se você deseja acrescentar mais detalhes sobre a localização, digite uma Descrição.
  5. Você pode selecionar Definir como Localização padrão ou Localização remota para indicar o tipo de Localização. É possível haver apenas uma localização padrão. Atualmente, estes campos não afetam qualquer funcionalidade e a seleção destes destina-se exclusivamente à sua referência.
  6. Adicione quaisquer outras informações que desejar usando os campos restantes, incluindo endereço físico, país, coordenadas de GPS, fuso horário ou grupos atribuídos. Atualmente, estes campos nada afetam e as informações digitadas neles destina-se exclusivamente à sua referência.

    Se você adicionar grupos ao campo Grupos atribuídos, os usuários pertencentes a esses grupos aparecerão na aba Usuários atribuídos. Porém, as configurações de local não se aplicarão a eles. Se você atribuir uma localização a um autenticador de login, a localização se aplica aos usuários que estão atribuídos a esse autenticador de login e restringe sua capacidade de fazer login com base no Endereço IP. Porém, estes usuários não constarão da guia Usuários atribuídos.

  7. Clique no menu suspenso Divisão localizado ao lado do campo de nome da localização.

  8. Na página Definições de localização, selecione o filtro de divisão para ver somente as localizações atribuídas a essa divisão. Limpe o filtro para ver todas as localizações novamente.

    Você pode mover uma localização da Divisão padrão para uma divisão específica apenas uma vez. Depois que uma localização é atribuída a uma divisão e salva, ela não pode ser movida para uma divisão diferente. Se a localização já tiver sido movida da Divisão padrão, este menu suspenso fica desativado e não pode ser modificado.

  9. Clique em Salvar.

  10. De volta à página Definições de localização, clique na Localização que você acabou de criar para abri-la.

  11. Clique na guia Regras de autodetecção.

  12. Crie uma nova regra. Para fazer isso:

    1. Clique em Nova regra.

    2. Dê à regra um nome descritivo.

    3. Selecione o Tipo DE regra dentre as opções a seguir:

      • Lista: Uma lista de Endereços IP específicos permitidos para esta localização. Por exemplo: 100.0.1.100, 100.0.1.101 e 100.0.1.102.

      • Faixa: uma faixa de endereços IP permitidos a esta localização. Por exemplo: 100.0.1.100-100.0.1.125.

      • Subrede: uma subrede permitida a esta localização. Por exemplo: 100.0.0.1/32.

    4. Especifique a Versão do IP, uma dentre as seguintes:

      • IPV4: um Endereço IP de 32 bits

      • IPV6: um endereço hexadecimal de 128 bits.

    5. Enter os Endereços IP, intervalo ou sub-rede reais no campo Definição da regra, seguindo os formatos dos exemplos nas etapas anteriores. Se você selecionou Lista, poderá inserir até 100 Endereços IP. Caso tenha selecionado Faixa ou Subrede, você poderá digitar apenas um valor.

    6. Clique em Confirmar.

  13. Adicione mais regras conforme necessário. É possível ter até dez regras.

  14. Clique em Salvar.

Configurar um Autenticador de login com SAML 2.0 em NiCE CXone

Permissões necessárias: Criar Autenticador de login

  1. Clique no seletor de aplicativos icon of app selector e selecioneAdmin.
  2. Acesse Configurações de 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. Os URLs ou marcações como html não serão salvos.
  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 Azure na tarefa anterior. Este arquivo deve estar no formato 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 de somente leitura exibidos, o Entity ID e a URL do ACS. Anote esses valores. Você precisará deles na tarefa adicionar valores de NiCE CXone a Azure.

Configurar usuários do NiCE CXone

Conclua esta tarefa em NiCE CXone para todos os usuários NiCE CXone que exigem logon único com Azure. Você também pode concluir esta etapa usando o modelo de upload em massa.

  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 aba 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 Unique User Identifier em Azure. Se um id de e-mail tiver sido configurado como o id externo, certifique-se de formatá-lo corretamente. Em Azure, o formato do id de e-mail é firstname.lastname@domain.com e diferencia maiúsculas de minúsculas.

  6. Salve suas alterações.

Adicionar valores NiCE CXone a Azure

  1. Retorne ao seu aplicativo Azure e, no painel Basic SAML Configuration, clique em Edit.
  2. Para Identificador (ID da Entidade), insira o valor da ID da Entidade do seu autenticador de login NiCE CXone.
  3. Para Reply URL, insira o valor de URL ACS do seu autenticador de login NiCE CXone.
  4. Clique em Salvar e feche o painel configuração básica do SAML.

Teste 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. Iniciar um login a partir do dashboard do Azure.
  2. Verifique se o fluxo de Autenticação SAML funciona como esperado.

Verificar o acesso do usuário com logon único Azure

  1. Peça a um ou mais usuários de teste que façam login usando o URL de login mais recente. Depois de inserir seu nome DE usuário, eles serão direcionados para Azure, se necessário.

  2. Quando estiver pronto, implemente o logon único Azure para todos os funcionários.

Esta é a última etapa na configuração de Federation com SAML 2.0.

Gerenciar federação com Azure com OpenID Connect

Complete cada uma dessas tarefas na ordem indicada.

Configure um Aplicativo Azure com OpenID Connect

  1. Faça login na sua conta de gestão do Azure.

  2. Em Registros de aplicativos, clique em Novo registro.

  3. Vá para Autenticação > Web.

  4. Você precisará fornecer URIs de Redirecionamento, que você não conhece neste momento. Use https://cxone.niceincontact.com/need_to_change como marcador de posição.

  5. Clique em Certificados e segredos.

  6. Selecione client_secret_basic ou client_secret_post como seu método de autenticação. O método de autenticação, private_key_jwt, não é atualmente compatível com NiCE CXone.

  7. No campo Segredos do cliente, selecione Novo segredo do cliente.

  8. Adicione uma descrição e selecione Expira.

  9. Copie o Id DO cliente e o Segredo do cliente e cole-os em um local seguro em seu dispositivo. Você precisará usá-los quando configurar um autenticador de login no NiCE CXone.

  10. Vá para Token Configuration > Optional Claims.

  11. Clique em Adicionar declaração Opcional.

  12. Selecione ID como o tipo de token.

  13. Selecione e-mail e adicione seu endereço DE e-mail.

  14. Clique em Salvar.

Configurar uma Localização

Permissões necessárias: Criação de Gerenciamento de localização

Se você quiser exigir que os usuários façam login a partir de um determinado Endereço IP, crie uma localização com os Endereços IP, intervalos de endereços IP ou sub-redes de endereços IP que deseja permitir. Quando se requer uma localização configurada para um usuário, este deverá dispor das credenciais corretas e de um Endereço IP para efetuar o login. Caso contrário, a tentativa de login falhará e eles receberão um erro. É possível ter até 20 localizações simultâneas e até dez regras por localização.

  1. Clique no seletor de aplicativos icon of app selector e selecioneAdmin.
  2. Vá para Localizações > Definições de localização.
  3. Clique em Nova localização.
  4. Dê um nome descritivo à localização. Se você deseja acrescentar mais detalhes sobre a localização, digite uma Descrição.
  5. Você pode selecionar Definir como Localização padrão ou Localização remota para indicar o tipo de Localização. É possível haver apenas uma localização padrão. Atualmente, estes campos não afetam qualquer funcionalidade e a seleção destes destina-se exclusivamente à sua referência.
  6. Adicione quaisquer outras informações que desejar usando os campos restantes, incluindo endereço físico, país, coordenadas de GPS, fuso horário ou grupos atribuídos. Atualmente, estes campos nada afetam e as informações digitadas neles destina-se exclusivamente à sua referência.

    Se você adicionar grupos ao campo Grupos atribuídos, os usuários pertencentes a esses grupos aparecerão na aba Usuários atribuídos. Porém, as configurações de local não se aplicarão a eles. Se você atribuir uma localização a um autenticador de login, a localização se aplica aos usuários que estão atribuídos a esse autenticador de login e restringe sua capacidade de fazer login com base no Endereço IP. Porém, estes usuários não constarão da guia Usuários atribuídos.

  7. Clique no menu suspenso Divisão localizado ao lado do campo de nome da localização.

  8. Na página Definições de localização, selecione o filtro de divisão para ver somente as localizações atribuídas a essa divisão. Limpe o filtro para ver todas as localizações novamente.

    Você pode mover uma localização da Divisão padrão para uma divisão específica apenas uma vez. Depois que uma localização é atribuída a uma divisão e salva, ela não pode ser movida para uma divisão diferente. Se a localização já tiver sido movida da Divisão padrão, este menu suspenso fica desativado e não pode ser modificado.

  9. Clique em Salvar.

  10. De volta à página Definições de localização, clique na Localização que você acabou de criar para abri-la.

  11. Clique na guia Regras de autodetecção.

  12. Crie uma nova regra. Para fazer isso:

    1. Clique em Nova regra.

    2. Dê à regra um nome descritivo.

    3. Selecione o Tipo DE regra dentre as opções a seguir:

      • Lista: Uma lista de Endereços IP específicos permitidos para esta localização. Por exemplo: 100.0.1.100, 100.0.1.101 e 100.0.1.102.

      • Faixa: uma faixa de endereços IP permitidos a esta localização. Por exemplo: 100.0.1.100-100.0.1.125.

      • Subrede: uma subrede permitida a esta localização. Por exemplo: 100.0.0.1/32.

    4. Especifique a Versão do IP, uma dentre as seguintes:

      • IPV4: um Endereço IP de 32 bits

      • IPV6: um endereço hexadecimal de 128 bits.

    5. Enter os Endereços IP, intervalo ou sub-rede reais no campo Definição da regra, seguindo os formatos dos exemplos nas etapas anteriores. Se você selecionou Lista, poderá inserir até 100 Endereços IP. Caso tenha selecionado Faixa ou Subrede, você poderá digitar apenas um valor.

    6. Clique em Confirmar.

  13. Adicione mais regras conforme necessário. É possível ter até dez regras.

  14. Clique em Salvar.

Configurar um Autenticador de login NiCE CXone com OpenID Connect

  1. Clique no seletor de aplicativos icon of app selector e selecioneAdmin.

  2. Acesse Configurações de segurança > Autenticador de login.

  3. Clique em New Login Authenticator ou selecione o Autenticador de login que deseja editar.
  4. Digite o Nome e a Descrição do autenticador de login.
  5. Selecione OIDC 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. Se você tiver um terminal discovery de Azure, clique em Descobrir Configurações. Digite seu terminal discovery e clique em Descobrir. Os campos restantes são preenchidos automaticamente para você. Descobrir Configurações não funciona com os terminais de descoberta do Salesforce.
  8. Insira o seu Identificador do cliente e Senha do cliente. Redigite a senha em Client Confirm Password. O Identificador de cliente é o id DE login atribuído à sua conta pelo Azure.
  9. Se você não possui um terminal de descoberta do Azure, insira seu AzureEmissor fornecido pelo , Terminal jsonwebkeyset, Terminal de autorização, Terminal de token, Terminal userinfo, Terminal de revogação e Terminal de encerramento de sessão.

  10. Selecione um Método de Autenticação de cliente. O método que você selecionar deve corresponder ao que você configurou na tarefa anterior. Deve ser um método de autenticação aceito pelo Azure.
  11. Você pode selecionar Enable FICAM Profile para ativar as configurações específicas do governo dos Estados Unidos. Esta etapa é apenas para usuários do FedRAMP.
  12. 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.

  13. Clique em Salvar e ativar para validar as informações fornecidas e vincular sua conta NiCE CXone à sua conta Azure.
  14. Abra o autenticador de login.
  15. Anote o URI de redirecionamento para login e o URI de redirecionamento para logout. Você precisará deles para atualizar as configurações do Azure.

  16. Atualize as configurações do seu Azure, substituindo os espaços reservados usados na tarefa anterior pelos valores que você acabou de anotar.

  17. Certifique-se de que a NiCE CXoneIdentidade externa do de cada usuário que usa o autenticador de login esteja configurada com o valor correto. Esse campo pode ser acessado na seção de segurança do perfil do funcionário.

    O Azure determina o valor que deve ser usado. É possível encontrá-lo no perfil do usuário em Azure. O valor deve corresponder exatamente ao que você colocou no campo Identidade externa em NiCE CXone. O valor deste campo deve estar neste formato: claim(email):{email configured by your IdP}. Por exemplo, se o e-mail do usuário no IdP for nick.carraway@classics.com, você deve inserir claim(email):nickcarraway@classics.com.

  18. Peça para o usuário fazer login no NiCE CXone. Eles devem usar a URL de login mais recente. Depois de inserir o nome DE usuário, eles serão direcionados para o Azure, se necessário.

  19. Quando o Azure pedir para você autenticar sua própria conta, faça isso como o usuário no Azure que você quer associar à sua conta do NiCE CXone conectada atualmente.
  20. Se as configurações de OpenID Connect em NiCE CXone não aparecerem como validadas, use os logs de Azure para diagnosticar o problema.

Adicionar NiCE CXone valores a Azure

  1. Retorne para o seu aplicativo Azure e, no painel Basic SAML Configuration, clique em Editar.
  2. Para Identificador (ID da Entidade), insira o valor da ID da Entidade do seu autenticador de login NiCE CXone.
  3. Para Reply URL, insira o valor de URL ACS do seu autenticador de login NiCE CXone.
  4. Clique em Salvar e feche o painel configuração básica do SAML.
  5. Certifique-se de que a Identidade externa de cada usuário que usa o autenticador de login esteja configurada com o valor correto.

    1. Seu provedor de identidade determina o valor que deve ser usado. O valor deve corresponder exatamente ao Unique User Identifier em Azure e à Identidade externa em NiCE CXone.

  6. Faça o usuário fazer login. Eles devem usar o URL de login mais recente. Depois de inserir seu nome DE usuário, eles serão direcionados para o provedor de identidade externo, se necessário.

Verificar o acesso do usuário com logon único Azure

  1. Certifique-se de que a Identidade externa de cada funcionário que usa o autenticador de login esteja definida com o valor correto. O valor deve corresponder exatamente ao Unique User Identifier em Azure e à Identidade externa em NiCE CXone.

  2. Peça a um ou mais usuários de teste que façam login usando a URL de login mais recente. Depois de inserir seu nome DE usuário, eles serão direcionados para Azure, se necessário.

  3. Quando estiver pronto, implemente o Azure single sign-on para todos os funcionários.