You are here

INSTALL.txt in Bakery Single Sign-On System 6.2

Same filename and directory in other branches
  1. 6 INSTALL.txt
How to install bakery?
======================

Prerequisites: This module requires the mcrypt PHP module.

You need two Drupal sites, e.g. example.com and sub.example.com.  It
is ideal if you can copy the user base of the main site to the slave
site or if sub.example.com is a new site.

Note that "localhost" will not work in most browsers. If you wish to
test Bakery SSO locally, you must set up a local domain for it to
work.

On both domains:

1) You edit settings.php and check that $cookie_domain is set to
   example.com.

2) Login as the user with uid 1.

3) You install bakery.module.


On example.com/admin/setting/bakery you chose

a) Master site: yes

b) Master site: http://example.com/

c) Slave sites: http://sub.example.com/

d) Freshness: the default is fine

e) Key: an alphanumeric string, longer is better

f) Cookie domain: example.com

g) Supported profile fields: Any fields that you like to export. Name
   and Mail are always exported.


On sub.example.com/admin/setting/bakery you chose

a) Master site: no

b) Master site: http://example.com/

c) Slave sites: empty

d) Seconds of age before a cookie is old: you should use a number similar 
   to the value in the settings.php on the parent site.

e) Key: an alphanumeric string, longer is better (the same string as
       on example.com)

f) Cookie domain: example.com

g) Supported profile fields: Any fields that you like to import. Name
   and Mail are always imported. You can only import fields that are
   exported by the master. You can chose to ignore some of them, though.

h) You need to disable the user login block on the slave site. Log-ins
   are only permitted through the master server.

Additional slave sites can be created like sub.example.com.

Caveats
=======

If you use bakery with OG, make sure that bakery has a lower weight than OG.

If you run suhosin or mod_security you may run into trouble.

File

INSTALL.txt
View source
  1. How to install bakery?
  2. ======================
  3. Prerequisites: This module requires the mcrypt PHP module.
  4. You need two Drupal sites, e.g. example.com and sub.example.com. It
  5. is ideal if you can copy the user base of the main site to the slave
  6. site or if sub.example.com is a new site.
  7. Note that "localhost" will not work in most browsers. If you wish to
  8. test Bakery SSO locally, you must set up a local domain for it to
  9. work.
  10. On both domains:
  11. 1) You edit settings.php and check that $cookie_domain is set to
  12. example.com.
  13. 2) Login as the user with uid 1.
  14. 3) You install bakery.module.
  15. On example.com/admin/setting/bakery you chose
  16. a) Master site: yes
  17. b) Master site: http://example.com/
  18. c) Slave sites: http://sub.example.com/
  19. d) Freshness: the default is fine
  20. e) Key: an alphanumeric string, longer is better
  21. f) Cookie domain: example.com
  22. g) Supported profile fields: Any fields that you like to export. Name
  23. and Mail are always exported.
  24. On sub.example.com/admin/setting/bakery you chose
  25. a) Master site: no
  26. b) Master site: http://example.com/
  27. c) Slave sites: empty
  28. d) Seconds of age before a cookie is old: you should use a number similar
  29. to the value in the settings.php on the parent site.
  30. e) Key: an alphanumeric string, longer is better (the same string as
  31. on example.com)
  32. f) Cookie domain: example.com
  33. g) Supported profile fields: Any fields that you like to import. Name
  34. and Mail are always imported. You can only import fields that are
  35. exported by the master. You can chose to ignore some of them, though.
  36. h) You need to disable the user login block on the slave site. Log-ins
  37. are only permitted through the master server.
  38. Additional slave sites can be created like sub.example.com.
  39. Caveats
  40. =======
  41. If you use bakery with OG, make sure that bakery has a lower weight than OG.
  42. If you run suhosin or mod_security you may run into trouble.