.. _api:

API 가이드
==========

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

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

#. 상단 패널에서 **관리 > 사용자** 로 이동
#. 좌측 패널에서 **전체관리자** 를 선택
#. API Key를 생성할 **관리자명** 을 클릭
#. **로그인 설정 > API Key** 에서 **신규 키 생성** 버튼 클릭
#. **수정** 클릭

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

.. code-block:: bash

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

좀 더 자세한 사용법은 :doc:`/rest-api-guide` 를 참고하시기 바랍니다.

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

- **https://[정책서버IP]:8443/mc2/swagger/index.html**   (관리자는 정책 서버에 로그인되어야 합니다.)
- `API Reference Guide for Enterprise Edition`_
- `API Reference Guide for MSSP`_

.. _API Reference Guide for Enterprise Edition: ../api/
.. _API Reference Guide for MSSP: ../api-mssp/

.. toctree::
   :maxdepth: 1
   
   rest-api-guide