Fortinet white logo
Fortinet white logo

FortiDLP Agent Deployment Guide

Generating FortiDLP Agent enrollment tokens

Generating FortiDLP Agent enrollment tokens

You must install and enroll the FortiDLP Agent on each device your organization wants to monitor. To get started, you will need to create an enrollment token.

When you create an enrollment token, you simultaneously create an enrollment code and enrollment bundle. The code and bundle contain configuration details for the deployment, which are required to authenticate the FortiDLP Agent on devices and enable communication with the FortiDLP Infrastructure. You can use the code or the bundle when you later complete enrollment, and the same code/bundle can be used to enroll the FortiDLP Agent on multiple devices. For more information about enrollment, see:

To limit usage, an enrollment token can have a maximum number of uses and/or an expiry. If needed, you can update a token to extend the number of uses and expiry of the associated code/bundle. For details, see Extending FortiDLP Agent enrollment tokens. Alternatively, you can generate a token with an unlimited number of uses that never expires.

Caution

It is pertinent that you protect access to enrollment codes/bundles, as they can be used to gain unauthorized access to the system.

How to generate a FortiDLP Agent enrollment token
  1. In the FortiDLP Console, on the left-hand sidebar, click .
  2. Under Agents, select the Agent deployment tab.
  3. Click Create new token.
  4. In the Create a new enrollment token dialog box, do the following:
    1. In the Description field, type a description to identify the token in the Enrollment tokens table.
    2. Optionally, to assign labels to the device(s) upon enrollment, in the Assign labels upon enrollment list, select one or more labels.
    3. Do one of the following:
      • To allow unlimited use of the token, leave the Unlimited uses toggle on.
      • To limit use of the token:
        1. Turn the Unlimited uses toggle off.
        2. In the Maximum number of uses menu:
          • To enroll one device with the token, leave the default value of 1.
          • To enroll multiple devices with the token, type or select the maximum number of devices that can be enrolled.
    4. Do one of the following:
      • To allow the token to be used indefinitely, leave the Never expire toggle on.
      • To set an expiry for the token:
        1. Turn the Never expire toggle off.
        2. In the Expiration date menu, select a date for the token's expiry.
    5. If you are generating a token for one device, in the User that this token belongs to menu, select the user's name who will access the device being monitored. You can type the first few letters of the user's name to filter the list.

    6. Note

      Users display in this menu after you either integrate with an Entra ID or LDAP directory or manually create them using the FortiDLP API.

      For Windows devices, completion of this field is optional if the user is in an LDAP directory that has already been synced with the FortiDLP Infrastructure. This is because the FortiDLP Agent uses the security identifier (SID) of the logged in domain account to identify the user.

    7. Click Create.
      The enrollment code and bundle are created.
  5. In the panel of the token, do one of the following:
    • To use the code, click Copy code.
    • To use the bundle, click Download bundle.

Generating FortiDLP Agent enrollment tokens

Generating FortiDLP Agent enrollment tokens

You must install and enroll the FortiDLP Agent on each device your organization wants to monitor. To get started, you will need to create an enrollment token.

When you create an enrollment token, you simultaneously create an enrollment code and enrollment bundle. The code and bundle contain configuration details for the deployment, which are required to authenticate the FortiDLP Agent on devices and enable communication with the FortiDLP Infrastructure. You can use the code or the bundle when you later complete enrollment, and the same code/bundle can be used to enroll the FortiDLP Agent on multiple devices. For more information about enrollment, see:

To limit usage, an enrollment token can have a maximum number of uses and/or an expiry. If needed, you can update a token to extend the number of uses and expiry of the associated code/bundle. For details, see Extending FortiDLP Agent enrollment tokens. Alternatively, you can generate a token with an unlimited number of uses that never expires.

Caution

It is pertinent that you protect access to enrollment codes/bundles, as they can be used to gain unauthorized access to the system.

How to generate a FortiDLP Agent enrollment token
  1. In the FortiDLP Console, on the left-hand sidebar, click .
  2. Under Agents, select the Agent deployment tab.
  3. Click Create new token.
  4. In the Create a new enrollment token dialog box, do the following:
    1. In the Description field, type a description to identify the token in the Enrollment tokens table.
    2. Optionally, to assign labels to the device(s) upon enrollment, in the Assign labels upon enrollment list, select one or more labels.
    3. Do one of the following:
      • To allow unlimited use of the token, leave the Unlimited uses toggle on.
      • To limit use of the token:
        1. Turn the Unlimited uses toggle off.
        2. In the Maximum number of uses menu:
          • To enroll one device with the token, leave the default value of 1.
          • To enroll multiple devices with the token, type or select the maximum number of devices that can be enrolled.
    4. Do one of the following:
      • To allow the token to be used indefinitely, leave the Never expire toggle on.
      • To set an expiry for the token:
        1. Turn the Never expire toggle off.
        2. In the Expiration date menu, select a date for the token's expiry.
    5. If you are generating a token for one device, in the User that this token belongs to menu, select the user's name who will access the device being monitored. You can type the first few letters of the user's name to filter the list.

    6. Note

      Users display in this menu after you either integrate with an Entra ID or LDAP directory or manually create them using the FortiDLP API.

      For Windows devices, completion of this field is optional if the user is in an LDAP directory that has already been synced with the FortiDLP Infrastructure. This is because the FortiDLP Agent uses the security identifier (SID) of the logged in domain account to identify the user.

    7. Click Create.
      The enrollment code and bundle are created.
  5. In the panel of the token, do one of the following:
    • To use the code, click Copy code.
    • To use the bundle, click Download bundle.