Como autorizar chamadas de API no Swagger

Autorize e faça chamadas de API diretamente na interface do Orchestrator Swagger

Acesso ao Swagger

Para acessar a API Swagger do Orchestrator, anexe /swagger/index.html à URL do Orchestrator. Por exemplo, https://{yourDomain}/swagger/index.html.

A API que você vê no Swagger depende diretamente da instância do Orchestrator que você usa. Para fazer solicitações de forma fácil diretamente no Swagger, faça login no Orchestrator em outra guia.

Como obter um token de acesso

Para autorizar chamadas de API por meio da interface gráfica do Swagger para serviços do Orchestrator, execute as seguintes etapas:

1. Consulte o botão Autorizar no canto superior direito da página API do Orchestrator. Se o cadeado estiver aberto, você não está autorizado.

   Figura 1. Botão Autorizar

2. Selecionar Autorizar. A janela Autorizações disponíveis é exibida.

   Observação:

   Atualmente, oferecemos suporte a um esquema de autorização chamado OAuth2.

   Figura 2. Autorizações disponíveis

   

3. All scopes are preselected such that you can experiment with all endpoints in the Orchestrator API.

Clear them if you want to restrict access to certain APIs. 4. Select Authorize. A new window is displayed confirming you have been authorized. 5. Once done, select Close or X to close the Available authorizations window. The Authorize button shows an closed lock meaning you are authorized.

Envio de solicitações

Enquanto autorizado, você pode fazer solicitações nos recursos da API do Orchestrator da seguinte maneira:

1. Expanda um recurso de API do Orchestrator com o qual você deseja executar uma operação. O cadeado fechado significa que você está autorizado.

   Figura 3. Recurso de API não autorizado

   

2. Na janela método expandido, selecione Experimentar.

3. Especifique valores de parâmetro, se necessário.

4. Selecionar Executar. A solicitação é executada. Um cabeçalho de autorização do portador é usado automaticamente para suas solicitações.

   Figura 4. Cabeçalho de autorização do portador

   

Geração de um token de acesso

Quando o token de acesso expira, você recebe uma resposta 401: You are not authenticated! . O cabeçalho de autorização do portador ainda está presente para suas solicitações, mas o token de acesso expirou. Quando isso acontecer, você precisa invalidar o token expirado e gerar um novo token de acesso:

1. Consulte o botão Autorizar no canto superior direito da página API do Orchestrator. O bloqueio deve ser fechado.

   Figura 5. Botão Autorizar

2. Selecione Autorizar e, na página Autorizações disponíveis exibida, selecione Sair para revogar o token expirado.

   Figura 6. Autorizações disponíveis

   

3. Feche a janela Autorizações disponíveis selecionando Fechar ou X e, em seguida, obtenha um token de acesso conforme descrito na seção Obtenção de um token de acesso.

Revogar acesso

Quando terminar de trabalhar com a IU Swagger, você deve invalidar o token de acesso que você usou:

1. Consulte o botão Autorizar no canto superior direito da página API do Orchestrator. O bloqueio será fechado, ou seja, agora você está autorizado.
2. Select Authorize and on the displayed Available authorizations page, Select Logout.
3. Feche a janela Autorizações disponíveis clicando em Fechar ou no X. O botão Autorizar mostra um cadeado aberto, o que significa que você não tem autorização.