Fortinet black logo

Administration Guide

Device profiling rules

Copy Link
Copy Doc ID 8bec453a-b242-11e9-a989-00505692583a:211969
Download PDF

Device profiling rules

Retrieve device profiling rules.

https://<servername>:8443/api/deviceprofiler/rule

Return value

Type

Description

type

String

The type to assign to hosts that match rule

notify

boolean

If true, notify sponsors

registerAutomatically

boolean

if true, automatically registers matched hosts

registerClient

boolean

if true, adds matched hosts to the Host View

registerToLoggedInUser

boolean

if true, register matched hosts to logged in user

role

String

The role to set when registering hosts that match rule

addToGroup

boolean

If true, adds matched hosts to a group

groupName

String

Group to add matched hosts to if addToGroup is true

addToContainer

boolean

If true, adds matched hosts to a domain

containerName

String

Container to add matched hosts to if addToContainer is true

enabled

boolean

methods

Methods used to match rule

description

String

Description of the rule

sponsorNote

String

weeklySchedule

Schedule for when rule should be enabled

reValidation

boolean

If true, device profiler confirms previously profiled devices still match rule

reValidationInterval

Integer

If set, device profiler confirms previously profiled devices still match rule at an interval

failedValidationAction

If set, action to take if profile devices no longer match rule

Example request

curl -k -u '<username>:<password>' -H "accept: application/xml" -X GET https://localhost:8443/api/deviceprofiler/rule?limit=1

Example XML format

<deviceProfilingRuleSearchResult>

<status>success</status>

<limit>1</limit>

<nextOffset>1</nextOffset>

<offset>0</offset>

<total>20</total>

<rules>

<rule>

<id>1</id>

<name>Mobile Device (DHCP)</name>

<type>Mobile</type>

<notify>false</notify>

<registerAutomatically>false</registerAutomatically>

<registerClient>false</registerClient>

<registerToLoggedInUser>false</registerToLoggedInUser>

<role>NAC-Default</role>

<addToGroup>false</addToGroup>

<groupName/>

<addToDomain>false</addToDomain>

<domainName/>

<enabled>false</enabled>

<methods>

<dhcpMethodData>

<enabled>true</enabled>

</dhcpMethodData>

</methods>

<description></description>

<sponsorNote></sponsorNote>

<weeklySchedule>

<alwaysOn>true</alwaysOn>

<daysOfWeek>-1</daysOfWeek>

<endTimeOfDay>-1</endTimeOfDay>

<startTimeOfDay>-1</startTimeOfDay>

</weeklySchedule>

<reValidation>false</reValidation>

<reValidationInterval>0</reValidationInterval>

<failedValidationAction><disable>false</disable></failedValidationAction>

</rule>

</rules>

</deviceProfilingRuleSearchResult>

Device profiling rules

Retrieve device profiling rules.

https://<servername>:8443/api/deviceprofiler/rule

Return value

Type

Description

type

String

The type to assign to hosts that match rule

notify

boolean

If true, notify sponsors

registerAutomatically

boolean

if true, automatically registers matched hosts

registerClient

boolean

if true, adds matched hosts to the Host View

registerToLoggedInUser

boolean

if true, register matched hosts to logged in user

role

String

The role to set when registering hosts that match rule

addToGroup

boolean

If true, adds matched hosts to a group

groupName

String

Group to add matched hosts to if addToGroup is true

addToContainer

boolean

If true, adds matched hosts to a domain

containerName

String

Container to add matched hosts to if addToContainer is true

enabled

boolean

methods

Methods used to match rule

description

String

Description of the rule

sponsorNote

String

weeklySchedule

Schedule for when rule should be enabled

reValidation

boolean

If true, device profiler confirms previously profiled devices still match rule

reValidationInterval

Integer

If set, device profiler confirms previously profiled devices still match rule at an interval

failedValidationAction

If set, action to take if profile devices no longer match rule

Example request

curl -k -u '<username>:<password>' -H "accept: application/xml" -X GET https://localhost:8443/api/deviceprofiler/rule?limit=1

Example XML format

<deviceProfilingRuleSearchResult>

<status>success</status>

<limit>1</limit>

<nextOffset>1</nextOffset>

<offset>0</offset>

<total>20</total>

<rules>

<rule>

<id>1</id>

<name>Mobile Device (DHCP)</name>

<type>Mobile</type>

<notify>false</notify>

<registerAutomatically>false</registerAutomatically>

<registerClient>false</registerClient>

<registerToLoggedInUser>false</registerToLoggedInUser>

<role>NAC-Default</role>

<addToGroup>false</addToGroup>

<groupName/>

<addToDomain>false</addToDomain>

<domainName/>

<enabled>false</enabled>

<methods>

<dhcpMethodData>

<enabled>true</enabled>

</dhcpMethodData>

</methods>

<description></description>

<sponsorNote></sponsorNote>

<weeklySchedule>

<alwaysOn>true</alwaysOn>

<daysOfWeek>-1</daysOfWeek>

<endTimeOfDay>-1</endTimeOfDay>

<startTimeOfDay>-1</startTimeOfDay>

</weeklySchedule>

<reValidation>false</reValidation>

<reValidationInterval>0</reValidationInterval>

<failedValidationAction><disable>false</disable></failedValidationAction>

</rule>

</rules>

</deviceProfilingRuleSearchResult>