LDAP-сервер

Casdoor can act as a simple LDAP server for systems (e.g. Nexus) that use LDAP for authentication. It supports bind and search with Simple Authentication.

Порт

LDAP-сервер за замовчуванням слухає порт 389. Change it via ldapServerPort in conf/app.conf.

Behavior

• User entries follow the posixAccount style.
• Bind: The server parses cn (username) and ou (organization). dc is ignored. It verifies the user with Casdoor and grants access for subsequent operations.
• Search: The server checks that the client has permission (from the bind) and returns results accordingly.

інформація

Only Simple Authentication is supported.

Bind

Use a DN in this form: cn=<username>,ou=<organization>,dc=example,dc=com.

Example: cn=admin,ou=built-in,dc=example,dc=com. Set the admin’s DN to this format, then bind with that DN and the user’s password. On success, the client is authorized for search.

Пошук

After a successful bind:

• One user (e.g. Alice in built-in): Base DN ou=built-in,dc=example,dc=com, filter cn=Alice.
• All users in an org (e.g. built-in): Base DN ou=built-in,dc=example,dc=com, filter cn=*.
• All users in all orgs (if permitted): Base DN ou=*,dc=example,dc=com, filter cn=*.
• Users in a group: Use a filter such as (memberOf=organization_name/group_name).

User attributes

Attribute	Опис	Source
cn	Common name	User name
uid	User ID	User id
homeDirectory	Home directory	/home/{username}
mail	Електронна пошта	User email
мобільний	Телефон	User phone
sn	Surname	User last name
givenName	Given name	User first name
memberOf	Групи – підказка	User’s groups
loginShell	Login shell	user.Properties["loginShell"], defaults to /bin/bash
gecos	GECOS (full name)	user.DisplayName, falls back to user.Name
sshPublicKey	SSH public key	user.Properties["sshPublicKey"], omitted if empty

All entries also carry objectClass: posixAccount, which is required by PAM and NSS for Linux authentication.

Linux machine login

Casdoor’s LDAP server exposes posixAccount-compatible entries, so Linux hosts can authenticate users directly against Casdoor via standard tools such as sssd, nss-ldap, or pam_ldap.

To configure per-user values for loginShell and sshPublicKey, set them in the user’s Properties field (key-value map):

{
  "loginShell": "/bin/zsh",
  "sshPublicKey": "ssh-ed25519 AAAA..."
}

If loginShell is not set, /bin/bash is used. If sshPublicKey is absent, the attribute is omitted from the LDAP entry entirely.

RFC-style features

Root DSE (baseDN="")

• namingContexts: ldapsearch -x -H ldap://<casdoor-host>:389 -D "cn=admin,ou=built-in" -w <passwd> -b "" -s base "(objectClass=*)" namingContexts — returns visible organization DNs.
• subschemaSubentry: ldapsearch -x -H ldap://<casdoor-host>:389 -D "cn=admin,ou=built-in" -w <passwd> -b "" -s base "(objectClass=*)" subschemaSubentry — returns subschemaSubentry: cn=Subschema.

Schema

Query objectClasses: ldapsearch -x -H ldap://<casdoor-host>:389 -D "cn=admin,ou=built-in" -w <passwd> -b "cn=Subschema" -s base "(objectClass=*)" objectClasses — returns posixAccount and posixGroup definitions.

POSIX filters

• (objectClass=posixAccount) — user list.
• (objectClass=posixGroup) — group list for an org (e.g. -b "ou=<org>" "(objectClass=posixGroup)").

примітка

(objectClass=posixGroup) does not support combined filters like (&(objectClass=posixGroup)(cn=<group>)). Use memberOf to find members of a group.