API Guide
==========

.. note :: This feature requires Enterprise Edition

Genian NAC provides the REST API to get desired information from the policy
server or to set security policy and various objects. An API key is required to
call the API from the outside to the policy server. API Keys are created for
each administrator and can be accessed or set according to the privileges
granted to the administrator.

To create or verify an administrator API Key:

#. Go to **Management > User** in the top panel
#. In the left panel, select **Administrators**
#. Click **administrator name** to generate the API Key
#. Select **Administrator** tab
#. On **API Key**, Click **Generate API Key** button
#. Click **Update** at the end of the page

The API key set through the above process should be passed as parameter of
Request URL as follows.

.. code-block:: bash

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

List of APIs provided by Genian NAC can be found below.

- **https://[Policy Server IP or FQDN]:8443/mc2/swagger/index.html**   (Admin must be authenticated to the Policy Server)
- `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/