Breadcrumbs

Activating Single Sign-On via SAML in edoobox

Please note: Limited 3

The option to use SAML in your edoobox account is available starting with the Limited 3 subscription. Free support for this topic is limited. Should you require more extensive assistance, we are pleased to offer paid services.

Implementing a SAML-based Single Sign-On (SSO) solution in edoobox enables users (Super Admins, Admins, and Managers) to navigate seamlessly and securely between their Identity Provider (Microsoft Azure) and edoobox without having to log in to edoobox again or use a new password each time. This integration helps save time and enhances the security of user accounts.

What is SAML?

SAML (Security Assertion Markup Language) Identity Provider (IdP) is a security service that allows users to log in to multiple applications with a single username and password. The IdP generates secure login credentials (SAML assertions) and sends them to the Service Providers (SP) that host the applications the user wishes to access. The IdP handles user authentication and permission verification, while the SP processes the user's credentials and controls access to the applications.

SSO Activation

In the edoobox settings under SAML (SSO) , you can add a provider.

Snag_48e3f53.png
SAML (SSO) Settings: SAML Provider Management
Snag_48e6ae7.png
SAML (SSO): Add Provider

Add Provider B

Name

The name used for the login button could be, for example, "SSO Your Company Name". This naming convention serves as a clear indication to users that the button is for Single Sign-On (SSO) with your company's identity. This name can be adjusted at any time.

Fallback Rights

If you do not want to manage permissions through the authentication provider (Auth Provider), you can set the fallback permission to "No permissions " ( recommended ). This means that permissions are not automatically assigned by the authentication service, but are instead configured by edoobox.

Remote XML URL

For Remote XML URL, you must specify the provider's external federationmetadata.xml file. The APP Federation Metadata URL can be found in your Microsoft Azure account.


image-20240523-145101.png
SSO App Settings: The APP Federation Metadata URL can be retrieved here.

Rights Management

If you previously selected the option no rights under Fallback Rights, you must now activate rights management via edoobox.

Link Admin

If you select the " Link Admin " option, an admin account stored in edoobox will be linked via SAML. As soon as this person logs in via SAML, these accounts will be automatically linked. This simplifies the login process and ensures that the appropriate administrative privileges are available immediately after logging in via SAML.

Then click «Add» to add the provider.

Now open the configured provider:

Snag_5d50929.png
Added Provider: Data Mapping

You will see a summary of the data you previously entered under the " Configuration c " section.

Under " Data Field Mapping, " first name, last name, email, and ACL permissions are mapped automatically. If you want to map additional data fields, you can do so via the API, where you can configure your own mappings.

In the information section, you will find details extracted directly from the URL. This data cannot be modified unless you delete the provider and set it up again. You can download the information as a federationmetadata.xml file.

Verify that the login functions by logging in at the following URLs:

edoobox V1 login URL: https://app2.edoobox.com/login/sso/IHR-EDOOBOX-KÜRZEL/
edoobox V2 login URL: https://app2.edoobox.com/ed-admin/pages/sso/IHR-EDOOBOX-KÜRZEL/

When you click the "SSO [Your Company Name]"login button, you may receive a message stating that you were unable to log in. If this window appears, you must enter the URL displayed in the window— —as the identifier (Entity ID) with your provider (such as Azure).

Note: Redirect to SSO

If an admin is logged in with SSO and logs out or is automatically logged out by edoobox, the logged-out admin will be automatically redirected to the SSO login page and not to the regular login page. For this to function, the admin must have logged in at least once previously.

Related Guides

Keywords for this guide

SSO ¦ SAML ¦ APP Federation Metadata URL ¦ Provider