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

Last updated: June 19, 2026

Okta é um serviço de autenticação de terceiros que fornece integração SAML para empresas. O Despacho L2L pode ser facilmente adicionado ao Okta como um Aplicativo para fornecer funcionalidade de SSO aos usuários do Despacho que possuem contas no Okta. Quando a autenticação SAML para o Despacho estiver habilitada, a página de login do Despacho terá um botão que o usuário poderá usar para iniciar a autenticação SSO, ou os usuários poderão usar a página inicial do Okta para acessar seus aplicativos configurados.

Este documento explica como configurar o Despacho e o Okta para interoperarem usando SAML para autenticação. Nos exemplos, o servidor do Despacho será acme.leading2lean.com, e Acme-L2L-Dispatch será o nome do aplicativo do Okta que criaremos.

Você deve ter acesso administrativo ao Despacho e à sua conta do Okta para concluir estas etapas. Seus usuários já devem ter contas no Okta, e você precisará atribuir este novo aplicativo a eles.

Etapa 1: Criar a Configuração SAML do Despacho

Primeiro, criamos uma nova Configuração SAML que define a relação de confiança SAML entre o Despacho e o aplicativo do Okta. Faça login em acme.leading2lean.com e navegue até Configuração -> Configuração de TI -> SSO SAML em https://acme.leading2lean.com/setup/samlconfig/. Clique no link Adicionar novo.

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

  • Código: este deve ser um código exclusivo entre todas as Configurações SAML do Despacho e é usado nas URLs SAML do Despacho. Para este exemplo, usaremos o código acme-okta-sso.
  • Nome de exibição: este é o texto visível para o usuário na página de login do Despacho – usaremos Despacho ACME Okta SSO para este exemplo
  • Atributo de nomenclatura do usuário do IdP: você precisa escolher como os usuários entrarão no Despacho. Escolher e-mail exige que as contas de usuário do Despacho tenham seus endereços de e-mail definidos como o mesmo endereço de e-mail configurado nas contas Okta dos usuários, e escolher nome de usuário exige que o nome de usuário do Despacho corresponda ao nome de usuário do Okta.

Deixe todos os outros campos em branco por enquanto e clique em salvar. Agora clique novamente na nova Configuração SAML e copie o ID da entidade SP e as URLs de início do SP, pois usaremos ambas as URLs na próxima etapa.

Etapa 2: Criar o aplicativo Okta

Agora criamos um novo Aplicativo em nossa conta Okta. Faça o seguinte para criar um novo Aplicativo:

  • Entre no Okta como Administrador
  • Clique no link do cabeçalho Aplicativos
  • Clique no botão Adicionar aplicativo
  • Clique no link Criar novo aplicativo
  • Na caixa de diálogo Criar uma nova integração de aplicativo, defina a Plataforma como Web e escolha SAML 2.0 como o método de entrada; em seguida, clique no botão Criar.
  • Escolha um nome para o aplicativo – para este exemplo, usaremos Acme-L2L-Dispatch; em seguida, clique em Próximo.

Agora, na etapa Configurar SAML, defina as seguintes configurações depois de decidir se deseja que seus usuários entrem no Despacho com o nome de usuário do Okta ou com o endereço de e-mail:

  • URL de logon único – Defina como a URL de SSO do SP da Configuração SAML do Despacho
    • Usar isso para a URL do destinatário e a URL de destino - Marcado
  • URI do público – Defina como o ID da entidade do SP da Configuração SAML do Despacho
  • Formato do ID do nome – Defina como Endereço de e-mail se estiver usando endereços de e-mail; caso contrário, deixe como não especificado
  • Nome de usuário do aplicativo – Defina como E-mail se estiver usando endereços de e-mail ou escolha uma das opções de nome de usuário.

Todos os outros campos podem ser deixados vazios ou com seus valores padrão. Agora clique em Avançar. Na etapa 3, selecione que você é um cliente adicionando um aplicativo interno; nenhum outro campo precisa ser configurado. Clique em Concluir para salvar o aplicativo e, em seguida, clique no link Ver instruções de configuração. Esta nova página contém informações que precisamos armazenar na Configuração SAML do Despacho.

Etapa 3: Atualizar a Configuração SAML do Despacho

Agora, na sua sessão web do Despacho, visualize a Configuração SAML acme-okta-sso que criamos anteriormente. Agora preencheremos os seguintes campos:

  • Defina o campo IdP Entity Id com o valor de Identity Provider Issuer do Aplicativo Okta.
  • Defina o IdP SSO URL como o Identity Provider Single Sign-On URL do Aplicativo Okta.
  • Copie a string do Certificado X.509 do Aplicativo Okta e armazene-a no campo IdP Certificate Information  da Configuração SAML do Despacho como o Certificado Público x509 no formato PEM.

Agora clique no botão Salvar para a configuração SAML do Despacho. Sua configuração SAML está pronta para uso.

Etapa 4: Migrar Contas do Despacho para usar a Autenticação SAML

Se você precisar migrar a maioria ou todas as suas contas do Despacho para usar a autenticação SAML, existem ferramentas do Despacho para facilitar isso. Cada Configuração SAML do Despacho tem um botão Migrar Contas que permite realizar uma migração em massa de usuários para usar a Configuração SAML. Basta clicar no botão e seguir as instruções para habilitar a autenticação das suas contas de usuário usando SAML.