Add Simple Auth to Gogs example config

This commit is contained in:
Reefsoft
2026-04-14 23:51:53 +02:00
committed by nitnelave
parent 52a08d3ad9
commit dfe0773549

View File

@@ -1,6 +1,24 @@
# Gogs LDAP configuration # Gogs LDAP configuration
Gogs can make use of LDAP and therefore lldap. ### Via Simple Auth (easier)
Go to tha Administration settings, then go to Authentication. There, you have to add an authentication source.
For type, select "LDAP (Simple Auth)".
Name your authentication source however you'd like.
It is up to you to select your security protocol, but the only two compatible options are "LDAPS" and "Unencrypted".
As your host, put in the IP or FQDN (if you have DNS).
As your port, it is suggested to look into your config file. It will generally be something like 389, 3890, 636, 6360.
Your User DN **has** to be equal to `uid=%s,ou=people,dc=example,dc=com`.
It is recommended to have your user filter to be `(&(objectClass=person)(uid=%s))`.
Your username attribute should be `uid`.
Your Given Name attribute should be `givenName`.
Your surname attribute should be `sn`.
Your email attribute should be `mail`.
You can (and should if you don't know LDAP) leave the rest empty.
### Via Bind DN (more complicated)
The following configuration is adapted from the example configuration at [their repository](https://github.com/gogs/gogs/blob/main/conf/auth.d/ldap_bind_dn.conf.example). The following configuration is adapted from the example configuration at [their repository](https://github.com/gogs/gogs/blob/main/conf/auth.d/ldap_bind_dn.conf.example).
The example is a container configuration - the file should live within `conf/auth.d/some_name.conf`: The example is a container configuration - the file should live within `conf/auth.d/some_name.conf`: