Fortinet white logo
Fortinet white logo

CLI Reference

cloud-api account

cloud-api account

Use this command to connect to Microsoft 365 and Google Workspace to access the user mailboxes. You must have domain administrator privileges to access Microsoft 365 or Google Workspace.

Syntax

config cloud-api account

edit <profile_name>

config user-filter

edit <name>

set ad-group-attr {custom | displayname | mail}

set ad-group-attr-name <string>

set ad-group-attr-value <string>

set email-group <group_name>

set ldap-group <string>

set ldap-profile <profile_name>

set pattern <string>

set status {enable | disable}

set type {ms365 | gmail}

next

end

set application-id <string>

set application-secret <password>

set description <string>

set realtime-scan-status {enable | disable}

set service-endpoint {china | germany | global | us-dod | us-gov}

set status {enable | disable}

set tenant <password>

set type {ms365 | gmail}

end

Variable

Description

Default

<profile_name>

Enter the name of the account profile.

ad-group-attr {custom | displayname | mail}

Note: This option is only available when type is set to ad-group.

Select the Azure AD group attribute.

displayname

ad-group-attr-name <string>

Note: This option is only available when type is set to ad-group and ad-group-attr is set to custom.

Enter the custom Azure AD group attribute name.

ad-group-attr-value <string>

Note: This option is only available when type is set to ad-group.

Enter the Azure AD group attribute value.

application-id <string>

Enter the application ID.

application-secret <password>

Enter the application secret or password.

description <string>

Enter a brief description of the account.

email-group <group_name>

Note: This option is only available when type is set to email-group.

Select an email group.

ldap-group <string>

Note: This option is only available when type is set to ldap-group.

Enter the LDAP group name.

ldap-profile <profile_name>

Note: This option is only available when type is set to ldap-group.

Select an LDAP group profile.

pattern <string>

Note: This option is only available when type is set to regex or wildcard.

Enter the user pattern.

realtime-scan-status {enable | disable}

Enable or disable real-time scan.

enable

service-endpoint {china | germany | global | us-dod | us-gov}

Select a regional endpoint appropriate to your geographical location.

global

status {enable | disable}

Enable or disable this user filter.

disable

status {enable | disable}

Enable or disable this account.

enable

tenant <password>

Enter the Microsoft 365 tenant credentials.

type {ms365 | gmail}

Select whether the account is Microsoft 365 or Google Workspace.

ms365

type {ad-group | email-group | imported-user | ldap-group | regex | wildcard}

Define the filter type as one of the following:

  • ad-group: Azure AD group.

  • email-group: Email group.

  • imported-user: Imported internal or external user.

  • ldap-group: LDAP group.

  • regex: User as regular expression.

  • wildcard: User as wildcard.

wildcard

cloud-api account

cloud-api account

Use this command to connect to Microsoft 365 and Google Workspace to access the user mailboxes. You must have domain administrator privileges to access Microsoft 365 or Google Workspace.

Syntax

config cloud-api account

edit <profile_name>

config user-filter

edit <name>

set ad-group-attr {custom | displayname | mail}

set ad-group-attr-name <string>

set ad-group-attr-value <string>

set email-group <group_name>

set ldap-group <string>

set ldap-profile <profile_name>

set pattern <string>

set status {enable | disable}

set type {ms365 | gmail}

next

end

set application-id <string>

set application-secret <password>

set description <string>

set realtime-scan-status {enable | disable}

set service-endpoint {china | germany | global | us-dod | us-gov}

set status {enable | disable}

set tenant <password>

set type {ms365 | gmail}

end

Variable

Description

Default

<profile_name>

Enter the name of the account profile.

ad-group-attr {custom | displayname | mail}

Note: This option is only available when type is set to ad-group.

Select the Azure AD group attribute.

displayname

ad-group-attr-name <string>

Note: This option is only available when type is set to ad-group and ad-group-attr is set to custom.

Enter the custom Azure AD group attribute name.

ad-group-attr-value <string>

Note: This option is only available when type is set to ad-group.

Enter the Azure AD group attribute value.

application-id <string>

Enter the application ID.

application-secret <password>

Enter the application secret or password.

description <string>

Enter a brief description of the account.

email-group <group_name>

Note: This option is only available when type is set to email-group.

Select an email group.

ldap-group <string>

Note: This option is only available when type is set to ldap-group.

Enter the LDAP group name.

ldap-profile <profile_name>

Note: This option is only available when type is set to ldap-group.

Select an LDAP group profile.

pattern <string>

Note: This option is only available when type is set to regex or wildcard.

Enter the user pattern.

realtime-scan-status {enable | disable}

Enable or disable real-time scan.

enable

service-endpoint {china | germany | global | us-dod | us-gov}

Select a regional endpoint appropriate to your geographical location.

global

status {enable | disable}

Enable or disable this user filter.

disable

status {enable | disable}

Enable or disable this account.

enable

tenant <password>

Enter the Microsoft 365 tenant credentials.

type {ms365 | gmail}

Select whether the account is Microsoft 365 or Google Workspace.

ms365

type {ad-group | email-group | imported-user | ldap-group | regex | wildcard}

Define the filter type as one of the following:

  • ad-group: Azure AD group.

  • email-group: Email group.

  • imported-user: Imported internal or external user.

  • ldap-group: LDAP group.

  • regex: User as regular expression.

  • wildcard: User as wildcard.

wildcard