Pode aceder às APIs do Orchestrator utilizando tokens em vez de autenticação baseada na sessão. Enquanto superutilizador de empresa, pode gerir os tokens API. Pode criar vários tokens API para um utilizador.

Nota:
  • Para utilizadores só de leitura da empresa e utilizadores especialistas empresariais do MSP, a autenticação baseada em tokens não está ativada.
  • O superutilizador de empresa deve eliminar manualmente os utilizadores inativos do fornecedor de identidade (IdP) do Orchestrator para evitar o acesso não autorizado através do token de API.

Os utilizadores podem criar, revogar e transferir os tokens com base nas suas funções.

Para gerir os tokens API:
  1. No portal da empresa, na barra de navegação global, expanda o menu pendente Aplicações empresariais (Enterprise Applications).
  2. Selecione o serviço Definições globais (Global Settings).
  3. Navegue até Gestão de utilizadores (User Management) > Utilizadores (Users).
  4. Selecione um utilizador e clique em Modificar (Modify) ou clique na ligação do nome de utilizador. Aceda à secção Tokens API (API Tokens).
  5. Clique em Novo token API (New API Token).
  6. Na janela Novo token (New Token), introduza um Nome (Name) e Descrição (Description) para o token e escolha o Tempo de vida (Lifetime) no menu pendente.
  7. Clique em Guardar (Save). O novo token é apresentado na tabela Tokens API (API Tokens). Inicialmente, o estado do token é apresentado como Pendente (Pending). Uma vez transferido, o estado muda para Ativado (Enabled).
  8. Para transferir o token, selecione o token e clique em Transferir token API (Download API Token).
  9. Para desativar um token, selecione-o e clique em Revogar token API (Revoke API Token). O estado do token é apresentado como Revogado (Revoked).
  10. Clique em CSV para transferir a lista completa de tokens API num ficheiro em formato .csv.
  11. Quando a vida útil do token acaba, o estado muda para Expirado (Expired).
Nota: Apenas o utilizador que está associado a um token pode transferi-lo e, após a transferência, é apresentado o ID do token. Só pode transferir um token uma vez. Após a transferência do token, o utilizador pode enviá-lo como parte do cabeçalho de autorização do pedido de acesso à API do Orchestrator.
O exemplo a seguir apresenta um fragmento de amostra do código para aceder a uma API.
curl -k -H "Authorization: Token <Token>"
  -X POST https://vco/portal/
  -d '{ "id": 1, "jsonrpc": "2.0", "method": "enterprise/getEnterpriseUsers", "params": { "enterpriseId": 1 }}'
A seguir, são apresentadas as outras opções disponíveis na secção Tokens API (API Tokens):
Opção Descrição
Pesquisar (Search) Introduza um termo a procurar para procurar o texto correspondente na tabela. Utilize a opção de pesquisa avançada para restringir os resultados da pesquisa.
Colunas (Columns) Clique e selecione as colunas a serem mostradas ou ocultadas na página.
Atualizar (Refresh) Clique para atualizar a página e visualizar os dados mais atuais.