https://github.com/benweissmann/ldap-rails

Radically simple LDAP authentication for Rails.
https://github.com/benweissmann/ldap-rails

Last synced: about 2 months ago
JSON representation

Radically simple LDAP authentication for Rails.

• Host: GitHub
• URL: https://github.com/benweissmann/ldap-rails
• Owner: benweissmann
• License: mit
• Created: 2012-08-05T09:31:59.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2012-08-05T10:14:01.000Z (over 12 years ago)
• Last Synced: 2024-04-25T20:03:04.949Z (9 months ago)
• Language: Ruby
• Size: 104 KB
• Stars: 8
• Watchers: 4
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# LDAP-Rails

## Radically simple LDAP authentication

ldap-rails is a Rails plugin that makes it easy to authenticate users against

your organization's LDAP server.

It's designed for Rails 3.1 and above.

ldap-rails is developed and maintained by

[Ben Weissmann](http://benweissmann.com). If you have bug reports or

feature requests, please

[file an issue](https://github.com/benweissmann/ldap-rails/issues) or email

me at [[email protected]](mailto:[email protected]).

## Setup

1. Add "gem ldap-rails" to your Gemfile.

2. Run "bundle install" to install the new gem.

3. Run "rails generate ldap_auth ldap.your-org.com"

That's it. You're done. Users will be presented with a login form when they

visit your site, and will need to log in with LDAP before they can access your

site.

## Configuration

ldap-rails will try to guess your LDAP server's configuration based on the

the URL you give to the rails generate command. Note that you can specify

the for as part of the URL -- for example, if your LDAP server runs on port

1000, use "rails generate ldap_auth ldap.your-org.com:1000". ldap-rails will

automatically try to use and SSL connection to your LDAP server if your LDAP

server is on port 636.

You can customize the LDAP connection configuration after you've run the

generator in config/initializer/ldap_auth.rb. See the instruction in that

file for more detail.

## Roadmap

Planned features:

* Access control based on LDAP groups.

* Integration with ActiveRecord to easily store authenticated users in your

  database.

## License

ldap-rails is licensed under the MIT license. See LICENSE.txt for details.