APSTOKEN parameter

Specifies the Logon Token for the current APS session.

apstoken = <token>

<token> is a string.

Example

This example uses CSP scripting to display a report when the user clicks the View Report link.

"<a target='_blank' href='viewrpt.cwr?id=" & "CurrentReportID & " & _

    apstoken=" & Server.URLEncode(LogonToken) & "'> View Report</A>"

Note:    If you are creating a hyperlink to view a report, and passing the APS token, you should use a URLEncode function to make sure that the token does not contain any illegal characters.

The resulting URL for this link looks something like this:

http://myServer/myVirtualDirectory/viewrpt.cwr?id=152&apstoken=myAPS:A1B2

Note:    Logon tokens are not encrypted. They consist of a set of numbers and letters that are assigned internally and then recognized by the APS.

Remarks

In most cases, you will want to use the APSTOKEN parameter to log on to the APS. For security reasons, it is preferable that user names and passwords are not passed across the URL.

Using a logon token also ensures that your company's licensing information is accurate. Each time a user logs on to the Crystal Enterprisesystem, the count for the number of licenses increases by one. If a logon token is not passed as a parameter, each time the user logs on to the APS (for example, the user may want to log on to a different Crystal Enterpriseclient component), the count will increment. As a result, an administrator or auditor may overestimate the number of licenses in use.

If you cannot log the user onto the APS with the APSTOKEN parameter, you can use the APSUSER, APSPASSWORD, APSAUTHTYPE parameters. You may need to use these parameters under special circumstances, such as when a user receives a report through email and needs to log on to the APS in order to view it.

For more information on logging a user on to the ASP with an APSTOKEN, see Logging on with a Logon Token in the Crystal EnterpriseTutorial.