API Guide

Note

This feature requires Enterprise Edition

Genian NAC provides REST APIs to obtain desired information from the Policy Server or to configure security policies and various objects. An API Key is required to call the API from external sources to the Policy Server. API Keys are generated per administrator, and access to information or configurations is granted based on the permissions assigned to the administrator.

To generate or confirm an administrator API Key, follow these steps:

  1. Go to Management > User in the top panel.
  2. Select All Administrators in the left panel.
  3. Click the Administrator Name for which you want to create an API Key.
  4. In Login Settings > API Key, click the Generate New Key button.
  5. Click Update.

The API Key configured through the above process must be passed as a parameter in the Request URL as follows:

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

Note

The port depends on how the Policy Server is deployed.

  • On-premises: use 8443, the management console port.
  • Cloud: use 443, so omit the port.

If you omit the port when calling an on-premises Policy Server, the request goes to 443 (the user web portal) and returns an HTML page instead of a JSON response.

For more detailed usage, please refer to REST API Utilization Guide.

A list of APIs provided by Genian NAC can be found below: