ESET PROTECT On-Prem

오프라인 | 온라인으로 전환

ESET PROTECT On-Prem – 목차

# ESET PROTECT On-Prem REST API 설정

현재 문서 URL 복사 이메일로 공유

아래 단계를 따라 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부터 사용 가능)를 사용할 수 있습니다.

Swagger UI란 무엇입니까?

Swagger UI는 개발자가 RESTful 웹 서비스를 설계, 구축, 문서화 및 사용하는 데 도움이 되는 오픈 소스 프레임워크입니다. Swagger UI를 사용하면 웹 페이지를 통해 API 호출을 테스트할 수 있습니다. 1.ESET PROTECT Server 설정에서 Swagger UI를 활성화합니다. 2.활성화된 기본 제공 Swagger UI는 https://localhost:9443/swagger에서 접근할 수 있습니다. 필요한 경우 localhost를 서버 이름 또는 IP 주소로 바꿉니다. Swagger UI는 완전히 미리 만들어진 API 호출을 제공합니다. 함수 호출 시 파라미터 값만 변경하면 됩니다.
|  | 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 호출 목록도 참조하십시오.

˄˅