| @@ -16,49 +16,49 @@ retrieved and passed to the Gogs login infrastructure. | |||
| To use this module, add an LDAP authentication source via the Authentications | |||
| section in the admin panel. The fields should be set as follows: | |||
| Authorization Name (required) | |||
| A name to assign to the new method of authorization. | |||
| * Authorization Name **(required)** | |||
| * A name to assign to the new method of authorization. | |||
| Host (required) | |||
| The address where the LDAP server can be reached. | |||
| Example: mydomain.com | |||
| * Host **(required)** | |||
| * The address where the LDAP server can be reached. | |||
| * Example: mydomain.com | |||
| Port (required) | |||
| The port to use when connecting to the server. | |||
| Example: 636 | |||
| * Port **(required)** | |||
| * The port to use when connecting to the server. | |||
| * Example: 636 | |||
| Enable TLS Encryption (optional) | |||
| Whether to use TLS when connecting to the LDAP server. | |||
| * Enable TLS Encryption (optional) | |||
| * Whether to use TLS when connecting to the LDAP server. | |||
| Bind DN (optional) | |||
| The DN to bind to the LDAP server with when searching for the user. | |||
| * Bind DN (optional) | |||
| * The DN to bind to the LDAP server with when searching for the user. | |||
| This may be left blank to perform an anonymous search. | |||
| Example: cn=Search,dc=mydomain,dc=com | |||
| * Example: cn=Search,dc=mydomain,dc=com | |||
| Bind Password (optional) | |||
| The password for the Bind DN specified above, if any. | |||
| * Bind Password (optional) | |||
| * The password for the Bind DN specified above, if any. | |||
| User Search Base (required) | |||
| The LDAP base at which user accounts will be searched for. | |||
| Example: ou=Users,dc=mydomain,dc=com | |||
| * User Search Base **(required)** | |||
| * The LDAP base at which user accounts will be searched for. | |||
| * Example: ou=Users,dc=mydomain,dc=com | |||
| User Filter (required) | |||
| An LDAP filter declaring how to find the user record that is attempting | |||
| * User Filter **(required)** | |||
| * An LDAP filter declaring how to find the user record that is attempting | |||
| to authenticate. The '%s' matching parameter will be substituted with | |||
| the user's username. | |||
| Example: (&(objectClass=posixAccount)(uid=%s)) | |||
| * Example: (&(objectClass=posixAccount)(uid=%s)) | |||
| First name attribute (optional) | |||
| The attribute of the user's LDAP record containing the user's first | |||
| * First name attribute (optional) | |||
| * The attribute of the user's LDAP record containing the user's first | |||
| name. This will be used to populate their account information. | |||
| Example: givenName | |||
| * Example: givenName | |||
| Surname name attribute (optional) | |||
| The attribute of the user's LDAP record containing the user's surname | |||
| * Surname name attribute (optional) | |||
| *The attribute of the user's LDAP record containing the user's surname | |||
| This will be used to populate their account information. | |||
| Example: sn | |||
| * Example: sn | |||
| E-mail attribute (required) | |||
| * E-mail attribute (required) | |||
| The attribute of the user's LDAP record containing the user's email | |||
| address. This will be used to populate their account information. | |||
| Example: mail | |||
| * Example: mail | |||