Direct Report Linking in Urchin

Urchin 6 allows for the configuration of profiles such that no login is required to view their reports. This concept is called Direct Linking within Urchin.

Security Warning: Enabling Direct Report Linking allows users to access reports without using the built-in session-based authentication with nothing more than the name of a profile.

Enabling Direct Report Linking

1. Login to Urchin as an administrator
2. Select "Configuration" from the top-right menu
3. Expand the "Settings" category from the left menu
4. Select Global Settings
5. Within the default "Access Settings" tab, select On for "Direct Report Linking"
6. Click "Update" to save the changes

Basic Report Linking

The basic format for Direct Report Linking is to type in a URL formatted as:

baseurl/report.cgi?profile=profilename&user=username

Where baseurl is the base URL used to access Urchin, profilename is the URI-escaped name of the profile, and username is the name of the user to use. The username specified only controls language and localization settings and is optional. If no user is specified, the admin user is assumed.

Direct Report Linking Example

Say you usually access your stats at http://stats.mysite.com and you log in as jdoe. To direct link to the mysite.com profile using jdoe's localization settings, the following URL would be used:

http://stats.mysite.com/report.cgi?profile=mysite.com&user=jdoe

Additional Query Parameters

The following query parameters may be appended to the end of the direct link URL for more options.

vid - The report ID. To figure out what the report ID is for a given report, you may:

• consult the .rs2 file in the appropriate profiletype directory, OR
• hover your cursor over the report title in the menu and look in the browser's status bar. The first parameter passed to the JavaScript function is the report ID.

bd - Start of date range: YYYYMMDD, WITH
ed - End of date range: YYYYMMDD

Direct Report Linking with Custom Reports

If you would like to direct link to a specific, filtered report, may do so by creating a custom report with the filtered subset of data built into the .rs2 file. Then, just set the vid parameter in the direct link URL to your new custom report.