Mac OS X Identity Services plugin¶ ↑

A Redmine plugin for authenticating with Mac OS X Identity Services.

Enables access for external users and groups that are defined in a directory service (such as Active Directory).

Features¶ ↑

• User accounts and groups from the local server and/or directory services may be used

• On-the-fly user creation with name and email address obtained automatically

• Email addresses local to the server can be preferred over external email addresses

• User groups in Redmine can be linked to groups in a directory service

• User membership in groups is update each time a user authenticates

• Access can be restricted to just those users who belong to defined groups

• Tested with Mac OS X Server v10.6 Snow Leopard

Getting the plugin¶ ↑

The latest copy of the plugin can be found on GitHub github.com/brianwells/redmine_osx_ids

The downloads page may contain copies of the plugin for specific versions of Redmine.

Installing¶ ↑

Follow the instructions for Redmine plugins at www.redmine.org/wiki/redmine/Plugins

Make sure that the plugin is installed to the vendor/plugins/redmine_osx_ids folder and that the required migration is performed on the database.

Please note that the downloads from GitHub are named something like “brianwells-redmine_osx_ids-c82e00c” when extracted. For best results, always rename the folder to “redmine_osx_ids” and place it in the plugins folder.

Usage¶ ↑

Enabling Authentication¶ ↑

1. Choose Administration > Identity Services authentication

2. Add a new Identity Services authentication mode.

3. Specify a name for the authentication mode as well as the authority that will be providing user accounts and groups.

4. On-the-fly user creation can be enabled as well as other options such as preferring local email addresses or restricting access to members of specified groups.

5. After creating the authentication mode, it can be verified by clicking Test next to it in the list.

Adding External Groups¶ ↑

1. Choose Administration > Groups > New group

2. The name specified must match the short name of the group in the directory service.

3. Select the appropriate authentication mode for the selected group.

4. Once created, the group can be given roles in various projects.

Adding External Users¶ ↑

If on-the-fly user creation was enabled, the users will be created automatically when they first log in. However, you can also create a user account in advance.

1. Choose Administration > Users > New user

2. The login specified must match the short name of the user in the directory service.

3. Fill in the other details of the account as needed.

4. Select the appropriate authentication mode for the selected user.

5. The user will automatically be added to any groups they belong to and can also be given specific roles in various projects.

License¶ ↑

Copyright © 2009,2010 Brian D. Wells

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <www.gnu.org/licenses/>.

Help¶ ↑

Help with the plugin can be requested by creating an issue on GitHub at github.com/brianwells/redmine_osx_ids/issues