API 가이드

Genian NAC는 정책서버로 부터 원하는 정보를 얻거나 보안정책 및 각종 객체들을 설정하기 위한 REST API를 제공합니다. 외부에서 정책서버로 API를 호출하기 위해서는 API Key가 필요합니다. API Key는 각 관리자별로 생성되며 관리자에 부여된 권한에 따라 정보에 접근하거나 설정할 수 있게 됩니다.

관리자 API Key를 생성하거나 확인하기 위해서는 다음과 같이 합니다.

  1. 상단 패널에서 관리 > 사용자 로 이동

  2. 좌측 패널에서 전체관리자 를 선택

  3. API Key를 생성할 관리자명 을 클릭

  4. 로그인 설정 > API Key 에서 신규 키 생성 버튼 클릭

  5. 수정 클릭

위 과정을 통해 설정된 API Key는 다음과 같이 Request URL의 파라메터로 전달되어야 합니다.

curl -kX GET "https://nac.company.com:8443/mc2/rest/logs?apiKey={API Key}"

Note

접속 포트는 정책서버 구축 형태에 따라 다릅니다.

  • 온프레미스 : 관리 콘솔 포트인 8443 을 사용합니다.

  • 클라우드 : 443 을 사용하므로 포트를 생략합니다.

온프레미스 정책서버에 포트를 생략하고 요청하면 443(사용자 웹 포털)으로 연결되어 JSON 응답 대신 HTML 페이지가 반환됩니다.

좀 더 자세한 사용법은 REST API 활용 가이드 를 참고하시기 바랍니다.

Genian NAC에서 제공되는 API의 목록은 아래에서 확인할 수 있습니다.