Ir para o conteúdo

Perfil de segurança da API OAuth 2.0 de 3 etapas 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 a consumidores de API usando a autenticação do Okta.

Esta página mostra como configurar e usar a autenticação 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 ID do cliente do Okta e o segredo do cliente que você precisará usar como entrada para configurar um perfil de segurança no API Manager.
  2. Configurar um perfil de segurança no API Manager
    Configure e teste o Okta como o provedor de identidade no API Manager. Você precisará usar o ID do cliente e o segredo do cliente obtidos na etapa anterior.
  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 de 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 2 etapas do Okta, consulte Perfil de segurança da API OAuth 2.0 de 2 etapas 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 Console do Desenvolvedor do Okta, navegue até Aplicativos > Aplicativos, e clique no botão Criar Integração de Aplicativo.

  3. Na etapa Método de Login da página Criar uma Nova Integração de Aplicativo, selecione OIDC - OpenID Connect. Para o Tipo de Aplicativo, selecione Aplicativo Web e clique em Próximo.

    attachment

  4. Na etapa Configurações Gerais da página Nova Integração de Aplicativo Web, configure as credenciais para o perfil de segurança:

    attachment

    1. Insira um Nome da Integração de Aplicativo (por exemplo, APIs do Gerenciador de API Jitterbit).

    2. Em Tipo de concessão:

      1. Se você estiver configurando OAuth de 2 pernas no perfil de segurança (usando a configuração Fluxo OAuth de 2 pernas), selecione Credenciais do Cliente em Cliente agindo em nome de si mesmo.
      2. Selecione Token de Atualização em Cliente agindo em nome de um usuário.

    3. Insira os três URIs de redirecionamento de login apropriados para sua organização e região Harmony:

      1. Insira os dois valores de URI copiados da tela de configuração do perfil de segurança (a imagem abaixo foi cortada para mostrar as áreas relevantes):

        attachment

        attachment

      2. Insira o valor de URI swagger-ui apropriado para sua região (veja Encontrando minha região):

        • NA: https://apps.na-east.jitterbit.com/api-manager/swagger-ui/oauthredirect
        • EMEA: https://apps.emea-west.jitterbit.com/api-manager/swagger-ui/oauthredirect
        • APAC: https://apps.apac-southeast.jitterbit.com/api-manager/swagger-ui/oauthredirect

    4. Limpe os URIs de redirecionamento de logout.

    5. Em Origens Confiáveis, limpe os URIs Base.

    6. Em Atribuições, atribua o grupo que você deseja (se você definir Atribuições de Grupo para seu aplicativo) ou deixe o padrão Todos. Para instruções sobre como atribuir a integração de aplicativo a usuários e grupos individuais, veja Atribuir integrações de aplicativos na documentação do produto Okta.

  5. Após clicar em Salvar, o Client ID e o Client secret são exibidos na aba Geral sob Credenciais do Cliente. Mantenha esses dados para uso posterior, pois serão necessários ao configurar o perfil de segurança:

    attachment

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

Configure um perfil de segurança da seguinte forma:

  1. Defina Tipo de Auth como OAuth 2.0.

  2. Defina Provedor OAuth como Okta.

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

okta 3-legged

Configure os campos restantes:

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.

Para consumir a API, copie sua URL de serviço da página APIs e use-a na 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 OAuth 2.0 de 3 etapas está sendo usado, o navegador redireciona para a interface de login nativa do Okta. Forneça suas credenciais para autenticar-se com o Okta.

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