SharePoint Single Sign-On (SAML SSO)

---

SharePoint SAML Single Sign-On (SSO) solution by miniOrange provides secure Single Sign-On access into SharePoint using a single set of login credentials. This allows organizations to secure access to their SharePoint team and easily manage user access, while also providing a seamless login experience for users.

With miniOrange SharePoint SSO, you can:

• Enable your users to automatically login to SharePoint
• Have centralized and easy access control of the users
• Connect easily with any external identity source like Azure AD, ADFS, Cognito, etc

Supported SSO Features

miniOrange SharePoint SAML integration supports the following features:

• SP Initiated SSO Login: Users can access their SharePoint account via a URL or bookmark. They will automatically be redirected to the miniOrange portal for login. Once they've signed on, they'll be automatically redirected and logged into SharePoint.
• IdP Initiated SSO Login: Users need to login to the miniOrange first , and then click on the SharePoint icon on the applications dashboard to access SharePoint.(If you have set up any more Identity Sources, you will log in to that platform).

Prerequisites

1. Sync On-Premise Active Directory with Microsoft Entra ID

NOTE: If you want to use your On-Premise Active Directory as a user store to Single Sign-On into SharePoint then follow the below steps to sync your AD and Microsoft Entra ID.

• Download the Microsoft Entra ID Connect
• Run the Microsoft Entra ID installer on your domain machine and follow the setup.

2. Verify your UPN Domain in Azure Portal

• In the Azure portal navigate to Microsoft Entra ID >> Custom domain names and click on Add custom domain.
  
• Enter the full domain name in the right pane that pops up and click on Add domain.



• A new window will open up with TXT/MX records for the domain. You will have to add the resented entry in your domain name registrar.



• Click on verify once you have added the entry

Follow the step-by-step guide given below for SharePoint Single Sign-On (SSO)

1. Setup a Custom Branded URL in miniOrange Admin Console

Single Sign-On into SharePoint requires a custom branded URL to be set. Access to miniOrange and connected resources will need to be through the custom branded URL in the format: https://<custom_domain>.xecurify.com/moas

• Login to miniOrange Admin Console.
• Click on Customization in the left menu of the dashboard.
• In Basic Settings, set the Organization Name as the custom_domain name.
• Click Save. Once that is set, the branded login URL would be of the format https://<custom_domain>.xecurify.com/moas/login

2. Configure SharePoint in miniOrange

• Login into miniOrange Admin Console.
• Go to Apps and click on Add Application button.



• In Choose Application Type click on Create App button in SAML/WS-FED application type.



• In the next step, search for Office 365. Click on Office 365 app.



• Make sure the SP Entity ID or Issuer is: urn:federation:MicrosoftOnline
• Make sure the ACS URL is: https://login.microsoftonline.com/login.srf
• Click on Next.



• Configure Name ID based on the User Store you are using:
  • Using Active Directory / miniOrange brokering service: Select External IDP Attribute from the dropdown and add objectguid in the text-box that appears.
  
  • Using miniOrange as a User Store: Select Custom Profile Attribute and select a Custom Attribute from the drop-down.
  
• Set the login policy. You can choose to enable 2FA for login or have users login using a standard username-password.
• Click on Save to configure Office 365.

3. Configure Microsoft Online Services

• Click on Select dropdown and choose Metadata.
  



• Click on the Download Federate Domain Script button under "INFORMATION REQUIRED TO AUTHENTICATE VIA EXTERNAL IDPS"



• Enter the domain name that you want to federate and click on Download. Note: You cannot federate your default "onmicrosoft.com" domain. To federate your SharePoint tenant, you must add a custom domain to SharePoint.



• After downloading the script, Open PowerShell run the federate_domain script using:
  cd ./Downloads powershell -ExecutionPolicy ByPass -File federate_domain.ps1



• Your domain is now federated. Use the commands below to check your federation settings:
  Connect-MsolService Get-MsolDomainFederationService

4. Now sign in to your Office 365 - SharePoint account with miniOrange IdP by either of the two steps:

1. Using SP initiated login :-

1. Go to Office 365 - SharePoint Login and click on sign-in
2. You will be redirected to Microsoft Online portal. Here you have to enter the UPN of the user.(It should contain the domain that is federated with miniOrange)
3. Now you will be redirected to miniOrange IdP Sign On Page.




4. Enter your login credential and click on Login. You will be automatically logged in to your Office 365 account.




2. Using IdP initiated login :-

1. Login to your miniOrange Self Service Console as an End User and click on the Office 365 icon on your Dashboard.
2. Once you click on Office 365 you don't need to enter credentials again you will be redirected to Office 365 account.

Troubleshooting

External References

• Know More about Single Sign-On (SSO)
• Read more about SAML SSO
• SharePoint SSO integration with on-premises environment
• Microsoft Apps + miniOrange