From dfe0773549c19186fed1bfed775ada1c3d53ed64 Mon Sep 17 00:00:00 2001 From: Reefsoft Date: Tue, 14 Apr 2026 23:51:53 +0200 Subject: [PATCH] Add Simple Auth to Gogs example config --- example_configs/gogs.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/example_configs/gogs.md b/example_configs/gogs.md index 9d2158d..9ec9360 100644 --- a/example_configs/gogs.md +++ b/example_configs/gogs.md @@ -1,6 +1,24 @@ # 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 example is a container configuration - the file should live within `conf/auth.d/some_name.conf`: