mirror of https://github.com/nitnelave/lldap.git
50 lines
2.5 KiB
Markdown
50 lines
2.5 KiB
Markdown
# Configuration for Gitea (& Forgejo)
|
|
In Gitea, go to `Site Administration > Authentication Sources` and click `Add Authentication Source`
|
|
Select `LDAP (via BindDN)`
|
|
|
|
* Host: Your lldap server's ip/hostname
|
|
* Port: Your lldap server's port (3890 by default)
|
|
* Bind DN: `uid=admin,ou=people,dc=example,dc=com`
|
|
* Bind Password: Your bind user's password
|
|
* User Search Base: `ou=people,dc=example,dc=com`
|
|
* User Filter: If you want all users to be able to log in, use<br>
|
|
`(&(objectClass=person)(|(uid=%[1]s)(mail=%[1]s)))`.<br>
|
|
To log in they can either use their email address or user name. If you only want members a specific group to be able to log in, in this case the group `git_user`, use<br>
|
|
`(&(memberof=cn=git_user,ou=groups,dc=example,dc=com)(|(uid=%[1]s)(mail=%[1]s)))`<br>
|
|
For more info on the user filter, see: https://docs.gitea.io/en-us/authentication/#ldap-via-binddn
|
|
* Admin Filter: Use `(memberof=cn=lldap_admin,ou=groups,dc=example,dc=com)` if you want lldap admins to become Gitea admins. Leave empty otherwise.
|
|
* Username Attribute: `uid`
|
|
* First Name Attribute: `givenName`
|
|
* Surname Attribute: `sn`
|
|
* Email Attribute: `mail`
|
|
* Avatar Attribute: `jpegPhoto`
|
|
* Check `Enable User Synchronization`
|
|
|
|
Replace every instance of `dc=example,dc=com` with your configured domain.
|
|
|
|
After applying the above settings, users should be able to log in with either their user name or email address.
|
|
|
|
## Syncronizing LDAP groups with existing teams in organisations
|
|
|
|
Groups in LLDAP can be syncronized with teams in organisations. Organisations and teams must be created manually in Gitea.
|
|
It is possible to syncronize one LDAP group with multiple teams in a Gitea organization.
|
|
|
|
Check `Enable LDAP Groups`
|
|
|
|
* Group Search Base DN: `ou=groups,dc=example,dc=com`
|
|
* Group Attribute Containing List Of Users: `member`
|
|
* User Attribute Listed In Group: `dn`
|
|
* Map LDAP groups to Organization teams: `{"cn=Groupname1,ou=groups,dc=example,dc=com":{"Organization1": ["Teamname"]},"cn=Groupname2,ou=groups,dc=example,dc=com": {"Organization2": ["Teamname1", "Teamname2"]}}`
|
|
|
|
Check `Remove Users from syncronised teams...`
|
|
|
|
The `Map LDAP groups to Organization teams` config is JSON formatted and can be extended to as many groups as needed.
|
|
|
|
Replace every instance of `dc=example,dc=com` with your configured domain.
|
|
|
|
# Configuration for Gitea in `simple auth` mode
|
|
|
|
* The configuration method is the same as `BindDN` mode.
|
|
* `BindDN` and `password` are not required
|
|
* Gitea will not be able to pre-sync users, user account will be created at login time.
|