Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

In this version, Abiquo will use the same IdP configuration for all providers, for example, it will search for the same abq-role attribute to match an Abiquo role.

To configure an existing SAML integration with more IdPs, do these steps on the Abiquo Server:

  1. Save the metadata for the new IdPs, as for the first IdP

  2. For the default IdP, edit the metadata and set the Default attribute

  3. Edit the abiquo.properties file to make these changes:

    1. Add the paths to the metadata of the new IdPs as a comma separated list to the abiquo.saml.metadata.identityprovider.path property

    2. To set the default IdP, add the new abiquo.saml.metadata.identityprovider.default.id property

    3. To map the user email domains to IdPs, set the new abiquo.saml.metadata.identityprovider.userdomain.map property with a comma separated list of keys and values. For example:

      Code Block
      abiquo.saml.metadata.identityprovider.userdomain.map = example.com=https://sts.example.com/ffff2108-833e-4940-87e6-3d39ce9adb70/,abiquo.com=https://idp.example.com

...

    1. (warning) Do not use a comma

...

    1. ,

...

    1. in a key or a value

...

    1. (warning) Do not use use an equals sign

...

    1. =

...

    1. in the key

  1. Share the Abiquo SP data with the new IdPs

  2. On the UI server, edit the client-config-custom.json file and change the client.login.module property from

...

  1. SAML

...

  1. to

...

  1. SAML + user

...

  1. .
    For more details, see the examples in client-config-default.json file.

For this feature, there is a new /saml/idp endpoint idp endpoint in the Abiquo API where the UI will send a GET request with the user domain. This endpoint will return a redirect to the usual /saml/login endpoint with the appropriate IdP. Then the login will continue as for a single IdP.

Note

When you enable this feature, Abiquo will change the XML security metadata of the Abiquo application. It will add the beans for new IdPs and mark the default IdP in the metadata configuration of

“security

security-saml-generated-beans.

xml”

xml and

“security

security-saml-provided-beans.

xml”

xml.

  • Before

    the administrator upgrades

    you upgrade Abiquo,

    they

    you must back up the security beans configuration.

  • After

    an

    you upgrade Abiquo, when there is a new version of the security beans files,

    they

    you must add the default IdP and the IdP beans again