Gerenciar Federação com Okta

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

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

Gerenciar Federação com Okta com SAML 2.0

Esta página orienta você, passo a passo, na configuração da autenticação para seu sistema CXone Mpower usando Onelogin 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. Você precisará criar um aplicativo.

Criar e configurar um aplicativo Okta com SAML 2.0

  1. Faça login na sua conta de gerenciamento do Okta.
  2. Clique no menu Aplicativos > Criar integração de aplicativo.
  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óximo.
  5. Configure SAML:
    1. Insira um URL de espaço reservado como https://need_to_change no campo URL de logon único. Você obterá o URI real do Assertion Consumer Service (ACS) do autenticador de login do CXone Mpower em uma etapa posterior.
    2. Selecione Use esta opção para Destinatário URL e Destino URL.
    3. Insira um URL de espaço reservado, como https://need_to_change, no URI de público-alvo (ID do Entidade do SP). Em uma etapa posterior, você substituirá o espaço reservado pelo ID de Entidade do autenticador de loginCXone Mpower.
    4. Especifique o Formato de ID do nome e o Nome de usuário do aplicativo para corresponder à forma como você deseja identificar seus usuários para CXone Mpower. Escolha o atributo a ser usado como ID do nome, como Okta nome de usuário ou e-mail.
    5. Clique em Mostrar configurações avançadas.

    6. Selecione um Algoritmo de assinatura. RSA_SHA256 é recomendado.

    7. Altere Assinatura de declaração para Não assinado. Deixe Resposta como Assinado.
    8. 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 Opiniões.
  7. Clique em Exibir instruções de configuração do SAML para abrir uma nova guia, então:
    1. Clique em Baixar certificado para baixar o certificado de assinatura. Mantenha este arquivo para sua configuração CXone Mpower.
    2. Feche a guia Instruções de configuração SAML. Deixe a guia Configurar SAML aberta. Você fará alterações em sua configuração com base nas configurações CXone Mpower obterá em uma etapa posterior.

Configurar um autenticador de login externo do CXone Mpower com SAML 2.0

Permissões necessárias: Criar autenticador de login

  1. Clique no seletor de aplicativo ícone do seletor de aplicativos e selecioneAdmin.
  2. Clique em Autenticador de Login.
  3. Clique em Criar Novo.
  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 SAML2 como o Tipo de Autenticação.
  6. Clique em Escolher arquivo e selecione o certificado de assinatura público do qual 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.
  7. Clique em Salvar e Ativar.
  8. Abra o autenticador de login.

  9. Você notará dois campos adicionais somente leitura exibidos: o ID da entidade e o URL do ACS. Anote esses valores. Você precisará deles na Adicionar valores de CXone Mpower à Okta tarefa.

Atribuir usuários ao autenticador de login

  1. Clique no seletor de aplicativo ícone do seletor de aplicativos e selecioneAdmin.

  2. Clique em Usuários.

  3. Selecione o usuário que você quer atribuir ao autenticador de login ou clique em Criar Novo para criar um novo usuário.

  4. No guia Geral, clique em Editar.

  5. Na seção Segurança, selecione o autenticador de login que você criou anteriormente na lista suspensa Autenticador de login.

  6. Clique em Feito.

Adicionar CXone Mpower 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 CXone Mpower.
  4. Para URI do público (ID da entidade SP), digite o ID da entidade do seu autenticador de login do CXone Mpower.
  5. Clique em Próximo e, em seguida, clique em Concluir para concluir a alteração.

Testar a integração com o SAML

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

  1. Inicie um login no painel do Okta.
  2. Verifique se o fluxo de autenticação SAML funciona conforme o esperado.

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

  1. Certifique-se de que a Identidade Externa de cada do usuário que usa o autenticador de login esteja definida com o valor correto. O valor deve corresponder exatamente a Identidade Federada no CXone Mpower. O campo Identidade Externa faz distinção entre maiúsculas e minúsculas.

  2. Faça com que um ou mais usuários de teste efetuem login usando o 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 logon único Okta para todos os usuários.

Gerencie a federação com Okta com OpenID Connect

Complete cada uma dessas tarefas na ordem indicada.

Configurar um aplicativo Okta com OpenID Connect

  1. Faça login na sua conta de gerenciamento do Okta.
  2. Clique no menu Aplicativos > Criar integração de aplicativo.
  3. Selecione OIDC - OpenID Connect como o Método de login.
  4. Selecione Aplicativo Web como o Tipo de aplicativo e clique em Avançar.
  5. No campo Nome da integração do aplicativo, digite o nome que você quer usar para identificar essa integração.
  6. Você precisará fornecer um URI de redirecionamento para login 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.
  7. Talvez seja preciso fornecer um URI de redirecionamento para logout 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 Pular atribuição de grupo por enquanto.
  9. Clique em Save.
  10. Na guia Geral, em Credenciais do cliente, selecione Autenticação do cliente.
  11. Selecione um dos seguintes métodos de autenticação:
    1. client_secret_basic: as credenciais do cliente são passadas em um cabeçalho básico durante a autenticação. Depois de selecionar este método, configure o seguinte:
      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 CXone Mpower.
    2. client_secret_post: as credenciais do cliente são passadas em um corpo durante a autenticação. Depois de selecionar este método, configure o seguinte:
      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 CXone Mpower.
    3. client_secret_jwt: Os tokens de portador JWT são usados ​​para autenticação do cliente. Depois de selecionar este método, configure o seguinte:
      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 CXone Mpower.
    4. private_key_jwt: Os tokens de portador JWT são usados ​​para autenticação do cliente. O JWT é assinado pela Chave privada do cliente que você fornecerá nas etapas posteriores. Depois de selecionar este método, configure o seguinte:
      1. Selecione Autenticação do cliente como a Chave pública/Chave privada.
      2. Insira uma chave pública de espaço reservado no campo Adicionar chave pública. Você precisará substituir o espaço reservado pela chave fornecida pelo CXone Mpower quando 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 esse aplicativo.

Configurar um autenticador de login com OpenID Connect no CXone Mpower

  1. Clique no seletor de aplicativo ícone do seletor de aplicativos e selecioneAdmin

  2. Clique em Autenticador de login.

  3. Clique em Criar Novo ou selecione o autenticador de login que você quer editar.
  4. Digite o Nome e a Descrição do autenticador de login.
  5. Selecione OIDC como o Tipo de Autenticação.
  6. Se você tiver um terminal de descoberta do Okta, clique em Configurações de descoberta. Digite seu terminal de descoberta e clique em Descobrir. Os campos restantes são preenchidos para você. Descobrir Configurações não funciona com os terminais de descoberta do Salesforce.
  7. Insira o seu Identificador do cliente e Senha do Cliente. Digite novamente a senha em Senha de confirmação do cliente. O Identificador de cliente é o ID de login atribuído à sua conta pelo Okta.

  8. Se você não possui um terminal de descoberta do Okta, insira seu Emissor fornecido pelo Okta, Terminal JsonWebKeySet, Terminal de Autorização, Terminal de Token, Terminal UserInfo e Terminal de Revogação.

    campo

    Detalhes
    Emitente

    URL do Okta sem qualquer parâmetro.
    Terminal JsonWebKeySet O URL do JWK Set do Okta
    Terminal de autorização O URL do Terminal de Autorização OAuth 2.0 do Okta.
    Terminal de token O URL do Terminal de Token OAuth 2.0 do Okta.
    Terminal UserInfo O URL do Terminal UserInfo do Okta.
    Terminal de revogação O URL do Terminal de Revogação do Okta.
  9. 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á selecionar Habilitar Criptografia e digite a Chave de verificação de declaração do cliente.
  10. Você pode selecionar Ativar perfil FICAM para ativar as configurações específicas do governo dos Estados Unidos. Esta etapa é apenas para usuários do FedRAMP.
  11. Clique em Criar Autenticador de Login para validar as informações fornecidas e vincular sua conta do CXone Mpower à sua conta do Okta.
  12. Abra o autenticador de login.

  13. Anote o URI de redirecionamento para login e o URI de redirecionamento para logout. Você precisará deles para atualizar as configurações do Okta.

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

  15. Certifique-se de que a Identidade Externa do CXone Mpower de cada usuário que usa o autenticador de login esteja configurada com o valor correto.

    O Okta determina o valor que deve ser usado. Ele pode ser encontrado no perfil do usuário no Okta. O valor deve corresponder exatamente ao que você colocou no campo Identidade Externa em CXone Mpower. O valor desse campo deve estar neste formato: claim(email):{e-mail configurado por seu IdP}. Por exemplo, se o e-mail do usuário no IdP for nick.carraway@classics.com, você digitaria claim(email):nickcarraway@classics.com.

  16. Peça para o usuário fazer login no CXone Mpower. Ele deve usar o URL de login mais recente. Depois de inserir seu nome de usuário, eles serão direcionados para Okta, se necessário.

  17. 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 CXone Mpower conectada atualmente.
  18. Se as configurações do OpenID Connect no CXone Mpower não aparecerem como validadas, use os logs do Okta para diagnosticar o problema.

Atribuir usuários ao autenticador de login

  1. Clique no seletor de aplicativo ícone do seletor de aplicativos e selecioneAdmin.

  2. Clique em Usuários.

  3. Selecione o usuário que você quer atribuir ao autenticador de login ou clique em Criar Novo para criar um novo usuário.

  4. No guia Geral, clique em Editar.

  5. Na seção Segurança, selecione o autenticador de login que você criou anteriormente na lista suspensa Autenticador de login.

  6. Clique em Feito.

Adicionar CXone Mpower 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 CXone Mpower.
  4. Para URI do público (ID da entidade SP), digite o ID da entidade do seu autenticador de login do CXone Mpower.
  5. Clique em Próximo e, em seguida, clique em Concluir 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 do usuário que usa o autenticador de login esteja definida com o valor correto. O valor deve corresponder exatamente a Identidade Federada no CXone Mpower. O campo Identidade Externa faz distinção entre maiúsculas e minúsculas.

  2. Faça com que um ou mais usuários de teste efetuem login usando o 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 logon único Okta para todos os usuários.