Service Target URLs (STUs)

What is a Service Target URL?

A Service Target URL is a hyperlink directly to the Glance service for a task. For example, when a Glance user visits this Service Target URL, they immediately see the page where they can enter a session code from a customer and join a session. (If the user is not yet logged in to Glance, they are prompted to log in first.)

STU STU

https://www.glance.net/agentjoin/agentjoin.aspx

When you set up Glance for your users, you can embed STUs in the web portal or application they use.

For example, to produce a hyperlink like the Join a Glance Session to give direct access to a session, add this HTML code:

<a href="https://www.glance.net/agentjoin/agentjoin.aspx">Join a Glance Session</a>

STUs without single sign-on

  • https://www.glance.net/agentjoin/AgentJoin.aspx prompts for a session key.
  • https://www.glance.net/agentjoin/AgentView.aspx?SessionKey=1234 is useful when you already know the session key. It joins the session directly. When using this STU the actual session key goes in place of 1234.

Parameters to the AgentJoin and AgentView STUs

You can add these parameters to either the AgentJoin or AgentView STUs to give the identity of the Glance user. Glance shows this identity, when it’s available, to the visitor (the person using Glance to ask for help) as the session starts.

  • name=User+Name displays the user’s personal information, including name, email, and phone number, as a courtesy to individuals using Glance to request assistance.
  • email=user@example.com displays the user’s email.
  • phone=(111)222-3333 displays the user’s telephone number.

Parameters to the AgentJoin STU

The AgentJoin URL supports optional paramaters that can be added to modify and control its behavior.

  • viewersamewindow=1 Initiates the session viewer within the same browser window that displays the session key prompt. If this parameter is omitted, Glance will launch the viewer in a new browser window by default.

These optional parameters control the prompt on the AgentJoin page. For more information, please contact Glance Customer Success.

  • mode=universaljoin
  • mode=chatinvitation
  • mode=smsinvitation

STUs with single sign-on

For accounts utilizing SAML 2.0 single sign-on, SSO-specific STUs must be used. These require an identity provider identifier, which corresponds to the account’s numeric Group ID assigned by Glance.

These examples use a Group ID of EXAMPLE. Replace EXAMPLE with your Glance Group ID or Partner ID.

Accessing any STU starts a service-provider-initiated sign-on (login) operation if the user is not yet signed on.

These STUs give direct access to sessions. When a Glance user visits one of these STUs, they immediately see the session page.

  • https://www.glance.net/agentjoin/AgentJoin.aspx?idpid=EXAMPLE prompts for a session key.
  • https://www.glance.net/agentjoin/AgentView.aspx?idpid=EXAMPLE&SessionKey=1234 is useful when you already know the session key. It joins the session directly. When using this STU the actual session key goes in place of 1234.

You may use the optional parameters mentioned earlier in this page with these STUs.

To start an interactive session on Glance’s Account Management page, use this STU:

https://www.glance.net/account/GetLoginKey.aspx?sso=1&idpid=EXAMPLE&redirect=/account/AccountSummary.aspx

To obtain a Login Key for use by native client software, the STU is:

https://www.glance.net/account/GetLoginKey.aspx?sso=1&idpid=EXAMPLE

To show a SAML single sign-on troubleshooting page, use this STU:

https://www.glance.net/account/GetLoginKey.aspx?sso=1&test=11&idpid=EXAMPLE

More information on troubleshooting single sign-on can be found here.

Alternative identifiers for your single sign-on account.

In place of idpid=EXAMPLE, you may use idpname=EXAMPLE. When this is done, Glance’s service uses a name rather than a number to look up the group. Replace EXAMPLE with your account’s group name, provided by Glance Customer Support.

In place of idpid=EXAMPLE, you may also use idptoken=TOKENVALUE. When this is done, Glance’s service uses the value you place in the Unique Account Identifier field on SAML provisioning screen. Replace TOKENVALUE with the name you put in that field. This is suitable for such things as Salesforce Organization IDs and Azure tenant unique names.

In place of idpid=EXAMPLE it is also possible to provide idpusername=USER.glance.net. When this is done, Glance’s service uses the username provided to look up the account (Glance group). This option is convenient in cases where the group name is not known but the username is. Replace USER.glance.net with the Glance username (also known as the Glance Address) of a user (any user) in the account. If you are not sure what value to use, contact Glance Customer Support.