Web Office to External App

Generate an encrypted token you can add to a navigation link for the Web Office. The links/tokens generate within the security scope of a logged-in Web Office Associate. When the user clicks the link, the target website confirms the token using this method. When successful, the method returns the Associate's information indicating the token belongs to them.

CustomerId: 45678
ExternalReferenceId: ABC123
DisplayName: John Doe
Username: jonedoe45
EmailAddress: [email protected]
BackOfficeId: 15F92

Endpoint: Get Customer for SSO Token

Request URL: https://www.company.com/examplepath?token={DirectScale:Token}

Add the SSO link to the Web Office navigation bar by using the Web Office Admin > Site Navigation page. You must include the {DirectScale:Token} variable in the URL using the in the token parameter. For example, https://www.company.com/admin?token={DirectScale:Token}

⚠️Important

The token remains valid for ONE MINUTE.

❗️Warning

For security purposes, do this process in the back-end, not with JavaScript in the browser.



Sign-in Process

A logged-in Web Office user clicks the SSO link, which calls the DirectScale server, and generates a link to the external application with a short-lived token substituted in the URL. The browser then redirects to the external application with the DirectScale token added to the URL. The external application calls the DirectScale API to get the user information from the token. The Public API endpoint it uses is https://dsapi.directscale.com/v1/sso/?token={token}

The external application returns its page to the Associate with the session established.