Contents of /contributions/modules/singlesignon/README

/* $Id$ */

Enables "Single Sign-Ons" between related Drupal sites on one server
with a shared database.

Installation and activation are simple:
  + Put this file in your modules directory.
  + If you're not also using the "domain" module
    + If you haven't done so already, create site sub-directories in the
      "sites" directory for each of your domains.  Put "settings.php"
      files in each of those directories.  Edit each of the settings.php
      files to values appropriate for the given domain.
    + Make sure the "$db_prefix" variable is set correctly in each
      settings.php file (see details below).
    + Create the site specific and shared database tables defined in the
      "$db_prefix" variable (see details below).
    + On each site, starting with the master site:
       + Log in as administrator.
       + Enable the "singlesignon" module
          (via the checkbox in the administer | modules interface).
       + Enter the URL of the master site
          (via administer | settings | singlesignon).
    + Delete cookies from all of your Drupal sites.

This module relies on several tables being shared between the master and
slave sites.  Here is an example of the "$db_prefix" variable you need to
establish in all of your "settings.php" files in the "sites" directory.
Each site should have a unique name in place of "somesitename_".  While
you can rename "shared_" to something else, the prefixes must be the
same for all sites.

$db_prefix = array(
  'default'        => 'somesitename_',
  'authmap'        => 'shared_',
  'profile_fields' => 'shared_',
  'profile_values' => 'shared_',
  'role'           => 'shared_',
  'sequences'      => 'shared_',
  'sessions'       => 'shared_',
  'users'          => 'shared_',
  'users_roles'    => 'shared_',
  'users_uid_seq'  => 'shared_',  // for pgsql
);

link:     http://drupal.org/project/singlesignon
author:   Daniel Convissor <danielc@analysisandsolutions.com>
Maintainer: Tim Nelson <wayland@wayland.id.au>

1	/* $Id$ */
2
3	Enables "Single Sign-Ons" between related Drupal sites on one server
4	with a shared database.
5
6	Installation and activation are simple:
7	+ Put this file in your modules directory.
8	+ If you're not also using the "domain" module
9	+ If you haven't done so already, create site sub-directories in the
10	"sites" directory for each of your domains. Put "settings.php"
11	files in each of those directories. Edit each of the settings.php
12	files to values appropriate for the given domain.
13	+ Make sure the "$db_prefix" variable is set correctly in each
14	settings.php file (see details below).
15	+ Create the site specific and shared database tables defined in the
16	"$db_prefix" variable (see details below).
17	+ On each site, starting with the master site:
18	+ Log in as administrator.
19	+ Enable the "singlesignon" module
20	(via the checkbox in the administer \| modules interface).
21	+ Enter the URL of the master site
22	(via administer \| settings \| singlesignon).
23	+ Delete cookies from all of your Drupal sites.
24
25	This module relies on several tables being shared between the master and
26	slave sites. Here is an example of the "$db_prefix" variable you need to
27	establish in all of your "settings.php" files in the "sites" directory.
28	Each site should have a unique name in place of "somesitename_". While
29	you can rename "shared_" to something else, the prefixes must be the
30	same for all sites.
31
32	$db_prefix = array(
33	'default' => 'somesitename_',
34	'authmap' => 'shared_',
35	'profile_fields' => 'shared_',
36	'profile_values' => 'shared_',
37	'role' => 'shared_',
38	'sequences' => 'shared_',
39	'sessions' => 'shared_',
40	'users' => 'shared_',
41	'users_roles' => 'shared_',
42	'users_uid_seq' => 'shared_', // for pgsql
43	);
44
45	link: http://drupal.org/project/singlesignon
46	author: Daniel Convissor <danielc@analysisandsolutions.com>
47	Maintainer: Tim Nelson <wayland@wayland.id.au>
48