91 lines
2.7 KiB
Plaintext
91 lines
2.7 KiB
Plaintext
= Use LDAP permissions in PostgreSQL
|
|
|
|
* http://github.com/larskanis/pg-ldap-sync
|
|
|
|
== DESCRIPTION:
|
|
|
|
LDAP is often used for a centralized user and role management
|
|
in an enterprise environment. PostgreSQL offers different
|
|
authentication methods, like LDAP, SSPI, GSSAPI or SSL.
|
|
However, for any method the user must already exist in the database,
|
|
before the authentication can be used. There is currently
|
|
no direct authorization of database users on LDAP. So roles
|
|
and memberships has to be administered twice.
|
|
|
|
This program helps to solve the issue by synchronizing users,
|
|
groups and their memberships from LDAP to PostgreSQL.
|
|
Access to LDAP is used read-only. <tt>pg_ldap_sync</tt> issues proper
|
|
CREATE ROLE, DROP ROLE, GRANT and REVOKE commands to synchronize
|
|
users and groups.
|
|
|
|
It is meant to be started as a cron job.
|
|
|
|
== FEATURES:
|
|
|
|
* Configurable per YAML config file
|
|
* Can use Active Directory as LDAP-Server
|
|
* Nested groups/roles supported
|
|
* Set scope of considered users/groups on LDAP and PG side
|
|
* Runs with pg.gem (C-library) or postgres-pr.gem (pure Ruby)
|
|
* Test mode which doesn't do any changes to the DBMS
|
|
* Both LDAP and PG connections can be secured by SSL/TLS
|
|
|
|
== REQUIREMENTS:
|
|
|
|
* Ruby-1.8.7, Ruby-1.9.2, JRuby-1.2, Rubinius-1.2 or better
|
|
* Rubygems-1.3.5+
|
|
* LDAP-v3 server
|
|
* PostgreSQL-server v8.1+
|
|
|
|
== INSTALL:
|
|
|
|
Install Ruby and rubygems:
|
|
* on Windows: http://rubyinstaller.org
|
|
* on Debian/Ubuntu: <tt>apt-get install ruby rubygems</tt>
|
|
|
|
Install pg-ldap-sync and a database connector for PostgreSQL:
|
|
gem install pg-ldap-sync pg
|
|
You may also use the pure ruby postgres-connector which is less mature,
|
|
but doesn't need compilation:
|
|
gem install pg-ldap-sync postgres-pr
|
|
|
|
=== Install from Git:
|
|
git clone https://github.com/larskanis/pg-ldap-sync.git
|
|
cd pg-ldap-sync
|
|
gem install hoe
|
|
rake install_gem
|
|
|
|
== USAGE:
|
|
|
|
Create a config file based on
|
|
{config/sample-config.yaml}[https://github.com/larskanis/pg-ldap-sync/blob/master/config/sample-config.yaml]
|
|
or even better
|
|
{config/sample-config2.yaml}[https://github.com/larskanis/pg-ldap-sync/blob/master/config/sample-config2.yaml]
|
|
|
|
Run in test-mode:
|
|
|
|
pg_ldap_sync -c my_config.yaml -vv -t
|
|
|
|
Run in modify-mode:
|
|
|
|
pg_ldap_sync -c my_config.yaml -vv
|
|
|
|
|
|
== TEST:
|
|
There is a small test suite in the <tt>test</tt> directory that runs
|
|
against an internal ruby-ldapserver and PostgreSQL server. Ensure gem
|
|
<tt>ruby-ldapserver</tt> is installed and <tt>pg_ctl</tt>, <tt>initdb</tt> and <tt>psql</tt>
|
|
commands are in the <tt>PATH</tt>. Then:
|
|
|
|
cd pg-ldap-sync
|
|
rake test
|
|
|
|
== ISSUES:
|
|
* There is currently no way to set certain user attributes in PG
|
|
based on individual attributes in LDAP (expiration date etc.)
|
|
|
|
|
|
== License
|
|
|
|
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
|