Technical Tip: FortiClient EMS Cloud API
| Description | This article discusses FortiClient EMS Cloud API. |
| Scope | FortiClient EMS Cloud. |
| Solution | To use the FortiClient EMS Cloud API, the login API must be called first to obtain the session ID. After the session_id is returned from the login API, it is just necessary to call FortiClient EMS Cloud API with URL prefix: 'https://forticlient.forticloud.com/access-key' Login (get session ID by access key and account email).
{ "access_key": "access-key", "account_email": "email-address" }
{ "result": "login", "session_id": "session-id" } Call FortiClient EMS Cloud API.
{ "Authorization": session_id (the session id is returned by login), "Ems-Api-Header-Content-Type": "application/json" } For example: For FortiClient EMS Cloud serial number API "/api/v1/system/serial_number", the URL will be: 'https://forticlient.forticloud.com/fct/api/public/v1/ems_api/api/v1/system/serial_number'.
Logout.
{ "Authorization": "session-id (received from the login API)" } It is possible to get the key login with the MASTER account only to "https://forticlient.forticloud.com/"
After completing these steps, the access key can be successfully used to interact with the FortiClient EMS Cloud APIs. It is recommended to protect both the access key and the session ID and follow established security protocols. |
