Home Single Sign On (SSO) How to configure SSO (Single Sign-on)

How to configure SSO (Single Sign-on)

Last updated on Nov 12, 2024

To improve the experience for end users the platform allows you to connect your active directory to allow Single Sign on. This guide will show you how to set this up on all of the main active directory providers (Microsoft Azure and Google Workspace).

Only owners of the learning platform have the ability to configure single sign-on, so please ensure you have the relevant access.

Also, the single sign-on we currently provide is just-in-time provisioning and will not auto setup users as soon as they are created on your active directory users will need to engage with the learning portal by selecting "Login" for an account to be created if there isn't one already.

The feature of auto-provisioning (SKIM) is currently in development, but not available as of yet.

When you have successfully configured SSO the login screen will look like the below screenshot and by users selecting "Login" this will automatically SSO them into the platform. If there are any users that aren't on your active directory they can use the "Direct Login" feature below the login button.

sso-1

To get started and see your unique configuration settings please select "Organisation" >> "Single-Sign-On" this will then present you with the links you need to input on your active directory along with the details you need to populate to link the two systems.

sso-2

Microsoft Azure

Create an application for Bob's Business:

  1. In Azure Active Directory, click “View” under “Manage Azure Active Directory”.

  2. In the left-hand menu, click “Enterprise applications”.

  3. Select “New application”.

  4. Click “Create your own application”.

  5. Enter the name of your application (e.g. Bob's Business), and then click “Create”. Once the
    application is created, you will be taken to the “Enterprise Application Overview” page.

Enable SSO for the application:

  1. On the Overview page of the application that was created, click “Single Sign On” in the left
    hand menu

  2. Click “SAML”.

  3. This will take you to the “Set up Single Sign-On with SAML” page.

  4. In the “Basic SAML Configuration'' panel, click “Edit”.

  5. You will need to complete and save the following URL fields (found on the “Organisation >
    Single Sign On” page in the Bob's Business portal) :

○ Entity ID = https://yourorganisation.trainingpost.com/sso/metadata
○ Reply URL = https://yourorganisation.trainingpost.com/sso/acs
○ Sign On URL = https://yourorganisation.trainingpost.com/sso/login
○ Logout URL = https://yourorganisation.trainingpost.com/sso/logout

Note- Do not use the exact links above they are examples, make sure to find your links (found on the “Organisation > Single Sign On” page in the Bob's Business portal).

Next, you need to tell Bob's Business about your Active Directory service.

  1. In the Bob's Business portal select “Organisation > Single Sign On”.

  2. Toggle on “Enable Single Sign On”.

  3. Enter the following details from the Application you just made in Active Directory:

○ Login URL

○ Azure AD Identifier

○ Logout URL

○ Certificate (Base 64 Version - Open it in Notepad and copy the text)

  1. Click “Save”.

Granting Permission for users to use the SSO application in Azure

To ensure users do not receive the following error message (due to them not having access to the application you have created in Azure).

sso-error-1

Within the enterprise application on Azure be sure to select "Users and Groups" and make sure all of your staff have access to login including any new starters.

sso-error-2

To test that SSO is working, please head over to your portal login page and try signing in.

If this has worked we then recommend importing all of the users silently via the Bob's Business portal so all of your staff are pre-loaded and ready to go.

Google Workspace

  1. In Google Workspace, go to Apps -> Web and mobile apps

  2. Select ‘Add custom SAML app’

google-sso-1

  1. Copy all of the following fields:

google-sso-2

  1. In your Bob's Business portal, go to "Organisation" >>"Single Sign On"  and turn on Single Sign On.

google-sso-8

  1. Enter the copied SSO URL (Login URL), Entity ID and Certificate into here:

google-sso-3

  1. Take the ACS URL and Entity ID from the bottom of Configuration Settings

google-sso-4

  1. Paste these into the Service Provider Details in these fields:

google-sso-5

  1. Set the NameID format as per the screenshot below:

google-sso-6

  1. Finally set the following attributes on this screen:

google-sso-7

First Name -> http://schemas.microsoft.com/identity/claims/displayname
Primary Email -> http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress

OKTA

  1. In Okta Admin space go to Applications and click Create App Integration

  2. In another tab, go the the LMS, and click on Organisation and then Single Sign On

  1. Copy the URLs from the LMS configuration settings into the SAML settings. The single sign on URL is the Reply URL (ACS) and Entity ID is the Audience URI 

  1. Set the name ID format to “persistent” and the username to “Email”

  1. Configure the attribute statements as below:

The name must be as follows:

  1. Confirm the settings and then click “View SAML setup instructions”

  1. Copy paste the details on this page into the LMS

  2. The sign out URL can be found on the Sign On page in SAML metadata details

If you have any questions or need assistance please email support@bobsbusiness.co.uk and we would be happy to help