add installation instructions to README
This commit is contained in:
parent
d41bca141c
commit
8f8f6bd1e8
36
README.md
36
README.md
@ -0,0 +1,36 @@
|
||||
# ProxmoxAAS LDAP - Simple REST API for LDAP
|
||||
|
||||
ProxmoxAAS LDAP provides a simple API for managing users and groups in a simplified LDAP server. Expected LDAP configuration can be initialized using [open-ldap-setup](https://git.tronnet.net/tronnet/open-ldap-setup).
|
||||
|
||||
## Installation
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Initialized LDAP server with the following configuration
|
||||
- Structure
|
||||
- Users: ou=people,...
|
||||
- objectType: inetOrgPerson
|
||||
- At least 1 user which is a member of admin group
|
||||
- Groups: ou=groups,...
|
||||
- objectType: groupOfNames
|
||||
- At least 1 admin group
|
||||
- Permissions:
|
||||
- Admin group should have write access
|
||||
- Users should have write access to own attributes (cn, sn, userPassword)
|
||||
- Enable anonymous binding
|
||||
- Load MemberOf Policy:
|
||||
- olcMemberOfDangling: ignore
|
||||
- olcMemberOfRefInt: TRUE
|
||||
- olcMemberOfGroupOC: groupOfNames
|
||||
- olcMemberOfMemberAD: member
|
||||
- olcMemberOfMemberOfAD: memberOf
|
||||
- Password Policy and TLS are recommended but not required
|
||||
|
||||
### Installation
|
||||
|
||||
1. Download `proxmoxaas-ldap` binary and `template.config.json` file from [releases](releases)
|
||||
2. Rename `template.config.json` to `config.json` and modify:
|
||||
- ldapURL: url to the ldap server ie. `ldap://ldap.domain.net`
|
||||
- baseDN: base DN ie. `dc=domain,dc=net`
|
||||
- sessionSecretKey: random value used to randomize cookie values, replace with any sufficiently large random string
|
||||
3. Run the binary
|
Loading…
Reference in New Issue
Block a user