Instruções de Configuração SAML do OKTA / Expedição

O Okta é um serviço de autenticação de terceiros que fornece integração SAML para empresas. A Expedição L2L pode ser facilmente adicionada ao Okta como uma aplicação para fornecer funcionalidade de SSO aos utilizadores da Expedição que têm contas Okta. Quando a autenticação SAML para a Expedição está ativada, a página de início de sessão da Expedição terá um botão que o utilizador pode utilizar para iniciar a autenticação SSO, ou os utilizadores podem utilizar a página inicial do Okta para aceder às aplicações configuradas.

Este documento explica como configurar a Expedição e o Okta para funcionarem em conjunto utilizando SAML para autenticação. Nos exemplos, o servidor da Expedição será acme.leading2lean.com, e Acme-L2L-Dispatch será o nome da aplicação Okta que vamos criar.

Deve ter acesso administrativo tanto à Expedição como à sua conta Okta para concluir estes passos. Os seus utilizadores já devem ter contas no Okta e será necessário atribuir-lhes esta nova aplicação.

Passo 1: Criar a configuração SAML da Expedição

Primeiro, criamos uma nova configuração SAML que define a relação de confiança SAML entre a Expedição e a aplicação Okta. Inicie sessão em acme.leading2lean.com e navegue até Configuração -> Configuração de TI -> Configuração SSO SAML em https://acme.leading2lean.com/setup/samlconfig/. Clique na ligação Adicionar novo.

Na página Adicionar nova configuração SAML, iremos introduzir as seguintes informações:

• Código: este deve ser um código único entre todas as configurações SAML da Expedição e é utilizado nos URL SAML da Expedição. Para este exemplo, usaremos o código acme-okta-sso.
• Nome apresentado: este é o texto visível para o utilizador na página de início de sessão da Expedição – neste exemplo, usaremos Dispatch ACME Okta SSO.
• Atributo de nomenclatura do utilizador do IdP: é necessário escolher como os utilizadores iniciarão sessão na Expedição. Escolher email requer que as contas de utilizador da Expedição tenham os seus endereços de e-mail definidos para o mesmo endereço de e-mail configurado nas contas dos utilizadores do Okta, e escolher username requer que o nome de utilizador da Expedição corresponda ao nome de utilizador do Okta.

Deixe todos os outros campos em branco por agora e clique em guardar. Agora clique novamente na nova configuração SAML e copie o ID da entidade SP e os URL de início do SP, pois utilizaremos ambos os URL no passo seguinte.

Passo 2: Criar a aplicação Okta

Vamos agora criar uma nova aplicação na nossa conta Okta. Faça o seguinte para criar uma nova aplicação:

• Inicie sessão no Okta como administrador
• Clique na ligação de cabeçalho Applications
• Clique no botão Add Application
• Clique na ligação Create New App
• Na caixa de diálogo Create a New Application Integration, defina a Platform como Web e escolha SAML 2.0 como Sign on method; em seguida, clique no botão Create.
• Escolha um nome para a aplicação – neste exemplo, usaremos Acme-L2L-Dispatch; em seguida, clique em Next.

Agora, no passo Configurar SAML, defina as seguintes configurações depois de decidir se pretende que os seus utilizadores iniciem sessão na Expedição com o nome de utilizador do Okta ou o endereço de e-mail:

• URL de início de sessão único – Defina-a como o SP SSO URL da Configuração SAML da Expedição
  • Utilizar para o URL do destinatário e o destino - Selecionado
• URI do público – Defina-o como o SP Entity ID da Configuração SAML da Expedição
• Formato do Name ID – Defina como Endereço de e-mail se estiver a utilizar endereços de e-mail; caso contrário, deixe como não especificado
• Nome de utilizador da aplicação – Defina como E-mail se estiver a utilizar endereços de e-mail ou escolha uma das opções de nome de utilizador.

Todos os outros campos podem ficar vazios ou com os valores predefinidos. Agora clique em Seguinte. No passo 3, selecione que é um cliente a adicionar uma aplicação interna e não é necessário definir outros campos. Clique em Concluir para guardar a Aplicação e, em seguida, clique na ligação Ver instruções de configuração. Esta nova página contém informações que precisamos de guardar na Configuração SAML da Expedição.

Passo 3: Atualizar a Configuração SAML da Expedição

Agora, na sua sessão Web da Expedição, consulte a acme-okta-sso Configuração SAML que criámos anteriormente. Vamos agora preencher os seguintes campos:

• Defina o campo IdP Entity Id para o valor Identity Provider Issuer da aplicação Okta.
• Defina o IdP SSO URL como o Identity Provider Single Sign-On URL da aplicação Okta.
• Copie a cadeia do certificado X.509 da aplicação Okta e guarde-a no campo IdP Certificate Information  da configuração SAML da Expedição como o certificado público x509 em formato PEM.

Agora clique no botão Guardar para a configuração SAML da Expedição. A sua configuração SAML está agora pronta a ser utilizada.

Passo 4: Migrar contas da Expedição para utilizar a autenticação SAML

Se precisar de migrar a maioria ou todas as suas contas da Expedição para utilizar a autenticação SAML, existem ferramentas da Expedição que tornam este processo fácil. Cada configuração SAML da Expedição tem um botão Migrar contas que lhe permite efetuar uma migração em massa de utilizadores para utilizarem a configuração SAML. Basta clicar no botão e seguir as instruções para permitir que as suas contas de utilizador se autentiquem através de SAML.