Guia da Interface de Programação de Aplicativos (API) Intel® Endpoint Management Assistant (Intel® EMA)

O guia da API Intel® EMA oferece um esboço para administradores e desenvolvedores de TI sobre a Interface de Programação de Aplicação (API) Intel® Endpoint Management Assistant (Intel® EMA).

O documento PDF fornece informações gerais para desenvolvedores sobre a interface de programação de aplicativos (API) Intel® EMA. Informações detalhadas sobre URIs de APIs individuais (como descrições e parâmetros) estão contidas nos seguintes dois arquivos HTML. Latestswagger.html contém os caminhos da API que sempre apontam para a versão da API mais recente lançada. Além disso, o arquivo de detalhes da API URI da versão 9, V9swagger.html, também é fornecido. Para visualizar essas informações detalhadas de API URI, baixe o arquivo HTML desejado e abra-o em um navegador (o Chrome funciona melhor).

Detalhes adicionais da API Intel EMA:
A API Intel® Endpoint Management Assistant (Intel® EMA) é um conjunto de interfaces programáticas desenvolvidas para permitir que desenvolvedores e administradores de TI interagem com Intel® EMA. Essa API facilita o gerenciamento e monitoramento de dispositivos de equipamentos, automatiza tarefas administrativas e integra recursos Intel® EMA em outras soluções de software.

Ambiente necessário:
Intel® EMA servidor deve estar instalado e em execução.
São necessárias permissões e credenciais de acesso à API apropriadas.

Principais recursos e recursos:

Gerenciamento de dispositivos:
Gerencie e monitore dispositivos de equipamentos remotamente.
Automação: automação de tarefas administrativas, como atualizações de software, reinicialização de dispositivos e mudanças de configuração.
Integração: integre as funcionalidades do Intel® EMA a outras soluções de software e fluxos de trabalho.
Segurança: gerencie dispositivos com segurança com mecanismos de autenticação e autorização.

Casos de uso:
Provisionamento automatizado de dispositivos: provisionamento e configuração automática de novos dispositivos.
Solução de problemas remotos: diagnostique e resolva problemas remotamente em dispositivos equipamentos.
Implantação de software: automatize a implantação de atualizações de software e patches.
Monitoramento de conformidade: certifique-se de que os dispositivos estão em conformidade com as políticas e padrões organizacionais.

Primeiros passos:

Requisitos de software:
Intel® EMA servidor deve estar instalado e em execução.
Access Permissions: são necessárias permissões e credenciais de acesso à API apropriadas. Essas permissões são descritas em detalhes no arquivo Swagger JSON.
Geração de chaves API: gere uma chave API do console Intel® EMA.
Configuração: configure as configurações de rede e certifique-se de que o servidor Intel® EMA esteja acessível.

Autenticação e segurança:

Autenticação de tokens:
Usa um nome de usuário e senha associada para uma conta Intel® EMA servidor.
Active Directory Authentication: usa credenciais do Active Directory. Ele só pode ser usado quando Intel® EMA é instalado com o modo de Autenticação de Domínio do Windows* e o servidor Intel® EMA é associado a um domínio do Active Directory.
Autenticação de Credenciais de Cliente: projetada para acesso à API ao servidor Intel® EMA. Você precisa criar uma conta client credentials e segredo do cliente no servidor Intel® EMA.
Microsoft* Entra Authentication: lançado na Intel® EMA 1.9.0, permite a autenticação da interface web Intel® EMA usando o Azure Active Directory, conhecido como Microsoft Entra.

Práticas recomendadas de segurança:
Use o HTTPS: sempre use HTTPS para criptografar dados em trânsito.
Least Privilege: concede as permissões mínimas necessárias aos usuários de API.
Hashing de senha: não armazene senhas em arquivos de texto limpo.

Tratamento de erro e solução de problemas:

Códigos de erro comuns:
400 Bad Request: parâmetros de entrada inválidos.
401 Unauthorized: Credenciais de autenticação inválidas ou ausentes.
404 Not Found: Recurso não encontrado.
500 Internal Server Error: O servidor encontrou uma condição inesperada.

Dicas de solução de problemas:
Verifique a chave API: certifique-se de que a chave API é válida e tem as permissões necessárias.
Validar Input: Verifique se os parâmetros de entrada estão corretos e formatados corretamente.
Problemas de rede: certifique-se de que não há problemas de conectividade de rede entre o cliente e o servidor Intel® EMA.