Allow deep links (optional) - Amazon WorkSpaces Secure Browser

Allow deep links (optional)

When a user signs into WorkSpaces Secure Browser, they start the session on a home page set by the administrator. You can also allow portals to receive deep links that connect users to a specific website during a session. When a deep link is selected, the portal displays the URL specified in the deep link. The link is displayed alongside the home page(s) configured for session start, or by itself if a session is already in progress. This feature allows administrators to create more dynamic user experiences with WorkSpaces Secure Browser. To allow permission for deep links, choose Allowed when creating user settings. For more information, see Configure user settings.

Deep links open pages in a WorkSpaces Secure Browser session. If a session is already running, it will open the deep link in a new tab. If a session is not already running, it will open the deep link URL in a new tab, and the portal default home page in a separate tab. If a deep link contains more than one URL, it will display the deep link URL listed first in focus, with each subsequent URL (including the default home page) opened in separate tabs.

Deep links must meet the following requirements:

  • The portal must have deep link permissions set to Allowed. For more information, see Configure user settings.

  • The site you want to deep link to must be URL-encoded. For example, to link a user to “https://www.example.com/?query=true”, update the link to https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue.

  • Append the URL to an allow-listed portal URL in the following format, where UUID is the portal id:

    https://<uuid>.workspaces-web.com/?deepLinks=https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue

  • A deeplink can contain up to 10 URLs, delineated by comma. For example:

    https://<uuid>.workspaces-web.com/?deepLinks=https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue,https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue2,https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue3,https%3A%2F%2Fwww.example.com%2F%3Fquery%3Dtrue4

Any user you share this portal link with can manipulate the deep link value to visit a website, if that domain is reachable from the portal and not on the URL blocklist. To create a restrictive allowlist or blocklist to prevent users from visiting unintended domains with your portal, use URL filtering. The allowlist and blocklist for a portal can be edited with URL filtering in your portal’s browser settings. For more information, see Set up URL filtering and Allow or block access to websites.