Added by Dusan Fisic, last edited by Dusan Fisic on Jul 02, 2010  (view change)

Labels:

phpbb phpbb Delete
install install Delete
agent agent Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.

Index

1. Introduction

This guide will walk you through the steps to get a JOSSO 1.8 Agent running on phpBB 3.0.x web application.  Deployment console provides complete agent install with small user intervention.

2. Prerequisites

To make a quick JOSSO setup we will need:

For the purposes of this guide, we will assume the following facts:

  • JDK 1.5.0 16 is located at /opt/jdk1.5.0_16
  • working Apache Http Server with installed and working copy of phpBB 3.0.5 located at /srv/http/phpBB
  • installed josso-php-agent and working with josso gateway
    How to setup josso PHP agent.
  • JOSSO 1.8.0 is located at /opt/josso-1.8.0

3. Install Agent

First we will start JOSSO Deployment Console.

$ cd /opt/josso-1.8.0/bin
$ ./josso-gsh
    __ _____ _____ _____ _____
 __|  |     |   __|   __|     |
|  |  |  |  |__   |__   |  |  |
|_____|_____|_____|_____|_____|

 JOSSO (1.8.0)

Type 'help' for more information.
--------------------------------------
josso>

Now we have to execute the agent install command as shown below:
(remember that target parameter is always path to root of phpBB web application,
make sure you have write permission)

josso> agent install --target /srv/http/phpBB --platform phpBB

 
You should see something like this :


josso> agent install --target /srv/http/phpBB --platform phpBB

Installing PHP 3.x JOSSO Agent v.1.8.2-SNAPSHOT

Verifying Target PHP 3.x
  phpBB root                                               [OK   ] 

Backing up and removing old JOSSO artifacts

Installing JOSSO 3rd party JARs

Installing JOSSO Agent JARs

Installing JOSSO Agent JARs from Source

Configuring Container

Installing JOSSO Agent Configuration files
  Installing    [josso-security-check.php]                 [OK   ] Created file:///home/fish/tmp/original/phpBB3/josso-security-check.php
  Installing    [josso-logout.php]                         [OK   ] Created file:///home/fish/tmp/original/phpBB3/josso-logout.php
  Backup        [common.php]                               [OK   ] file:///home/fish/tmp/original/phpBB3/language/en/common.php.bkp.1
  Configure     [/language/en/common.php]                  [OK   ] Patching file: /home/fish/tmp/original/phpBB3/language/en/common.php
  Backup        [index.php]                                [OK   ] file:///home/fish/tmp/original/phpBB3/index.php.bkp.1
  Configure     [/index.php]                               [OK   ] Patching file: /home/fish/tmp/original/phpBB3/index.php
  Backup        [functions.php]                            [OK   ] file:///home/fish/tmp/original/phpBB3/includes/functions.php.bkp.1
  Configure     [/includes/functions.php]                  [OK   ] Patching file: /home/fish/tmp/original/phpBB3/includes/functions.php
  Backup        [login_body.html]                          [OK   ] file:///home/fish/tmp/original/phpBB3/styles/prosilver/template/login_body.html.bkp.1
  Configure     [/styles/prosilver/template/login_body.html] [OK   ] Patching file: /home/fish/tmp/original/phpBB3/styles/prosilver/template/login_body.html
  Backup        [index_body.html]                          [OK   ] file:///home/fish/tmp/original/phpBB3/styles/prosilver/template/index_body.html.bkp.1
  Configure     [/styles/prosilver/template/index_body.html] [OK   ] Patching file: /home/fish/tmp/original/phpBB3/styles/prosilver/template/index_body.html
  Backup        [functions_user.php]                       [OK   ] file:///home/fish/tmp/original/phpBB3/includes/functions_user.php.bkp.1
  Configure     [/includes/functions_user.php]             [OK   ] Patching file: /home/fish/tmp/original/phpBB3/includes/functions_user.php
  Installing    [auth_josso.php]                           [OK   ] Created file:///home/fish/tmp/original/phpBB3/includes/auth/auth_josso.php
  Installing    [josso-authenticate.php]                   [OK   ] Created file:///home/fish/tmp/original/phpBB3/josso-authenticate.php
  Installing    [josso-login.php]                          [OK   ] Created file:///home/fish/tmp/original/phpBB3/josso-login.php

PHP 3.x JOSSO Agent v.1.8.2-SNAPSHOT
  Overall Installation                                     [OK   ] Successful.

Congratulations! You've successfully installed the agent.
Now Follow the JOSSO Agent Configuration guide for SSO-enabling applications.

josso>

You can see all the console activity, this information will also be recorded in a log file created in josso-1.8.0/log/.

4.Configure

If installation went well, you can proceed configuring phpBB application.

Bypass josso-php-authentication

Before you begin configuration, to avoid problems that may occur, you better bypass josso authentication,
simply by commenting lines in your php.ini:

;include_path = ".:/srv/http/includes/josso-lib:/usr/share/pear"
include_path = ".:/usr/share/pear"
...
;auto_prepend_file = "josso/josso.php"

  • Now you can login as admin user (default phpBB admin user, by installation).
  • Go to Administration Control Panel>Client communication>Authentication
    (more on this phpBB documentation )
  • Change Authentication Method to josso
  • Save your changes
  • Log out as admin
  • Turn on josso authentication. (php.ini)
  • Restart Apache HTTP server

From this point, you should be able to login to phpBB with josso credentials.