Gerenciar Federação com Okta

Okta é 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 Okta.

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

Gerenciar Federação com Okta com SAML 2.0

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

Complete cada uma dessas tarefas na ordem indicada.

Antes de começar, verifique se você tem acesso ao Okta. Será necessário criar um aplicativo.

Configure o Valor do Estado de Relé

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 relay
Produção eyJjbGllbnRJZCI6IjBiNjk3ZWJiLTRlYTItNDA1Mi1iMTJiLWQzY2YxMmE1M2VjYSJ9
FedRAMP {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
AUSOV1 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
EUSOV1 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
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 possui 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 esse valor ao configurar o aplicativo SAML Okta na próxima tarefa.

Criar e configurar um Aplicativo Okta com SAML 2.0

  1. Faça login na sua conta de gestão do Okta.
  2. Clique em Applications menu > Create App Integration.
  3. Selecione SAML 2.0 como o método e clique em Avançar.
  4. Insira o nome que deseja usar para identificar esta integração e clique em Próx..
  5.  Configure SAML:
    1. Enter uma URL placeholder, como https://need_to_change, no campo Single sign-on URL. Você obterá a URI real do Serviço de Consumidor de Asserção (ACS) a partir do autenticador de login NiCE CXone em uma etapa posterior.
    2. Selecione Usar isso para URL de Destinatário e URL de Destino.
    3. Insira um URL de espaço reservado como https://need_to_change em Audience URI (SP Entity ID). Em uma etapa posterior, você substituirá o espaço reservado pelo ID da Entidade do seu NiCE CXone autenticador de login.
    4. Insira o valor de Default Relay State que você gerou na etapa anterior.
    5. Especifique o Formato da ID do nome e o nome do usuário do Aplicativo para corresponder a como você deseja identificar seus usuários para NiCE CXone. Escolha o atributo a ser usado como a ID do nome, como nome do usuário ou e-mail do Okta. Sua seleção aqui determina o que você usa no campo Id externo no perfil de funcionário de cada usuário do NiCE CXone, que você configura em uma etapa posterior.
    6. Clique em Mostrar Configurações Avançadas.
    7. Selecione um Algoritmo de assinatura. Recomenda-se RSA_SHA256.

    8. Altere Assertion Signature para Unsigned. Deixe Resposta como Assinado.
    9. Certifique-se de que Criptografia de declaração seja Não criptografado.
  6. Clique em Próximo, conclua o feedback e clique em Terminar na guia Feedback.
  7. Click View SAML setup instructions to open a new tab, then:
    1. Clique em Baixar certificado para baixar o certificado de assinatura. Mantenha este arquivo para sua configuração NiCE CXone.
    2. Feche a aba Instruções de configuração do SAML. Deixe a guia Configurar SAML aberta. Você fará alterações na sua configuração com base nas NiCE CXone configurações que obterá em uma etapa posterior.

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 do NiCE CXone 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. URLs ou marcações como html não serão salvas.
  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 ACS. Anote esses valores. Você precisará deles na tarefa adicionar valores de NiCE CXone a Okta.

Configure usuários do NiCE CXone

Complete this task in NiCE CXone fir all NiCE CXone users who require single sign-on with Okta. You can also complete this step using the 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 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 Unique User Identifier em Okta.

  6. Salve suas alterações.

Adicionar valores de NiCE CXone a Okta

  1. Retorne ao seu aplicativo Okta e vá para a Guia geral.
  2. Clique em Editar na janela Configurações SAML e, em seguida, clique em Próximo.
  3. Para URL de login único, digite o valor ACS URL do seu autenticador de login NiCE CXone.
  4. Para URI do público (ID da Entidade SP), digite o ID da Entidade do seu autenticador de login do NiCE CXone.
  5. Clique em Próximo e, em seguida, clique em Terminar para concluir a alteração.

Testar a Integração 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 Okta.
  2. Verifique se o fluxo de Autenticação SAML funciona conforme esperado.

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

  1. Peça que um ou mais usuários de teste façam login usando a URL de login mais recente, https://cxone.niceincontact.com. Para FedRAMP, use https://cxone-gov.niceincontact.com. Depois de inserir seu nome DE usuário, eles serão direcionados para Okta, se necessário.

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

Esta é a última etapa no gerenciamento da federação com SAML 2.0.

Gerenciar federação com Okta com OpenID Connect

Complete cada uma dessas tarefas na ordem indicada.

Configure um Aplicativo Okta com OpenID Connect

  1. Faça login na sua conta de gestão do Okta.
  2. Clique em Menu Aplicativos > Create App Integration.
  3. Selecione OIDC - OpenID Connect como o Sign-in method.
  4. Selecione Web Application como o tipo de Aplicativo, e clique em Próx..
  5. No campo nome da integração do aplicativo, insira o nome que deseja usar para identificar esta integração.
  6. You will need to provide a Sign-in Redirect URI which you don't know at this point. Use https://cxone.niceincontact.com/need_to_change como marcador de posição. Você alterará esse valor com o URI recebido posteriormente.
  7. Talvez seja necessário fornecer um Sign-out Redirect URI que você não conhece neste momento. Use https://cxone.niceincontact.com/need_to_change como marcador de posição. Você alterará esse valor com o URI recebido posteriormente.
  8. No menu suspenso Acesso controlado, selecione Ignorar atribuição de grupo por enquanto.
  9. Clique em Salvar.
  10. Na guia geral em Credenciais do cliente, selecione Autenticação do cliente.
  11. Select one of the following authentication methods:
    1. client_secret_basic: client credentials are passed in a basic header during authentication. After selecting this method, configure the following:
      1. Selecione Autenticação do cliente como o Segredo do cliente.
      2. 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.
    2. client_secret_post: client credentials are passed in a body during authentication. After selecting this method, configure the following:
      1. Selecione Autenticação do cliente como o Segredo do cliente.
      2. Copie o Id DO cliente e o Segredo do cliente e cole-os em um local seguro no seu dispositivo. Você precisará usá-los quando configurar um autenticador de login no NiCE CXone.
    3. client_secret_jwt: JWT bearer tokens are used for client authentication. After selecting this method, configure the following:
      1. Selecione Autenticação do cliente como o Segredo do cliente.
      2. 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.
    4. private_key_jwt: JWT bearer tokens are used for client authentication. The JWT is signed by the Client Private Key that you will provide in later steps. After selecting this method, configure the following:
      1. Selecione Autenticação do cliente como a chave pública / chave privada.
      2. Enter uma chave pública Placeholder no campo Adicionar chave pública. Será necessário substituir o placeholder pela chave fornecida por NiCE CXone ao configurar seu autenticador de login.
  12. Na guia Atribuições, clique em Atribuir e, em seguida, clique em Atribuir a Pessoas.
  13. Atribua usuários a este aplicativo.

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 OpenID Connect em NiCE CXone

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

  2. Vá até Configurações de segurança > Autenticador de login.

  3. Clique em Novo Autenticador de login 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. ```xml

    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 Okta, 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 Okta.
  9. Se você não possui um terminal de descoberta do Okta, insira seu OktaEmissor fornecido pelo , Terminal jsonwebkeyset, Terminal de autorização, Terminal de token, Terminal userinfo e Terminal de revogação.

  10. Selecione um Método de Autenticação de cliente. O método selecionado deve corresponder ao que você configurou na tarefa anterior. Deve ser um método de autenticação aceito pelo Okta. Se você selecionar private_key_jwt, deverá inserir sua Client Private Key.
  11. Você pode selecionar ativar Perfil FICAM para ativar 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 Okta.
  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 Okta.

  16. Atualize as configurações do seu Okta, 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 Okta determina o valor que deve ser usado. A mesma pode ser encontrada no perfil do usuário em Okta. 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 email 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 o URL de login mais recente. Depois de inserir seu nome DE usuário, eles serão direcionados para Okta, se necessário.

  19. Quando o Okta pedir para você autenticar sua própria conta, faça isso como o usuário 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 Okta para diagnosticar o problema.

Adicionar NiCE CXone valores a Okta

  1. Retorne ao seu aplicativo Okta e vá para a Guia geral.
  2. Clique em Editar na janela Configurações SAML e, em seguida, clique em Próximo.
  3. Para URL de login único, digite o valor ACS URL do seu autenticador de login NiCE CXone.
  4. Para URI do público (ID da Entidade SP), digite o ID da Entidade do seu autenticador de login do NiCE CXone.
  5. Clique em Próximo e, em seguida, clique em Terminar para concluir a alteração.

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

  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 a Identidade externa em NiCE CXone. O campo Identidade externa faz distinção entre maiúsculas e minúsculas.

  2. Peça a um ou mais usuários de teste que façam login usando a URL de login mais recente, https://cxone.niceincontact.com. Para FedRAMP, use https://cxone-gov.niceincontact.com. Depois de inserir seu nome DE usuário, eles serão direcionados para Okta, se necessário.

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