This guide will walk through creating Office 365 Smart Links to direct users to specific SharePoint Online site collections or web pages when federated with Okta.

• SharePoint Online
• Single Sign-On (SSO)
• Bookmark Application
• Users under specific conditions

This configuration may be required when users need to access a specific SharePoint Online site or web page directly when using Okta Federation.

NOTE: The method of using _forms/default.aspx with a ReturnUrl is now considered deprecated and may lead to authentication issues due to changes on the Microsoft side. The recommended and more reliable method is to use a direct path to the intended SharePoint page.

1. Acquire the PassiveLogOnUri value. This can be located in the PowerShell Script on the View Setup Instructions page. For example:

• • https://[[Org]].oktapreview.com/app/office365/k2O6WLqrFk5tTfjzvFkL/sso/wsfed/passive

2. Append the required parameters. Next, append the following parameter string value to the PassiveLogOnUri: ?wa=wsignin1.0&wtrealm=urn:federation:MicrosoftOnline&wctx=wa%3Dwsignin1.0%26wreply%3D 

Using the example from the previous step, the URL should now look like this:

• • https://[[Org]].oktapreview.com/app/office365/k2O6WLqrFk5tTfjzvFkL/sso/wsfed/passive?wa=wsignin1.0&wtrealm=urn:federation:MicrosoftOnline&wctx=wa%3Dwsignin1.0%26wreply%3D

3. Add the double-encoded direct URL. Instead of using the deprecated forms URL, add a double-encoded URL that points directly to the desired landing page. For example, if the target is the Accounting home page at https://[[TENANT]].sharepoint.com/sites/Accounting/Home.aspx, double encode the URL: https://[[TENANT]].sharepoint.com/sites/Accounting/Home.aspx.

The double-encoded value would be: https%253A%252F%252F[[TENANT]].sharepoint.com%252Fsites%252FAccounting%252FHome.aspx.

4. Combine all the parts. Combine all the parts to form an Office 365 Smart Link. This Smart Link can then be used as a bookmark to access a specific SharePoint Online site directly.

Here's an example of the full Smart Link:

https://[[Org]].oktapreview.com/app/office365/k2O6WLqrFk5tTfjzvFkL/sso/wsfed/passive?wa=wsignin1.0&wtrealm=urn:federation:MicrosoftOnline&wctx=wa%3Dwsignin1.0%26wreply%3Dhttps%253A%252F%252F[[TENANT]].sharepoint.com%252Fsites%252FAccounting%252FHome.aspx

Please replace [[Org]] and [[TENANT]] with the appropriate values.

Related References

• How do I send users directly to a Sharepoint Online site with Okta?