Cisco Cisco Email Security Appliance C190 Leaflet

Cisco AsyncOS API for Email - 시작 가이드

  AsyncOS API 요청 및 응답

인증

API 사용자는 모든 API 요청에 base64 인코딩 형식으로 ESA 사용자 이름과 비밀번호를 제출해야 합
니다. 요청의 Authorization 헤더에 유효한 인증서가 없을 경우 API는 401 오류 메시지를 보냅니다. 

인증서를 base64 인코딩 형식으로 변환하는 데 어떤 base64 라이브러리도 사용할 수 있습니다. 다
음 표에는 base64 인코딩 인증서의 예가 나와 있습니다.

참고

인코딩된 인증서는 헤더 내에 한 줄에 있어야 합니다.

AsyncOS API 요청 및 응답

AsyncOS API 요청

API에 대한 요청은 다음과 같은 특성이 있습니다.

요청은 HTTP 또는 HTTPS를 통해 전송됩니다.

각 요청은 

https://{appliance}:{port}/api/v1.0/{resource}?{resource_attributes}

 형식

의 유효한 URI를 포함해야 합니다. 여기서

{appliance}:{port}

는 어플라이언스의 FQDN 또는 IP 주소이고 어플라이언스가 수신하는 

TCP 포트 번호입니다.

{resource}

는 액세스하려는 리소스(예: 보고서 또는 카운터)입니다. 

{resource_attributes}

는 리소스에 대해 지원되는 특성(예: 기간, 최대값 등)입니다.

각 요청은 base64 인코딩 형식의 유효한 권한 부여 헤더를 포함해야 합니다. 

각 요청에서는 Accept가 

application/json

으로 설정되어야 합니다.

(사용자 자체 인증서를 사용하여) HTTPS를 통해 보내진 요청은 사용자의 CA 인증서를 포함
해야 합니다. 예를 들어 cURL의 경우 다음과 같이 API 요청에서 CA 인증서를 지정할 수 있습
니다.

curl --cacert <ca_cert.crt> -u "username:password" 

https://<fqdn>:<port>/api/v1.0/{resource}?{resource_attributes}

참고

API 요청은 대/소문자를 구분하며 본 가이드에 표시된 대로 입력해야 합니다.

항목

값

Username

administrator

Password

Password$123

인증서

administrator:Password$123

Base64 인코딩 인증서

YWRtaW5pc3RyYXRvcjpQYXNzd29yZCQxMjM=