ESET PROTECT On-Prem

Off-line | Ir on-line

ESET PROTECT On-Prem – Índice

# Configurar o ESET PROTECT On-Prem REST API

Copiar URL do artigo atual Compartilhar por e-mail

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).

O que é Swagger UI?

Swagger UI é uma estrutura de código aberto que ajuda os desenvolvedores a projetar, criar, documentar e consumir serviços da Web RESTful. Usando o Swagger UI, você pode testar as chamadas API por meio de uma página da web: 1.Ative o Swagger UI nas Configurações do Servidor ESET PROTECT. 2.O built-in habilitado Swagger UI pode ser acessado em https://localhost:9443/swagger. Substitua localhost pelo nome do servidor ou endereço IP, se necessário. O Swagger UI fornece chamadas API pré-fabricadas completas. Você só precisa alterar os valores dos parâmetros nas chamadas.
|  | Swagger UI está disponível apenas em inglês.

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.

˄˅