QA Domain Update - SSO Settings

What is changing?

As part of our ongoing brand refresh, we are excited to share that on 3 September 2024, we updated our domain name from cloudcademy.com to platform.qa.com. As a result, we will require customers using Single Sign On (SSO) to update their Identity Provider (IdP) settings to use the new QA domain.

What is the process to update the SSO settings?

We are here to support you every step of the way to make the required updates. The required updates can be made from Wednesday 4 September 2024, please review and plan to make the changes as soon as possible before 31 December 2024.

Process steps are detailed below:

Important note: Once you have reviewed the required updates, please plan and share a proposed date and time for the update with your customer success manager.

We will then work to update the SSO settings on the agreed date and time. Please note, that the QA platform will also updated at the same time to ensure that we have configured that you have made the domain update, so this will need to be coordinated together, to ensure the SSO login flow continues to work successfully.

Important note: There will be no disruption to the existing learner login flow until you make the required update. We anticipate the changes both in your Identity Provider and on the QA platform side to take no longer than 1 hour. In case of any issues or testing required, we recommend you also communicate the date and time of the change to your learners to minimize any disruption.

What are the changes need to be made?

This update will require a change in the Identity provider (IDP) that you use for Single Sign On (SSO). Please see below specific details for Okta, Microsoft Azure (Entra), and all general notes for all other Identity Providers.

Okta

If you are using Okta as your Identity Provider, please follow the below steps to make the required update. The link to our QA app on Okta can be found here .

Steps to follow: 

1. Sign in to your Okta Identity Provider 
2. Browse to Applications > Applications. A list of applications created will appear, search for QA  
3. Browse into the Sign-On section and select Edit. 
4. Under Advanced Sign-on Settings you will find the Enable authentication against platform.qa.com domain, check it.

Microsoft Azure  

If you are using Microsoft Azure (or Entra) as your Identity Provider, please follow the below steps to make the required update.  

Steps to follow:  

1. Sign in to the Microsoft Entra admin center as at least a Cloud Application Administrator.  
2. Browse to Identity > Applications > Enterprise applications > Cloud Academy application integration page, in the Manage section, select Single sign-on.
   

3. On the Select Single sign-on method page, select SAML. 

4. On the Set up Single Sign-On with SAML page, select the pencil button for Basic SAML Configuration to edit the following setting:  

• Reply URL (Assertion Consumer Service URL)  

It needs to be changed from cloudacademy.auth0.com to platform.qa.com 

Example :  

https://cloudacademy.auth0.com/login/callback?connection=sso-1234567890 

will become

https://login.platform.qa.com/login/callback?connection=sso-1234567890 

• Sign on URL 

It needs to be changed from cloudacademy.com to platform.qa.com 

Example :

https://cloudacademy.com/login/  

will become: 

https://platform.qa.com/login/  

Logout URL (Optional)

It needs to be changed from cloudacademy.auth0.com to login.platform.qa.com 

Example :

https://cloudacademy.auth0.com/logout/  

will become:  

https://login.platform.qa.com/logout/

Other Identity Providers

If you are using an Identity Provider not listed above. Please review your SAML settings in your Identity Provider and update to use the QA domain, some of these settings may include the below.

Note: Every Identity Provider is different, so if there are other settings you are unsure how to update, please contact us.

FAQ

1. Is there any downtime for learners?  
   There will be no disruption to the existing learner login flow until you make the required update. We anticipate the changes both in your Identity Provider and on the QA platform side to take no longer than 1 hour. In case of any issues or testing required, we recommend you also communicate the date and time of the change to your learners to minimize any disruption.
   
   
2. Is there a deadline to make the required changes?
   Changes can be made from 4 September 2024. We recommend planning and updating the SSO settings as soon as possible by 31 December 2024.
   
   
3. Where can I find the updated metadata file for the Service Provider?
   

   On the agreed date and time planned by you and your customer success manager, you will be able to access the service provider details and metadata file by navigating to the SSO settings on the QA platform, and clicking on ‘View Information’ at the top of the page.

   To access the SSO settings, please check you have Admin role access or contact your customer success manager to get access.
   
   

4. Do you still have questions or unsure of the details?

   Contact your customer success manager if you have questions about this change. We are here to help!