Fortinet white logo
Fortinet white logo

Integration API Guide

Add CMDB Device(s)

Add CMDB Device(s)

This API provides the ability to add one or more devices to CMDB. This is an asynchronous request that should be used as follows:

  • Submit the device add request. A task id will be returned

  • Get the device addition status by querying with this task id (See Get Device Add Request Status API)

Release Added 6.5.0
Input URL https://<FortiSIEM_Supervisor_IP>/phoenix/rest/device/discovery/add
Input Credentials
  • Enterprise deployments: User name and password of any FortiSIEM account that has the appropriate access. Use "super" as the organization for Enterprise deployments.
    Curl example: curl -k -u super/admin:Admin*123
  • Service Provider deployments: User name and password of Super Global account or Organization specific account and name. Make sure that the account has the appropriate access.
    Curl example with super organization: curl -k -u super/admin:Admin*123
    If querying for a specific organization, replace "super" with the organization name.
HTTP Method POST
Request Body You need to create an XML for the device attributes and pass it in the HTTP request. A sample XML file is File5_AddDeviceExample.xml and the schema file XSD is File6_device.xsd. For an explanation the attribute definitions, see Appendix - Description of Device Attributes.
Output

When the request succeeds (HTTP response code 200), a taskId will be returned. You can query Device add status using this task Id in a separate API (see Get Device Add Request Status).

<response>
      <status>Discovery xml is queued</status>
     <sourceIdentifier>RESTAPI_<TaskId></sourceIdentifier>
</response>

Add CMDB Device(s)

Add CMDB Device(s)

This API provides the ability to add one or more devices to CMDB. This is an asynchronous request that should be used as follows:

  • Submit the device add request. A task id will be returned

  • Get the device addition status by querying with this task id (See Get Device Add Request Status API)

Release Added 6.5.0
Input URL https://<FortiSIEM_Supervisor_IP>/phoenix/rest/device/discovery/add
Input Credentials
  • Enterprise deployments: User name and password of any FortiSIEM account that has the appropriate access. Use "super" as the organization for Enterprise deployments.
    Curl example: curl -k -u super/admin:Admin*123
  • Service Provider deployments: User name and password of Super Global account or Organization specific account and name. Make sure that the account has the appropriate access.
    Curl example with super organization: curl -k -u super/admin:Admin*123
    If querying for a specific organization, replace "super" with the organization name.
HTTP Method POST
Request Body You need to create an XML for the device attributes and pass it in the HTTP request. A sample XML file is File5_AddDeviceExample.xml and the schema file XSD is File6_device.xsd. For an explanation the attribute definitions, see Appendix - Description of Device Attributes.
Output

When the request succeeds (HTTP response code 200), a taskId will be returned. You can query Device add status using this task Id in a separate API (see Get Device Add Request Status).

<response>
      <status>Discovery xml is queued</status>
     <sourceIdentifier>RESTAPI_<TaskId></sourceIdentifier>
</response>