Configurar a autenticação NiCE CXone usando Onelogin como Provedor de identidade Externa
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).
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 de 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 é necessário incluir autenticação e autorização para aplicativos como bots ou assistentes virtuais inteligentes (IVAs). Nesse caso, você precisará criar chaves DE acesso.
- Obtenha uma compreensão do seu protocolo de autenticação. NiCE CXone oferece suporte a SAML 2.0 para a integração com Onelogin.
- 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 surgem necessidades imediatas tem maior probabilidade de gerar problemas.
Complete cada uma dessas tarefas na ordem indicada.
Configurar um Aplicativo IDP no Onelogin
A configuração de um aplicativo IDP no Onelogin requer diversas tarefas. Conclua-as na ordem fornecida.
Configurar o Valor de Estado de 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 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 | eyJjbGllbnRJZCI6IjBiNjk3ZWJiLTRlYTItNDA1Mi1iMTJiLWQzY2YxMmE1M2VjYSJ9 |
| EUSOV1 | eyJjbGllbnRJZCI6IjBiNjk3ZWJiLTRlYTItNDA1Mi1iMTJiLWQzY2YxMmE1M2VjYSJ9 |
| UKSOV1 | eyJjbGllbnRJZCI6IjBiNjk3ZWJiLTRlYTItNDA1Mi1iMTJiLWQzY2YxMmE1M2VjYSJ9 |
| 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. Sempre use o valor listado para o seu ambiente para garantir a compatibilidade com versões futuras.
-
Identifique o ambiente que sua organização usa.
-
Copie o valor de Relay State correspondente a partir da tabela.
-
Use este valor ao configurar o aplicativo SAML Okta na próxima tarefa.
Criar um Aplicativo em Onelogin
- Conecte-se no Onelogin como administrador.
- Acesse Applications > Applications e clique em Add App.
- Pesquise SAML Text Connector (IdP), depois selecione-o e salve.
- Na seção Aplicativo, selecione App > Configuration.
- Digite um Nome DE exibição para o aplicativo.
- Se desejar, selecione um ícone e adicione uma descrição.
- Salve seu aplicativo.
- Mova para a próxima tarefa para definir configurações.
Configurar Single Sign-On e Configurar Configurações SAML
- If you haven't created a certificate in Onelogin yet, do so now:
- Vá para Segurança > Certificates e clique em New.
- Dê um nome ao certificado e selecione uma assinatura. A opção recomendada é SHA-256.
- Clique em Salvar.
- No menu suspenso Impressão digital da assinatura, selecione a mesma opção que você escolheu para assinatura.
- Clique em Salvar.
- Baixe o certificado.
- No aplicativo que você criou, clique em Configuration no menu à esquerda.
- No campo RelayState, insira o valor de relay state codificado que você gerou na tarefa anterior.
- Para o público, Enter a placeholder URL, como https://need_to_change. Você substituirá o placeholder pelo ID da Entidade do seu autenticador de login NiCE CXone em uma etapa posterior.
- No campo Destinatário e nos campos ACS (Consumer) URL Validator e ACS (Consumer) URL, insira outro URL placeholder. Você obterá o URL real do Assertion Consumer Service (ACS) a partir do seu NiCE CXone autenticador de login em uma etapa posterior.
- Clique em SSO no menu à esquerda.
- Em X.509, clique em Alterar, depois selecione o certificado que você criou na lista suspensa.
- Selecione um Algoritmo de assinatura SAML. O algoritmo recomendado é SHA-256.
- Selecione Sugestão de Login e Login Presumido.
- Vá até a página Usuários e adicione todos os usuários que precisam poder usar Onelogin para fazer login em NiCE CXone.
- Clique em Privileges no menu esquerdo e adicione um ou mais usuários como administradores deste aplicativo.
- Deixe a janela aberta. Você fará alterações em sua configuração com base nas configurações de NiCE CXone que você obterá mais tarde.
Criar um Autenticador de login com SAML 2.0
Permissões necessárias: Criar Autenticador de login
- Clique no seletor de aplicativos
e selecioneAdmin. - Clique em Segurança > Autenticador de login.
- Clique em Novo Autenticador de login.
- 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.
- Selecione SAMLcomo o Tipo de autenticação.
-
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.
- Se você quiser habilitar o login iniciado pelo provedor de serviços (SP) para este autenticador de login, conclua esta etapa. No campo URL DO terminal, insira o Terminal SAML 2.0 que você copiou de Onelogin na tarefa anterior.
- Clique em Escolher arquivo e selecione o certificado de assinatura público que você baixou de Onelogin 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.
-
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.
- Clique em Salvar e ativar.
- Abra o autenticador de login.
-
Você notará dois campos adicionais somente leitura exibidos: o ID da Entidade e a URL ACS. Anote esses valores. Você precisará deles na próxima tarefa.
Adicionar valores de NiCE CXone a Onelogin
Concluir esta etapa em Onelogin.
-
Conecte-se no Onelogin como administrador.
-
Em Configurações do aplicativo Web, no aplicativo conectado que você criou, cole os valores que você copiou do seu autenticador de login em NiCE CXone:
- Nos campos Destinatário, ACS (Consumidor) Validador de URL e ACS (Consumidor) URL, exclua o Placeholder URL e cole o que você copiou do campo ACS URL em seu autenticador de login NiCE CXone na tarefa anterior.
- No campo Audience, exclua o URL do espaço reservado e cole o que você copiou do campo Entity ID em seu NiCE CXone autenticador de login na tarefa anterior.
Configurar NiCE CXone Usuários
Complete this task in NiCE CXone for all NiCE CXone users who require single sign-on with Onelogin. Você também pode concluir esta etapa usando o modelo de upload em massa.
-
Em NiCE CXone, clique no seletor de aplicativos
e selecioneAdmin. -
Clique em Funcionários.
-
Selecione o perfil de funcionário a ser modificado e clique em Editar.
-
Caso ainda não o tenha feito, vá até a guia Segurança e selecione o autenticador de login que você criou anteriormente.
-
Certifique-se de que o Identidade externa esteja definido com o valor correto. O valor deve corresponder exatamente ao Identificador de Usuário Exclusivo em Onelogin.
-
Salve suas alterações.
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.
- Iniciar um login a partir do dashboard do Onelogin.
- Verifique se o fluxo de Autenticação SAML funciona como você espera.