Active Directory - SAML

Add Ebbot to your Active Directory

When a user logs into Ebbot it is done using the access management platform Keycloak. Keycloak can connect to your external Active Directory (AD) using a feature called “User Federation”. This feature makes it possible to synchronise users, groups and their roles from AD to Keycloak.

We (Ebbot) always recommend that you configure the integration of Ebbot into a test AD, if you have one. If your organisation does not have a test AD, just follow the instructions and configure the integration to production.

Prerequisites in Ebbot

If you have a contact person at Ebbot that is involved in the configuration, please add this person to your AD so that they can test the login.

Configuration

Provide us with IdP SAML entity descriptor metadata (URL from where it can be fetched or as a file). The URL can look something like this: "https://fed.client.se/federationmetadata/2007-06/federationmetadata.xml".

The federation file should include the needed attributes logging into Ebbot via AD. You will find the essential attributes below:

Attribute

Description

First name

The user’s first name

Last name

The user’s last name

Email

The user’s email address

UserID

The user’s user ID

Roles

The role that the user should have in Ebbot

Bots

The bots that the user should access in Ebbot

Skills

The skills the user should have in Ebbot

In your AD, the configuration of attributes can look something like this:


        <Subject>
            <SubjectConfirmation Method="XXXX">
                <SubjectConfirmationData InResponseTo="XXXX" NotOnOrAfter="XXXX" Recipient=“XXXX.ebbot.eu”/>
            </SubjectConfirmation>
        </Subject>
        <Conditions NotBefore="XXXX" NotOnOrAfter="XXXX">
            <AudienceRestriction>
                <Audience>https://account.ebbot.eu/realms/ebbot</Audience>
            </AudienceRestriction>
        </Conditions>
        <AttributeStatement>
            <Attribute Name="Firstname">
                <AttributeValue>Sara</AttributeValue>
            </Attribute>
            <Attribute Name="Lastname">
                <AttributeValue>Andersson</AttributeValue>
            </Attribute>
            <Attribute Name="Email">
                <AttributeValue>sara@ebbot.ai</AttributeValue>
            </Attribute>
            <Attribute Name="Roles">
                <AttributeValue>ebbot-access-role-admin</AttributeValue>
            </Attribute>
        </AttributeStatement>
        <AuthnStatement AuthnInstant="XXXXXX">
            <AuthnContext>
                <AuthnContextClassRef>urn:federation:authentication:windows</AuthnContextClassRef>
            </AuthnContext>
        </AuthnStatement>

Please note that:

  • Skills are only relevant if they are included in your Ebbot setup

  • When setting the roles, make sure that there is only one role per person

To continue the configuration, you need a SP SAML entity descriptor metadata URL from Ebbot to insert in your AD.

You can set up yourself, a colleague or your Ebbot contact person as an Ebbot user in your AD to test if the configuration was successful.

Last updated