# Enable SSO for Multiple Applications with Different Identity Providers
In this tutorial, we will use the Datawiza Access Broker (DAB) to enable SSO for two Flask applications serving static HTML. For our scenario, one web app will be the homepage for the managers of our company, while the other web app will be the homepage for the engineers. The goal of this tutorial is to see how we can add multiple applications to a single deployment within the Datawiza Cloud Management Console (DCMC), and how we can associate different Identity Providers to each of our applications.
- Both of our applications will be running on our local docker network,
172.17.0.1. The manager homepage will run on
172.17.0.1:3001and the engineer homepage will be on
- The DAB will run on
localhostin a container and expose two ports:
9773. Traffic to either of our applications will reach DAB first and then be proxied to our applications. Traffic to
localhost:9772will be proxied to
172.17.0.1:3001and traffic to
localhost:9773will be proxied to
# Part I: Identity Provider Configuration
You will need to register each application with an Identity Provider. For this exercise, we will register the app for the managers with Azure AD and the app for the engineers with Okta. Please follow IdP Configuration Guide: Microsoft Azure AD and IdP Configuration Guide: Okta for specific configuration instructions.
# Part II: Create Deployment and Applications on Datawiza Cloud Management Console (DCMC)
After configuring your desired Identity Provider, we need to create a new deployment on the DCMC which will contain our two applications. We will also generate a keypair (
PROVISIONING_SECRET) in order for the DAB to get the latest configurations and policies from the DCMC.
# Sign Into DCMC
- Login to the DCMC.
# Create New Deployment
- Click the orange button
Get startedand specify a
# Provisioning Keys
- Create your set of provisioning keys. This enables the DCMC to verify the DAB's authenticity. Specify a
Key Nameand set the
Expiresfield to be
1 month later.
# Add Manager Application
Configure our application for the managers with the following fields:
Name: Manager App
# IdP Configuration
Microsoft Azure Active Directoryfrom the drop down menu. We'll add
Azure ADfirst, and then add
Oktaas an additional IdP later.
# Note Down Provisioning Keys
Note down your
PROVISIONING_SECRET. We will need these values later when deploying the DAB.
# Add Engineer Application
- Select the
Applicationstab. Select the orange button
Create Application. You should already see
Manager Appin the deployment.
- Configure our application for the engineers with the following fields:
You should now see both the
Manager App and the
Engineer App within the deployment.
# Assigning IdPs to our Applications
- Return to the
Applicationstab. Select the
Engineer App, and go to
IdP Configuration. Select
Assign IdP. From the drop down menu, you should see the IdPs that we have added to the DCMC. Assign
Azure ADto the
# Part III: Run DAB With Our Applications
We can use either
docker-compose to run the DAB. The following is an example of a
docker-compose.yml file. You may need to login to our container registry to download the images of the Access Broker. See Step3: Congifure DAB and SSO Integration for more details.
version: '3' services: datawiza-access-broker: # Using the latest image image: registry.gitlab.com/datawiza/access-broker:latest container_name: datawiza-access-broker restart: always ports: - "9772:9772" - "9773:9773" environment: PROVISIONING_KEY: ######################### PROVISIONING_SECRET: #########################
docker-compose -f docker-compose.yml up,
Manager App should have SSO enabled with Azure AD. Open a browser and visit
http://localhost:9772/. You should see the Azure AD login page as follows:
If you are seeing the Azure AD login page but are unable to login (Microsoft keeps asking for your username and password repeatedly), ensure that you have created a user for your AD domain. Logging in with the root account will not work. Your username should be in the form of
user@your_domain.onmicrosoft.com. Note that if you are already logged into Azure AD in your browser, you may need to logout to see the login page.
After successfully logging in, we can see our manager homepage:
To test out the engineer homepage, we visit
http://localhost:9773. We are greeted with the following Okta login page:
After successfully logging in, we can see our engineer homepage:
In summary, we have seen how to deploy the DAB and implement SSO alongside multiple applications, each using different identity providers. Please refer to Step4: Pass User Attributes and Step5: Achieve Granular Access Control to interact with the other features provided by the Datawiza Access Broker.