Integrating Get Satisfaction Fastpass with Laravel

Here is an overview of what is involved in getting your Laravel 4 apps authentication system to integrate with Get Satisfaction Fastpass for single sign on.

What I am using

Install the Fastpass PHP SDK

***Create a folder to install the library in

$ mkdir app/lib
$ mkdir app/lib/getsatisfaction

Download & untar/unzip the Fastpass PHP SDK

cd app/lib/getsatisfaction
wget "https://getsatisfaction.com/fastpass/php.tar.gz"
tar -zxvf php.tar.gz .

Update composer.json adding the location of the library

In the autoload section add the path app/lib/getsatisfaction

"autoload": {
        "classmap": [
            "app/commands",
            "app/controllers",
            "app/models",
            "app/database/migrations",
            "app/database/seeds",
            "app/tests/TestCase.php",
            "app/lib/getsatisfaction"
        ]
    },

In the console run

$ composer update
$ php artisan dump-autoload

Create a configuration file (e.g. app/config/getsatisfaction.php ) to hold your API tokens for the Fastpass service

<?php

return array(
    'key' => '<your fastpass key>',
    'secret' => '<your fastpass secret>',
    'domain' => '<your domain for your get satisfaction commmunity>',
);

The above information can be found in the admin section once you log in as administrator on http://getsatisfaction.com.

Create a login screen for Single Sign on

We now need to create a login form to be used by the Fastpass service to use our authentication service provided by sentry to log users into Get Satisfaction.

First we create a new controller app/controllers/SatisfactionController.php

<?php

use App\Services\Validators\UserValidator;
use Cartalyst\Sentry\Users;

class SatisfactionController extends BaseController
{
    /**
     * Authenticate the user
     *
     * @author Salar Rahmanian
     * @link   http://www.softinio.com
     *
     *
     * @return Response
     */
    public function postLogin()
    {
        $remember = Input::get('remember_me', false);
        $userdata = array(
            Config::get('cartalyst/sentry::users.login_attribute') => Input::get('login_attribute'),
            'password'                                             => Input::get('password')
        );
        try {
            // Log user in
            $user = Sentry::authenticate($userdata, $remember);
        } catch (LoginRequiredException $e) {
            return Redirect::back()->withInput()->with('error', $e->getMessage());
        } catch (PasswordRequiredException $e) {
            return Redirect::back()->withInput()->with('error', $e->getMessage());
        } catch (WrongPasswordException $e) {
            return Redirect::back()->withInput()->with('error', $e->getMessage());
        } catch (UserNotActivatedException $e) {
            return Redirect::back()->withInput()->with('error', $e->getMessage());
        } catch (UserNotFoundException $e) {
            return Redirect::back()->withInput()->with('error', $e->getMessage());
        } catch (UserSuspendedException $e) {
            return Redirect::back()->withInput()->with('error', $e->getMessage());
        } catch (UserBannedException $e) {
            return Redirect::back()->withInput()->with('error', $e->getMessage());
        } catch (Exception $e) {
            return Redirect::back()->withInput()->with('error', $e->getMessage());
        }

        Event::fire('users.login', array($user));

        // Log user into Get Satisfaction service
        return View::make('satisfaction.index', compact('user'));
    }

    /**
     * Show the login form
     *
     * @author Salar Rahmanian
     * @link   http://www.softinio.com
     *
     * @return Response
     */
    public function getLogin()
    {
        // Check to see if user logged in, if not show login form
        if (!\Sentry::check()) {
            $login_attribute = Config::get('cartalyst/sentry::users.login_attribute');
            return View::make('satisfaction.login', compact('login_attribute'));
        }

        // user already logged in so log them into Get Satisfaction service
        $user = \Sentry::getUser();

        return View::make('satisfaction.index', compact('user'));
    }
}

Now we need to create the two views used by this controller, one with a login form and one view which logs the user into the get satisfaction service.

**For the login form we create the view ** app/views/satisfaction/login.blade.php

This can be a copy of the login form you currently use within your Laravel app but with the form action changed to use the new SatisfactionController.

@extends('layouts.master')

@section('h1')
<h1>Sign In</h1>
@stop

@section('crumb')
    <li><a href="{{ url('/satisfaction/index') }}">User</a></li>
    <li class="active">Login</li>
@stop

@section('title')
Sign In -
@stop

@section('container')
<div class="row">
    <div class="col-lg-offset-2 col-lg-6 col-md-offset-2 col-md-6">
        {{ Former::horizontal_open(url('/satisfaction/login')) }}

            {{ Former::text('login_attribute', 'User Name',Input::old('login_attribute'))->required() }}

            {{ Former::password('password', 'Password')->required() }}
            {{ Former::checkbox('remember_me','&nbsp;')->text('Remember me on this computer') }}


        <div class="col-lg-offset-3 col-sm-offset-4 col-lg-9 col-sm-8">
            {{ Former::primary_submit('Log in') }}
            <a href="{{ URL::route('user.register') }}" class="pull-right">Register Here</a>
        </div>



        </form>
    </div>
</div>
@stop

We create the view that logs user into Get Satisfaction app/views/satisfaction/index.blade.php

This is in effect a blank html document which calls the php class from the Fastpass library to log the current user into the Get Satisfaction service.

<!DOCTYPE html>


{{    \FastPass::$domain = \Config::get('getsatisfaction.domain'); }}
{{    \FastPass::script(\Config::get('getsatisfaction.key'),
                      \Config::get('getsatisfaction.secret'),
                     $user->email,
                     $user->username,
                     $user->id,
                     true
                     ); }}

<html lang="en" class="env_<?php echo App::environment(); ?>">
    <head>
        <meta charset="utf-8">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <meta name="description" content="">
        <meta name="author" content="">
        <link rel="shortcut icon" href="/assets/ico/favicon.png">

        <title>@yield('title') softinio.com </title>

        <!-- Bootstrap core CSS -->
        {{ basset_stylesheets('bootstrap','application') }}

        <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
        <!--[if lt IE 9]>
        {{ basset_javascripts('html5') }}
        <![endif]-->
    </head>


    <body>

    </body>
</html>

The users email , username and user id provided by Sentry are used to create and log user into the Get Satisfaction service. The username is what will be displayed as the logged in user on Get Satisfaction website so if you prefer something else you can substitute username for what you prefer.

Update your app/routes.php file

Route::get('satisfaction/login', 'SatisfactionController@getLogin');
Route::post('satisfaction/login','SatisfactionController@postLogin');

Update Get Satisfaction with your login URL

Based on the new route you created for the SatisfactionController your URL to your single sign on should be

http://<yourdomain where your laravel app is>/satisfaction/login

Log into Get Satifaction as admin, click the wheel settings menu, select Configure then select Fastpass. Here set your External Login URL to this and click save.

Whilst you are logged in as admin you can also click login options and select Fastpass as your preferred login method.