Ir para o conteúdo

Perfil de segurança da API OAuth 2.0 de 2 pernas do Okta no Jitterbit API Manager

Introdução

Dentro de um perfil de segurança, é possível configurar o Okta como um provedor de identidade OAuth 2.0 para fornecer acesso aos consumidores da API usando a autenticação do Okta.

Esta página mostra como configurar e usar a autenticação de 2 pernas do Okta com uma API personalizada do Jitterbit, OData ou proxy, seguindo estas etapas:

  1. Configurar o Okta como um provedor de identidade
    Configure a instância do Okta como um provedor de identidade e obtenha o Público e o Escopo do Okta para usar como entrada na configuração de um perfil de segurança no API Manager.
  2. Configurar um perfil de segurança no API Manager
    Configure o Okta como o provedor de identidade no API Manager.
  3. Atribuir um perfil de segurança no API Manager
    Atribua o perfil de segurança a uma ou mais APIs personalizadas do Jitterbit, OData ou proxy.
  4. Acessar uma API com autenticação do Okta
    Os consumidores da API poderão então usar a autenticação do Okta para consumir APIs personalizadas do Jitterbit, OData ou proxy às quais o perfil de segurança está atribuído.

Para informações adicionais, consulte a documentação do Okta Visão geral do OAuth 2.0 e OpenID Connect.

Para configuração do perfil de segurança OAuth de 3 pernas do Okta, consulte Perfil de segurança da API OAuth 2.0 de 3 pernas do Okta.

1. Configurar o Okta como um provedor de identidade

  1. Faça login no Console do Desenvolvedor do Okta como um usuário com privilégios administrativos.

  2. No menu lateral do Console do Desenvolvedor do Okta, navegue até Aplicações > Aplicações, e clique no botão Criar Integração de Aplicativo.

  3. Na seção Método de Login da página Criar uma Nova Integração de Aplicativo, selecione Serviços de API e clique em Próximo.

    attachment

  4. Na seção Configurações Gerais da página Nova Integração de Aplicativo de Serviços de API, insira um nome de integração de aplicativo e clique em Salvar:

    attachment

  5. Após clicar em Salvar, o ID do Cliente e um segredo de cliente gerado são exibidos na aba Geral sob Credenciais do Cliente. Mantenha esses dados para uso posterior, pois serão necessários ao gerar um token OAuth no passo 4.

    attachment

  6. Na aba Geral sob Configurações Gerais, clique em Editar, desative Exigir Demonstração de Prova de Posse (DPoP) no cabeçalho das solicitações de token, e clique em Salvar:

    attachment

  7. Siga estas etapas para criar um escopo:

    1. No painel do Console do Desenvolvedor do Okta, navegue até Segurança > API > Servidores de Autorização e selecione o servidor apropriado. Mantenha o URI do Emissor do servidor para uso posterior.

    2. Na aba Escopos do servidor, clique em Adicionar Escopo.

    3. Na caixa de diálogo Adicionar Escopo, insira um Nome (como CustomScope) e preencha os campos opcionais conforme desejado. Mantenha o Nome que você inserir para uso posterior, pois será necessário ao configurar o perfil de segurança. Sob Metadados, selecione Incluir em metadados públicos. Clique em Criar:

      attachment

  8. Siga estas etapas para criar uma política de acesso e regra:

    1. Navegue de volta para o mesmo servidor de autorização usado ao criar um escopo.

    2. Na aba Políticas de Acesso do servidor, clique em Adicionar Política se uma já não existir.

    3. Na caixa de diálogo Adicionar Política, insira um Nome (como CustomPolicy) e preencha os campos opcionais conforme desejado. Clique em Criar Política:

      anexo

    4. Clique em Adicionar regra.

    5. Na caixa de diálogo Adicionar Regra, insira um Nome da Regra (como RegraPersonalizada) e preencha os campos opcionais conforme desejado. Os valores padrão funcionam com o Jitterbit. Clique em Criar regra:

      anexo

2. Configure um perfil de segurança no API Manager

Configure um perfil de segurança da seguinte forma:

  1. Defina Tipo de autenticação como OAuth 2.0.

  2. Defina Provedor OAuth como Okta.

  3. Ative o toggle Fluxo OAuth de 2 pernas.

  4. Opcionalmente, para testes, adicione uma credencial de cliente usando o ID do cliente e o segredo do cliente da etapa 1. Para instruções sobre como adicionar credenciais de cliente, consulte a página Perfis de Segurança.

okta 2-legged

Configure os campos restantes:

  • Escopo OAuth: Insira o nome do escopo que você especificou ao configurar o escopo no Okta. Consulte Configurar o Okta como um provedor de identidade para mais informações.

  • Domínios autorizados: Deixe este campo vazio.

  • URL de descoberta OpenID: Substitua {{SUBDOMAIN}} e yourAuthServerId pelo subdomínio do Okta e o ID do servidor da URI do Emissor do servidor de autenticação Okta escolhido da etapa 1. Por exemplo, https://example-1234.okta.com/oauth2/default se torna https://example-1234.okta.com/oauth2/default/.well-known/openid-configuration.

  • Público: Insira o público do Okta. Ele pode ser encontrado em Segurança > API na aba Configurações do servidor de autorização.

  • URL de autorização OAuth: Substitua {{SUBDOMAIN}} e yourAuthServerId pelo subdomínio do Okta e o ID do servidor da URI do Emissor do servidor de autenticação Okta escolhido da etapa 1. Por exemplo, https://example-1234.okta.com/oauth2/default se torna https://example-1234.okta.com/oauth2/default/v1/authorize.

  • URL do token OAuth: Substitua {{SUBDOMAIN}} e yourAuthServerId pelo domínio Okta e ID do servidor do Issuer URI do servidor de autenticação Okta escolhido a partir do passo 1. Por exemplo, https://example-1234.okta.com/oauth2/default se torna https://example-1234.okta.com/oauth2/default/v1/token.

  • URL de informações do usuário: Substitua {{SUBDOMAIN}} e yourAuthServerId pelo subdomínio Okta e ID do servidor do Issuer URI do servidor de autenticação Okta escolhido a partir do passo 1. Por exemplo, https://example-1234.okta.com/oauth2/default se torna https://example-1234.okta.com/oauth2/default/v1/userinfo.

  • Testar conectividade: Clique para validar o token de autenticação.

3. Atribuir um perfil de segurança no API Manager

Para usar o perfil de segurança com uma API, siga as instruções para configurar uma API personalizada, API OData ou API proxy e selecione o perfil de segurança configurado com autenticação Okta OAuth 2.0.

4. Acessar uma API com autenticação Okta

Uma vez que você tenha salvo e publicado uma API personalizada, API OData ou API proxy, sua API é acessível por URL na aplicação que chama a API usando o método de autenticação configurado.

Usar OAuth 2.0 de 2 pernas é um processo em duas etapas:

  1. Gere um token OAuth passando o ID do cliente Okta e o segredo do cliente obtidos acima no passo 1 em uma Solicitação de Token de Acesso de Credenciais de Cliente RFC6749 para o novo link URL do Token OAuth de 2 pernas exibido na página de Perfis de Segurança ou obtendo o token OAuth diretamente do Okta.

  2. Envie o token OAuth no cabeçalho da API usando o tipo de token "bearer" definido em RFC6750.

Para consumir a API, copie a URL do serviço da página APIs e use-a dentro da aplicação que faz a chamada. Você pode copiar a URL tanto da visualização em lista quanto da visualização em cartão.

Se a API suportar GET, você também pode colar a URL em um navegador da web para consumir a API manualmente.

Quando o Fluxo OAuth de 2 pernas está sendo usado, o gateway da API busca o token de acesso e a autenticação ocorre automaticamente.

Se a autenticação for bem-sucedida, a carga útil esperada é exibida no navegador da web.