Using a Deep Link with a Bookmark App to redirect to a SharePoint resource.
- SharePoint
- Microsoft Office 365
- Okta Classic Engine
To enable a direct link to a SharePoint resource, construct a link with the following main components:
- The Okta PassiveLogOnUri for Office 365
- Microsoft Office 365 parameters
- Deep link to SharePoint resource
Obtain the value of the PassiveLogOnUri for Office 365
- In the Okta dashboard, go to Applications > Microsoft Office 365 > Sign On.
- Ensure that WS-Federation is selected.
- Click on the View Setup Instructions button.
- Search for and copy the
PassiveLogOnUri, which will look like the following:
- Append the following parameter string value to the copied
PassiveLogOnUri: ?-
Deep link to SharePoint resource
This value will be equal to the SharePoint default site and aReturnUrlparameter that will target the desired landing page. - For example, if the desired result is for end users to land on the Accounting home page, the following URL would be used:
https://[[TENANT]].sharepoint.com/_forms/default.aspx?ReturnUrl=/sites/Accounting/Home.aspx - This URL needs to be double-encoded to pass it successfully as a parameter. The double-encoded value would look like:
https%253A%252F%252F[[TENANT]].sharepoint.com%252F_forms%252Fdefault.aspx%253FReturnUrl%253D%252Fsites%252FAccounting%252FHome.aspx - Combining each portion of the URL together results in an Office 365 Deep Link that can be used as a bookmark (via a Bookmark App) to link to a site within SharePoint Online directly:
-
https://[[OrgName]].okta.com/app/office365/k2y5gkdjXLYDHRTPRSZX/sso/wsfed/passive?wa=wsignin1.0&wtrealm=urn:federation:MicrosoftOnline&wctx=wa%3Dwsignin1.0%26wreply%3Dhttps%253A%252F%252F[[TENANT]].sharepoint.com%252F_forms%252Fdefault.aspx%253FReturnUrl%253D%252Fsites%252FAccounting%252FHome.aspx
NOTE: This is just an example. Please contact Microsoft for more information. The steps could change whenever a product update is released. All instructions are provided AS IS without warranty of any kind. Okta disclaims all implied warranties, including, without limitation, any implied warranties for a particular purpose.
