Fortinet black logo

Integration API Guide

Notification via HTTPS

Notifications via HTTPS

When an incident triggers, FortiSIEM can push an XML file containing Incident details via HTTP(S) POST.

Release Added: 5.1

The FortiSIEM AONotification.xsd file shows the XML schema for incident notifications.

<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="incident">
<xs:complexType>
<xs:sequence>
<xs:element type="xs:string" name="name"/>
<xs:element type="xs:string" name="description"/>
<xs:element type="xs:string" name="displayTime"/>
<xs:element type="xs:string" name="incidentSource"/>
<xs:element name="incidentTarget">
<xs:complexType>
	<xs:sequence>
	<xs:element name="entry">
	<xs:complexType>
			<xs:simpleContent>
				<xs:extension base="xs:string">
					<xs:attribute type="xs:string" name="attribute"/>
					<xs:attribute type="xs:string" name="name"/>	
                                </xs:extension>
			</xs:simpleContent>
	</xs:complexType>
</xs:element>
	</xs:sequence>
	</xs:complexType>
	</xs:element>
<xs:element name="incidentDetails">
	<xs:complexType>
	<xs:sequence>
	<xs:element name="entry">
		<xs:complexType>
			<xs:simpleContent>
				<xs:extension base="xs:float">
					<xs:attribute type="xs:string" name="name"/>
				</xs:extension>
			</xs:simpleContent>
		</xs:complexType>
	</xs:element>
	</xs:sequence>
	</xs:complexType>
</xs:element>
	<xs:element type="xs:string" name="affectedBizSrvc"/>
	<xs:element type="xs:string" name="identityLocation"/>
	</xs:sequence>
	<xs:attribute type="xs:short" name="incidentId"/>
	<xs:attribute type="xs:string" name="ruleType"/>
		<xs:attribute type="xs:byte" name="severity"/>
		<xs:attribute type="xs:byte" name="repeatCount"/>
		<xs:attribute type="xs:string" name="organization"/>
		<xs:attribute type="xs:string" name="status"/>
		</xs:complexType>
	</xs:element>
</xs:schema>

The description of each field is as follows:

Section Field Description
Generic
incidentId Unique ID of the incident in FortiSIEM. An incident can be searched in FortiSIEM by this ID.
ruleId Unique id of the rule in FortiSIEM
vendor FortiSIEM
severity Incident severity: HIGH | MEDIUM | LOW
organization The name of the organization for which this incident occurred
status New, Update or Clear
repeatCout how many times this incident has occurred
name Name of the rule that triggered the incident
description Description of the rule including conditions under which the rule is written to trigger
displayTime Time when this incident occurred
incidentTarget Where the incident occurred, or the target of an IPS alert. It consists of attribute, name and value pairs.
attribute Parsed event attribute id
name Display name of the attribute. Common examples of attributes are srcIpAddr, destIpAddr, hostIpAddr etc.
value The attribute's value
incidentSource For security-related incidents, where the incident originated
attribute Parsed event attribute id
name Display name of the attribute. Common examples of attributes are srcIpAddr, destIpAddr, hostIpAddr etc.
value The attribute's value
incidentDetails Rule-specific details that caused the incident to trigger shown as an attribute with name and value pairs.
attribute Parsed event attribute id
name Display name of the attribute
Common examples of attributes are srcIpAddr, destIpAddr, hostIpAddr etc.
value The attribute's value
affectedBizSrvc A comma-separated list of business service names
deviceDetails Contains additional information for IP addresses in incident source or target. This information is present only if such information is discovered by FortiSIEM and shown in the Identity and Location tab.
  • ipAddr
  • hostName
  • vendor
  • model
  • version
  • users - Logged on users using this IP info obtained from Active Directory
    • userName - Active Directory login name
    • fullName - Full name of this user in Active Directory or defined manually
    • email - email address of the user in Active Directory or defined manually
    • jobTitle - jobTitle of the user in Active Directory or defined manually
    • First and last seen times for this IP address to user binding

Notification via HTTPS

Notifications via HTTPS

When an incident triggers, FortiSIEM can push an XML file containing Incident details via HTTP(S) POST.

Release Added: 5.1

The FortiSIEM AONotification.xsd file shows the XML schema for incident notifications.

<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="incident">
<xs:complexType>
<xs:sequence>
<xs:element type="xs:string" name="name"/>
<xs:element type="xs:string" name="description"/>
<xs:element type="xs:string" name="displayTime"/>
<xs:element type="xs:string" name="incidentSource"/>
<xs:element name="incidentTarget">
<xs:complexType>
	<xs:sequence>
	<xs:element name="entry">
	<xs:complexType>
			<xs:simpleContent>
				<xs:extension base="xs:string">
					<xs:attribute type="xs:string" name="attribute"/>
					<xs:attribute type="xs:string" name="name"/>	
                                </xs:extension>
			</xs:simpleContent>
	</xs:complexType>
</xs:element>
	</xs:sequence>
	</xs:complexType>
	</xs:element>
<xs:element name="incidentDetails">
	<xs:complexType>
	<xs:sequence>
	<xs:element name="entry">
		<xs:complexType>
			<xs:simpleContent>
				<xs:extension base="xs:float">
					<xs:attribute type="xs:string" name="name"/>
				</xs:extension>
			</xs:simpleContent>
		</xs:complexType>
	</xs:element>
	</xs:sequence>
	</xs:complexType>
</xs:element>
	<xs:element type="xs:string" name="affectedBizSrvc"/>
	<xs:element type="xs:string" name="identityLocation"/>
	</xs:sequence>
	<xs:attribute type="xs:short" name="incidentId"/>
	<xs:attribute type="xs:string" name="ruleType"/>
		<xs:attribute type="xs:byte" name="severity"/>
		<xs:attribute type="xs:byte" name="repeatCount"/>
		<xs:attribute type="xs:string" name="organization"/>
		<xs:attribute type="xs:string" name="status"/>
		</xs:complexType>
	</xs:element>
</xs:schema>

The description of each field is as follows:

Section Field Description
Generic
incidentId Unique ID of the incident in FortiSIEM. An incident can be searched in FortiSIEM by this ID.
ruleId Unique id of the rule in FortiSIEM
vendor FortiSIEM
severity Incident severity: HIGH | MEDIUM | LOW
organization The name of the organization for which this incident occurred
status New, Update or Clear
repeatCout how many times this incident has occurred
name Name of the rule that triggered the incident
description Description of the rule including conditions under which the rule is written to trigger
displayTime Time when this incident occurred
incidentTarget Where the incident occurred, or the target of an IPS alert. It consists of attribute, name and value pairs.
attribute Parsed event attribute id
name Display name of the attribute. Common examples of attributes are srcIpAddr, destIpAddr, hostIpAddr etc.
value The attribute's value
incidentSource For security-related incidents, where the incident originated
attribute Parsed event attribute id
name Display name of the attribute. Common examples of attributes are srcIpAddr, destIpAddr, hostIpAddr etc.
value The attribute's value
incidentDetails Rule-specific details that caused the incident to trigger shown as an attribute with name and value pairs.
attribute Parsed event attribute id
name Display name of the attribute
Common examples of attributes are srcIpAddr, destIpAddr, hostIpAddr etc.
value The attribute's value
affectedBizSrvc A comma-separated list of business service names
deviceDetails Contains additional information for IP addresses in incident source or target. This information is present only if such information is discovered by FortiSIEM and shown in the Identity and Location tab.
  • ipAddr
  • hostName
  • vendor
  • model
  • version
  • users - Logged on users using this IP info obtained from Active Directory
    • userName - Active Directory login name
    • fullName - Full name of this user in Active Directory or defined manually
    • email - email address of the user in Active Directory or defined manually
    • jobTitle - jobTitle of the user in Active Directory or defined manually
    • First and last seen times for this IP address to user binding