ESET PROTECT On-Prem – 목차

ESET PROTECT On-Prem REST API 설정

아래 단계를 따라 ESET PROTECT On-Prem REST API를 설정합니다.

1.자세히 > 설정에서 REST API를 활성화합니다.

중요

•로컬 방화벽의 API 포트를 열어야 합니다.

•REST API를 사용하려면 ESET PROTECT Server의 피어 인증서(REST 서버 인증서로 사용되는지 여부와 관계없이)의 일반 이름/호스트 필드에 localhost가 포함되어 있어야 합니다. 피어(서버) 인증서가 이 요구 사항을 충족하지 않으면 새 인증서를 생성하고 서버 인증서를 변경합니다.

2.API 사용자에게 API 권한 집합을 할당합니다.

중요

관리자 계정은 API를 사용할 수 없습니다.

3.ESET PROTECT On-Prem API와의 상호작용을 자동화하려면 기본 제공 Swagger UI(ESET PROTECT On-Prem 버전 13.1부터 사용 가능)를 사용할 수 있습니다.

arrow_down_business Swagger UI란 무엇입니까?

또는 REST 클라이언트 애플리케이션(예: Postman)에 API 호출을 구현하거나 명령줄(curl)을 사용합니다.

참고

REST 서버는 ESET PROTECT Server에서 로컬로 실행됩니다. ESET PROTECT On-Prem REST API와 함께 ESET Connect를 사용할 수는 없습니다.

4.REST 서버에 로그인하려면 GetTokens 요청을 실행합니다. Swagger UI에서 GetTokens를 확장하고 > 사용해 보기를 클릭한 다음 > 요청 본문에 올바른 데이터를 입력한 후 실행을 클릭합니다.

방법

POST

함수

getTokens

URL

https://protect_server:9443/GetTokens

본문

{

"username" : "api",

"password" : "Admin.12345678",

"grant_type" : "password"

}

5.응답은 accessToken을 반환합니다. 이후 다른 API 요청에서 accessToken을 전달자 토큰(Authorization: Bearer)으로 사용할 수 있습니다. Swagger UI에서 승인을 클릭하고 > accessToken을 붙여넣은 다음 > 승인을 클릭합니다. 다른 호출을 실행할 수 있으며, Swagger UI는 각 호출에 인증 토큰을 자동으로 포함합니다.

참고

또한 ESET PROTECT On-Prem에서 이용 가능한 API 호출 예와 모든 API 호출 목록도 참조하십시오.