Gerando credenciais de API

Gerando credenciais de API

Este artigo fornece um guia passo a passo sobre como gerar e gerenciar credenciais de API para o portal Lenovo Device Operations (LDO). Ele abrange o processo de criação de ID do cliente e Chave secreta, obtenção de um Portador de token para autenticação e acesso a diferentes endpoints de API. Além disso, ele explica como usar a documentação do Swagger para explorar e testar métodos de API disponíveis.

Notes
Você deve ter uma conta de Administração da Organização no portal LDO para gerar credenciais de API.


Gerar credenciais de API

Antes de usar APIs do LDO, você deve gerar credenciais de API em sua conta LDO. Siga estas etapas:

  1. Clique em Insights do dispositivo no menu suspenso de navegação superior.

  2. Navegue até Configuração / Configurações do Insights de dispositivo.

  3. Clique em Credenciais de API para abrir o painel Credenciais.
    Se não houver credenciais de API, você deverá gerá-las.
  4. Clique em Gerar.
    Um ID do cliente e uma chave secreta são geradas. Você pode copiá-los para a área de transferência.
    1. Armazene essas credenciais em um local seguro e gere-as novamente periodicamente de acordo com as políticas de segurança da sua organização.
    2. Se desejar alterar as credenciais de API existentes, você deverá gerar outras.
  5. Clique em Gerar novamente. 

  6. Na janela Gerar segredo novamente, clique em Gerar novamente.

  7. Um novo ID do cliente e Chave secreta serão emitidos.

    1. O ID do cliente e a Chave secreta não expiram até que você gere outro par.
    2. Depois de gerar suas credenciais, use o URL apropriado com base na região onde os dispositivos da sua organização estão localizados.
      1. NAEA: https://auth.naea1.uds.lenovo.com
      2. UE: https://auth.euwe1.uds.lenovo.com
Info
 Depois de gerar outro par de ID do cliente e chave secreta, o par mais antigo fica inválido.

Obter um token de portador

O token de portador é um tipo de token de acesso que usa Auth 2.0 com um período de validade de 30 minutos. Para obter um novo token de acesso, seu aplicativo deve enviar esse token de portador junto com o ID do cliente para o servidor de autenticação. Esse processo de verificação garante que apenas o aplicativo autorizado (aquele para o qual o token do portador foi originalmente emitido) possa solicitar novos tokens de acesso.
  1. Gere o token de portador de API usando API externa.
  2. O URL – URL base + /api/v1/auth/<organization_name>/token
  3. O URL base depende da sua região, se NA ou EU.
  4. O corpo deve ser x-www-form-urlencoded e deve conter:
    1. grant_type: client_credentials
    2. client_secret: segredo (da página Credenciais da API)
    3. client_id: ID (da página Credenciais da API)
Notes
Gere um novo token de acesso quando ele expirar após 30 minutos


Explore as operações de API com o Swagger

O arquivo de especificações do Swagger contém uma pasta com um arquivo index.html e alguns outros arquivos JavaScript.
  1. Baixe o arquivo Swagger Specification zip que fornece detalhes sobre cada API.
  2. Extraia os arquivos na pasta.


  3. Clique duas vezes para abrir o index.html. Você vê a página inicial das APIs do Insights do dispositivo do LDO (LDI é legado) no Swagger.


  4. Gere um token de portador.

Experimente as APIs

  1. Selecione um método de API no Swagger.


  2. Use o token de autenticação na chamada.
  3. Clique em Experimentar.

 

Exemplos de métodos de API

Autenticação – sessão de token de API

 

Instantâneo do SDK da Lenovo


Resposta HTTP


 



Amostra de API negativa: Groovy ACME Test





Solicitação HTTP


Resposta HTTP


    • Related Articles

    • Gerando tíquetes de suporte

      Tíquetes de suporte O LDO é uma ferramenta poderosa repleta de recursos para oferecer suporte ao gerenciamento de dispositivos corporativos. Um recurso que se destaca para os usuários com dispositivos Lenovo é o Emissão de tíquetes de suporte do ...

    • Utilizando o gerenciamento de políticas

      O Gerenciamento de políticas fornece configurações personalizadas para organizações LDO. Esse recurso está disponível apenas para administradores de organização e administradores de MSP. Configurações do recurso Acesse Gerenciamento de políticas > ...

    • Solução de problemas e perguntas frequentes

      Não consigo fazer login no portal; meu nome de usuário ou senha está incorreta. O que devo fazer? Suas credenciais de login devem corresponder à configuração de login no Lenovo ID/Lenovo Passport. Se você ainda estiver tendo problemas para fazer ...

    • Três tendências que moldam o gerenciamento de endpoints

      O gerenciamento de endpoints está em um momento decisivo O gerenciamento de endpoints nunca foi tão crítico para empresas grandes e pequenas. A empresa média agora gerencia cerca de 135.000 dispositivos, e quase metade está em risco por causa de um ...

    • Visualização de informação do dispositivo - Sistema operacional Android

      Depois que um dispositivo Android é adicionado ao Device Management, os administradores podem ver as informações do dispositivo e executar ações básicas através do tabuleiro de dispositivos. Pode navegar até ao Tabuleiro de dispositivos seguindo este ...