Fortinet white logo
Fortinet white logo

CLI Reference

system saml

system saml

Use this command to configure FortiMail to act as a SAML SSO service provider (SP).

Single sign-on (SSO) can save time by reducing how frequently people or services must log in when using many network services. Once they log in, they can access all other authorized services that use SSO until their session expires.

FortiMail supports SSO for HTTPS access to the webmail or personal quarantine and administrator GUI.

Tooltip

CalDAV and WebDAV authentication in FortiMail webmail currently do not support SSO.

In Security Assertion Markup Language (SAML) SSO, you must configure both of these to connect and authenticate with each other:

  • FortiMail, which is the service provider (SP)

  • FortiAuthenticator or other remote authentication server, which is the identity provider (IdP). See profile sso.

For details, see the FortiMail SAML SSO workflow.

Syntax

config system saml

set status {enable | disable}

set dynamic-ip-status {enable | disable}

set dynamic-ip {<client_ipv4/mask>,...}

set sp-entity-id "<entity-id_str>"

set second-sp-status {enable | disable}

set second-sp-entity-id "<entity-id_str>"

end

Variable

Description

Default

status {enable | disable}

Enable or disable SSO.

disable

dynamic-ip {<client_ipv4/mask>,...}

Enter the IdP's client IP addresses or subnet in CIDR or dotted decimal format. Separate multiple IP addresses or subnets with a comma. Spaces are not allowed. If no IP range is specified, then any IP address is allowed.

Note

For better security, only allow IdP communications from known IP addresses.

dynamic-ip-status {enable | disable}

Enable if the IdP uses dynamic client IP addresses, even within the same SAML session. (This can be useful, for example, if the IdP is deployed behind a load balancer.) Also configure dynamic-ip {<client_ipv4/mask>,...}.

disable

sp-entity-id "<entity-id_str>"

Enter the globally unique entity identifier used by the IdP to identify the FortiMail owner and SP, such as:

https://fortimail.example.com/sp

This setting may be optional, unless your IdP requires a specific name or format because it is the central control point for federated SPs. (When SSO is enabled, this setting is automatically populated using the values of hostname <host_str> and local-domain-name <name_str>.)

This setting is used for both the administrative GUI and webmail or personal quarantine access, unless second-sp-status {enable | disable} is enabled.

Caution

The entity ID is not required to be resolvable by DNS. (The entity ID is a URI, not a URL.)

second-sp-status {enable | disable}

Enable if you want to configure a different SP ACS URL and metadata for the webmail and personal quarantine service so that it is separate from the administrative GUI. (This can be useful, for example, if the IdP needs to identify those services separately.) Also configure second-sp-entity-id "<entity-id_str>".

second-sp-entity-id "<entity-id_str>"

Enter the globally unique entity identifier for FortiMail webmail when it connects to the IdP, such as:

https://fortimail.example.com/sp2

This setting is available if second-sp-status {enable | disable} is enabled.

Related topics

profile sso

system appearance

system saml

system saml

Use this command to configure FortiMail to act as a SAML SSO service provider (SP).

Single sign-on (SSO) can save time by reducing how frequently people or services must log in when using many network services. Once they log in, they can access all other authorized services that use SSO until their session expires.

FortiMail supports SSO for HTTPS access to the webmail or personal quarantine and administrator GUI.

Tooltip

CalDAV and WebDAV authentication in FortiMail webmail currently do not support SSO.

In Security Assertion Markup Language (SAML) SSO, you must configure both of these to connect and authenticate with each other:

  • FortiMail, which is the service provider (SP)

  • FortiAuthenticator or other remote authentication server, which is the identity provider (IdP). See profile sso.

For details, see the FortiMail SAML SSO workflow.

Syntax

config system saml

set status {enable | disable}

set dynamic-ip-status {enable | disable}

set dynamic-ip {<client_ipv4/mask>,...}

set sp-entity-id "<entity-id_str>"

set second-sp-status {enable | disable}

set second-sp-entity-id "<entity-id_str>"

end

Variable

Description

Default

status {enable | disable}

Enable or disable SSO.

disable

dynamic-ip {<client_ipv4/mask>,...}

Enter the IdP's client IP addresses or subnet in CIDR or dotted decimal format. Separate multiple IP addresses or subnets with a comma. Spaces are not allowed. If no IP range is specified, then any IP address is allowed.

Note

For better security, only allow IdP communications from known IP addresses.

dynamic-ip-status {enable | disable}

Enable if the IdP uses dynamic client IP addresses, even within the same SAML session. (This can be useful, for example, if the IdP is deployed behind a load balancer.) Also configure dynamic-ip {<client_ipv4/mask>,...}.

disable

sp-entity-id "<entity-id_str>"

Enter the globally unique entity identifier used by the IdP to identify the FortiMail owner and SP, such as:

https://fortimail.example.com/sp

This setting may be optional, unless your IdP requires a specific name or format because it is the central control point for federated SPs. (When SSO is enabled, this setting is automatically populated using the values of hostname <host_str> and local-domain-name <name_str>.)

This setting is used for both the administrative GUI and webmail or personal quarantine access, unless second-sp-status {enable | disable} is enabled.

Caution

The entity ID is not required to be resolvable by DNS. (The entity ID is a URI, not a URL.)

second-sp-status {enable | disable}

Enable if you want to configure a different SP ACS URL and metadata for the webmail and personal quarantine service so that it is separate from the administrative GUI. (This can be useful, for example, if the IdP needs to identify those services separately.) Also configure second-sp-entity-id "<entity-id_str>".

second-sp-entity-id "<entity-id_str>"

Enter the globally unique entity identifier for FortiMail webmail when it connects to the IdP, such as:

https://fortimail.example.com/sp2

This setting is available if second-sp-status {enable | disable} is enabled.

Related topics

profile sso

system appearance