SAML Single Sign-On (SSO) in Blackboard (SP) | Magento – Blackboard SSO Login

Overview

Login into Blackboard using Magento user credentials. This guide will help you integrate Magento as a SAML 2.0 Identity Provider (IdP) and Blackboard as a Service Provider (SP) using the miniOrange Magento SAML IDP (Identity Provider) Extension. Magento SAML IDP extension gives you the ability to use your Magento credentials to login into Blackboard (SP). Here we will go through a step-by-step guide to configure SSO between Blackboard as SP (Service Provider) and Magento as IDP (Identity Provider).

Installation Steps

• Using Composer
• Manual Installation

• Purchase the miniOrange SAML IDP Single Sign-On extension from Magento / Adobe Commerce Marketplace.
• Go to My profile -> My Purchases
• Please ensure you are using correct access keys (My Profile - Access Keys)
• Paste the access keys in your auth.json file inside your project
• Use the below command to add the extension to your project.

  "composer require {module_name}:{version}"

• You can see the module name and list of versions in the selector below the extension name.
• Run the following commands on command prompt to enable the extension.

php bin/magento setup:upgrade

• After installation, the miniOrange Magento IDP extension will appear in the left-hand section of the dashboard.

• Download the miniOrange SAML IDP Single Sign-On extension.
• Unzip all contents of the zip inside the MiniOrange/IDPSaml directory.

{Root Directory of Magento} app code MiniOrange IDPSaml

• Run the following commands on command prompt to enable the extension

php bin/magento setup:upgrade

Prerequisites

• Login to your Blackboard site as Admin.
• Navigate to System Admin and click on Authentication.
• Select Create Provider, click on SAML and then enter the following details.

Name	Magento
Authentication Provider	Set as Active
User Lookup Method	Username
Restrict by Hostname	Select Use this provider for any host names
Link Text	Type the title for the link as you want it to appear on the Blackboard Learn login page

• Select Save and Configure.
• To configure Service Provider follow the steps given below.

Entity ID	Enter a value that describes this Blackboard Environment (i.e. 'BlackBoardProd')
Enable Automatic SSO	Checked
Single Logout Service Type	Select Post and Redirect

• Click on Generate to download the SP metadata for configuring your Magento site.
• Select the Compatible Data Sources from the list that this authentication provider should be compatible with. This is important when the authentication provider contains accounts that are shared with existing data sources. If the user exists and is associated with a data source that is not ticked the user will not be successfully authenticated.

• Select the checkbox to have the system automatically create a new account for the user if their information is not found.
• In the Error Message text box, you can provide a custom message for users in case SAML authentication doesn't work as expected.
• Select Point Identity Provider for the Identity Provider Type and enter the following details.

Metadata URL	You can get the Metadata URL from the Identity Provider Metadata of the extension
Metadata File	Upload the metadata file downloaded from Magento
Remote User ID	Select NameID as the Remote User ID

Steps to configure Blackboard SAML Single Sign-on (SSO) Login into Magento 2

Configuring Magento as SAML Identity Provider (IdP):

• In the miniOrange IDP (Identity Provider) extension, go to Applications tab.

• Search for Blackboard in the choose application searchbox and select the application.

• Enter the Application name under SP Name.

• Now, enter the SP Entity ID or Issuer and ACS URL copied earlier and save the details.

Configure Blackboard as Service Provider:

• Navigate to the Applications tab and click on Metadata settings for the Blackboard application

• Here, you can find the Identity Provider Metadata URL /XML Metadata or endpoints like IDP Entity ID, SAML Login URL, SAML Logout URL (Premium Feature), Certificate. You can also download the IdP Metadata XML file which will be used for Blackboard configuration.

• You will now have 3 options to provide the IDP Metadata to Blackboard by downloading the XML Metadata, Metadata URL or providing the detials manually.
• Option 1 - Download the XML Metadata.
• Download the XML Metadata by clicking it on Download XML Metadata button.

• Navigate to your Blackboard and upload the XML metadata file downloaded and click on the Fetch Metadata button.
• Option 2 - Provide the details manually to the Blackboard.
• Copy the metadata details according to the table below.

• Navigate to your Blackboard and paste the metadata details.

Attribute Mapping *(This is a Premium Feature)

• In the miniOrange Magento IDP extension, navigate to the Applications tab and click on Edit settings for the Blackboard application.

• Click on Add Attribute button.

• Add the attribute name you want to send to your service provider and select the attribute from the dropdown menu and click on Save Button to save changes.


You have successfully configured the SSO between Blackboard as a Service Provider and Magento as Identity Provider.




Related Articles



• What is SSO?
• What is SAML IDP SSO?
• Magento SAML SSO
• Magento as SAML IDP