How to Deep Link

Deep links are pathways that connect users directly to a location deeper into a website, in this case the Unifyr portal. This streamlines the user experience and exposes the right content quickly. 

Deep links allow users to move between different views and applications. Here are some examples:

• Website to Application
• Application to Application
• Social Media to Application
• Email to Application
• SMS to Application

If you have SSO and would like to link your partners, users, or stakeholders directly to campaigns or assets in the Unifyr portal without having to go through the User Sign In page, you can use these deep linking recommendations. If you do not have SSO, users are required to sign in to access the page. 

To create a deep link:

1. Use one of these parameters in the link, depending upon whether you are using an IdP-initiated login link generated by your Identity Provider (IdP), or whether you are using a SP-initiated login link generated by Unifyr SSO servers.

   • RelayState parameter

     RelayState is a parameter of the SAML protocol that is used to identify the specific resource the user will access after they are authenticated and redirected to the service provider application.

     Example - https://idp.example.com/samlsso?spEntityID=zift_production&RelayState=

   • TargetResource parameter

     TargetResource is a parameter implemented by our SSO server, which will be passed through SAML RelayState for SAML SSO connections, or will be preserved through the OAuth state for OpenID Connect (OIDC) SSO connections.

     Example - https://sso-ping.ziftsolutions.com/sp/startSSO.ping?PartnerIdpId=https%3A%2F%2Fidp.example.com%2F&TargetResource=

   The examples in this article use RelayState. Note that some Identity Provider platforms may support other parameters in addition to or instead of RelayState.

2. Navigate to a URL decoder, for example https://www.urlencoder.org.

3. Generate an encoded URL for the page you want users to access, with destination character set UTF-8.

   For example, for the page https://interhelp.ziftone.com/#/marketplace/providers:

   https%3A%2F%2Finterhelp.ziftone.com%2F%23%2Fmarketplace%2Fproviders

4. Paste the encoded page URL after the resource identification parameter. The final URL will look like this:

   https://idp.example.com/samlsso?spEntityID=zift_production&RelayState=https%3A%2F%2Finterhelp.ziftone.com%2F%23%2Fmarketplace%2Fproviders