Configurar o ESET PROTECT On-Prem REST API
Siga as etapas abaixo para configurar o ESET PROTECT On-Prem REST API:
1.Ative o REST API em Mais > Configurações.
|
•Certifique-se de abrir as portas API no seu firewall local. •Para usar o REST API, o certificado de mesmo nível do servidor ESET PROTECT (seja usado como certificado de servidor REST ou não) deve ter localhost no campo Nome comum/Host. Se o certificado de mesmo nível (Servidor) não atender a esse requisito, crie um novo certificado e altere o certificado do Servidor. |
2.Atribua os usuários API ao conjunto de permissões API.
|
A conta do administrador não pode usar o API. |
3.Para automatizar as interações com o ESET PROTECT On-Prem API, você pode usar o built-in Swagger UI (disponível desde o ESET PROTECT On-Prem versão 13.1).
Alternativamente, você pode implementar chamadas do API para o seu aplicativo cliente REST (por exemplo, Postman) ou você pode usar a linha de comando (curl).
|
O servidor REST é executado localmente no Servidor ESET PROTECT. Você não pode usar o ESET Connect com ESET PROTECT On-Prem REST API. |
4.Execute a solicitação GetTokens para entrar no servidor REST: No Swagger UI, abra GetTokens >, clique em Experimentar > forneça os dados corretos no corpo da solicitação e clique em Executar.
Método |
POST |
Função: |
getTokens |
URL |
https://protect_server:9443/GetTokens |
Corpo |
{ "username" : "api", "password" : "Admin.12345678", "grant_type" : "password" } |
5.A resposta retorna o accessToken. Você poderá usar posteriormente o accessToken em outras solicitações API como um token de portador (Authorization: Bearer). Em Swagger UI, clique em Autorizar > cole o accessToken > clique em Autorizar. Você pode executar outras chamadas, e o Swagger UI inclui automaticamente o token de autorização em cada chamada.
|
Veja também os exemplos de chamadas API e a lista de todas as chamadas API disponível em ESET PROTECT On-Prem. |