Conceptual Overview

The broad steps of FastPass can be summarized into the following:

• Using the chosen library a signed URL is created.
• The URL contain all the necessary information to sign the user into Get Satisfaction.
• Optionally private key/value pairs can be contained in the URL.
• There are several methods to communicate the URL to Get Satisfaction.

Choose your preferred library

• Ruby
• PHP
• Python
• .Net
• Java

By choosing the right library for you, all data below will be pre-filled for you.

Input Fields

Method Signatures

Sample Call

Output:

Included files

• fastpass.rb - The Ruby FastPass library.

• FastPass.php - The PHP FastPass library.
• OAuth.php - Pre-requisite library for OAuth helper functions.

• fastpass.py - The Python FastPass Library
• oauth.py - pre-requisite library for OAuth helper functions

• FastPass.dll
• FastPass.cs - The .Net FastPass Library
• FastPassCLI.cs - A sample Console Application illustrating use of the FastPass dll
• OAuthBase.cs - Pre-requisite library for FastPass

• fastpass.jar - Compiled Java FastPass Library
• FastPass.java - The Java FastPass Library
• oauth-core.jar - Pre-requisite library for OAuth helper functions
• commons-codec-1.3.jar - Pre-requisite library for hashing algorithms
• commons-lang-2.4.jar - Pre-requisite library for HTML entity encoding helpers

Steps to implement FastPass

The following steps shows how to implement FastPass:

1. Download the library: ruby.tar.gz or ruby.zip
2. Unpack the code archive into your application's lib/ folder.
3. Add require 'fastpass' to environment.rb or some other initializer file.
4. Restart your server to load the FastPass code.

1. Download the library: php.tar.gz or php.zip
2. Unpack the code archive, e.g. into your PHP include path.
3. Add require_once('FastPass.php'); where necessary. (Remember to set the correct path.)

1. Download the library: python.tar.gz or python.zip
2. Unpack the code archive, e.g. into a folder on your Python search path.
3. Add import fastpass where necessary.

Method for passing user information

1. Using Cookies along with CNAME
   Set a cookie named "fastpass" to the URL generated by the FastPass library. Note: This is only available in your company is using the CNAME feature.
2. Using the Query String
   Include the generated URL in the param named "fastpass" in all links to Get Satisfaction.
3. Using JavaScript
   When a user is logged in, include:
   All links to Get Satsifaction must be JavaScript function calls to GSFN.goto_gsfn()

Debugging

We have a debugger in case you have any problems. By pasting the generated FastPass URL we can provide additional information regarding whats wrong. You can find the debugger at the FastPass management page