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.
|
|
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 dynamic-ip-status {enable | disable}
set dynamic-ip {<client_ipv4/mask>,...}
set sp-entity-id "<entity-id_str>"
set hostname {<service_fqdn> | <service_ipv4>}
set second-sp-status {enable | disable}
set second-sp-entity-id <entity-id_str>
set second-hostname {<service_fqdn> | <service_ipv4>}
end
|
Variable |
Description |
Default |
||
|
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 |
disable |
|||
|
Enter the IdP's client IP addresses or subnet.If no IP range is specified, then any IP address is allowed. This setting applies only if
|
|
|||
|
Enter the FQDN or IP address that is the base of the SP ACS URL. That URL is where the IdP will respond to authentication requests from FortiMail services. This setting may be optional unless multiple FQDN or IP addresses exist for FortiMail or if SSO is enabled via the CLI. (When SSO is enabled via the administrative GUI and you click Apply, this setting is automatically populated using the address that is in your browser.) This setting is used in the SP ACS URL for both the administrative GUI and webmail, unless
|
|
|||
|
Enter the FQDN or IP address that is the base of the SP ACS URL. This is where the IdP will respond to authentication requests from the FortiMail webmail or personal quarantine service. This setting applies only if |
|
|||
|
Enter the globally unique entity identifier for FortiMail webmail when it connects to the IdP, such as: https://fortimail.example.com/sp2 This setting applies only if |
|
|||
|
Enable if you want to configure a different SP ACS URL and metadata for the webmail and personal quarantine service. (This can be useful, for example, if the IdP needs to identify those services separately.) Also configure |
disable |
|||
|
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 This setting is used for both the administrative GUI and webmail or personal quarantine access, unless
|
|
|||
|
Enable or disable SSO. |
disable |