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

Note: If you have set up a custom domain name, skip this step.

• 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. Configure SharePoint in miniOrange

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



• In Choose Application Type, select SAML/WS-FED from the All Apps dropdown.



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



• In the Basic settings section, enter the Display Name.
• 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 Next.
• Now, go to the Attributes tab, and 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.
  
  
  
• Click Next to go to the Policies. Save the application first to configure the policy.



• Click the Assign Group button. In the Configure Group Assignment dialog box, select DEFAULT as the group.





• Click Next to go to the Assign Policies section. Select First Factor as Password.
• You can enable 2FA for login or allow users to log in with a standard username and password.



• Click Save.
• Once done, policies will be created for all the selected groups.

2. Configure Microsoft Graph Services

• Now, go to the Metadata tab.
• Click on the Download Federate Domain Script button under "External source as IdP".



• 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:
  Get-MgDomain -DomainId "<domain>" | Select-Object Id, AuthenticationType

3. 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 Graph 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