Drupal: Difference between revisions

From RavenWiki
Jump to navigationJump to search
m (Changed version tested to)
No edit summary
Line 5: Line 5:


== Installation ==
== Installation ==
'''Update: See the readme file contained in version 1.2 for updated instructions.'''


Un-tar the module into your Drupal's "module" directory. It will be placed in a "ucamraven" sub-directory.
Un-tar the module into your Drupal's "module" directory. It will be placed in a "ucamraven" sub-directory.
Line 25: Line 27:


The admin account must be a CRSID to log in using the raven system. Administrators with non CRSID account names can only by-pass the Raven login if either: this module is disabled, or the function that overrides "user/login" is disabled (comment out in the .module file).
The admin account must be a CRSID to log in using the raven system. Administrators with non CRSID account names can only by-pass the Raven login if either: this module is disabled, or the function that overrides "user/login" is disabled (comment out in the .module file).
(This does not appear to be true - see readme in version 1.2)


== License ==
== License ==
Line 33: Line 36:


The UCam Raven Drupal module can be downloaded here:
The UCam Raven Drupal module can be downloaded here:
http://raven.cam.ac.uk/project/drupal/files/. The current version is 1.1
http://raven.cam.ac.uk/project/drupal/files/. The current version is 1.1 (an updated version 1.2 is also available - see below).


An old version for drual 4.6 and 4.7 is also available, however it may suffer from a security vulnerability that was fixed by the 1.0 to 1.1 upgrade of the 6.x version. Use with considerable care.
An old version for drual 4.6 and 4.7 is also available, however it may suffer from a security vulnerability that was fixed by the 1.0 to 1.1 upgrade of the 6.x version. Use with considerable care.
An updated module with an improved readme, user college checking and redirection for unrecognised colleges is also available. Note that college checking cannot check postgraduates as they are a member of their department, not their college. The install.txt files contains some important instructions, so do read it.
[[Image:Ucamraven-6.x-1.2.tar.gz]] - On-wiki link
[http://people.pwf.cam.ac.uk/aph40/ucamraven-6.x-1.2.tar.gz Ucamraven-6.x-1.2.tar.gz] - Off-wiki link


== Author ==
== Author ==


Author's contact information is available in the module source file.
Author's contact information is available in the module source file.

Revision as of 12:56, 2 May 2010

Shawn Tan's Drupal module. Updated by David Newgas.

Objective

This Drupal module was created to allow any website that uses Drupal, to authenticate via Raven. The module runs fine on 6.x versions of Drupal (tested up to 6.16).

Installation

Update: See the readme file contained in version 1.2 for updated instructions.

Un-tar the module into your Drupal's "module" directory. It will be placed in a "ucamraven" sub-directory.

Login as the administrator for your Drupal based site.

  • Go to /user/1/edit and ensure the admin account is a CRSID.
  • Click on admin => modules. Enable the "ucamraven" module.
  • Click on admin => menus => navigation. Uncheck the "Log out" item to disable non-raven authentication·

User Login

Any user that clicks on the "raven login" link in the main menu will be redirected to the standard Raven login page. Once the user has authenticated with Raven, the user will be redirected back to the original website.

If no user account exists for that CRSID, one will be created.

Admin Login

The admin account must be a CRSID to log in using the raven system. Administrators with non CRSID account names can only by-pass the Raven login if either: this module is disabled, or the function that overrides "user/login" is disabled (comment out in the .module file). (This does not appear to be true - see readme in version 1.2)

License

This module is released under GPLv2. A copy of the license is included in the module package.

Download

The UCam Raven Drupal module can be downloaded here: http://raven.cam.ac.uk/project/drupal/files/. The current version is 1.1 (an updated version 1.2 is also available - see below).

An old version for drual 4.6 and 4.7 is also available, however it may suffer from a security vulnerability that was fixed by the 1.0 to 1.1 upgrade of the 6.x version. Use with considerable care.

An updated module with an improved readme, user college checking and redirection for unrecognised colleges is also available. Note that college checking cannot check postgraduates as they are a member of their department, not their college. The install.txt files contains some important instructions, so do read it.

File:Ucamraven-6.x-1.2.tar.gz - On-wiki link

Ucamraven-6.x-1.2.tar.gz - Off-wiki link

Author

Author's contact information is available in the module source file.