VMmanager: Administrator guide

Documentation

/

VMmanager: Administrator guide

/

Developer section

/

API

/

LDAP Service (deprecated, supported up to v.2025.04.3)

We want your feedback!

Take our survey and help us improve the ISPsystem ecosystem as our lead advisor

Take the survey

Add to Favorites

/

VMmanager: Administrator guide

/

Developer section

/

API

/

LDAP Service (deprecated, supported up to v.2025.04.3)

LDAP Service (deprecated, supported up to v.2025.04.3)

{"openapi":"3.1.0","info":{"title":"LDAP service","description":"The LDAP service","version":"0.1.0"},"paths":{"\/auth":{"post":{"tags":["Auth"],"summary":"Auth Post","description":"Getting user list from LDAP to for syncing.","operationId":"auth_post_auth_post","requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AuthPostParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SuccessSchema"}}}},"422":{"description":"Validation Error","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/HTTPValidationError"}}}}}}},"\/connect":{"post":{"tags":["Connect"],"summary":"Connect","description":"Check connection to LDAP.","operationId":"connect_connect_post","requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ConnectionPostParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ConnectionPostResponse"}}}},"422":{"description":"Validation Error","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/HTTPValidationError"}}}}}}},"\/setting":{"get":{"tags":["Setting"],"summary":"Setting Get","description":"Get LDAP settings from DB.","operationId":"setting_get_setting_get","responses":{"200":{"description":"Successful Response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SettingGetResponse"}}}}}},"post":{"tags":["Setting"],"summary":"Setting Post","description":"Save LDAP settings to DB.","operationId":"setting_post_setting_post","requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SettingPostParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SuccessSchema"}}}},"422":{"description":"Validation Error","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/HTTPValidationError"}}}}}},"delete":{"tags":["Setting"],"summary":"Setting Delete","description":"Delete LDAP settings from DB.","operationId":"setting_delete_setting_delete","responses":{"200":{"description":"Successful Response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SuccessSchema"}}}}}}},"\/user\/list":{"post":{"tags":["User"],"summary":"User List","description":"Getting user list from LDAP to for syncing.","operationId":"user_list_user_list_post","requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SettingPostParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application\/json":{"schema":{"additionalProperties":{"items":{"$ref":"#\/components\/schemas\/SyncPostResponseOne"},"type":"array"},"type":"object","title":"Response User List User List Post"}}}},"422":{"description":"Validation Error","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/HTTPValidationError"}}}}}}},"\/user\/sync":{"get":{"tags":["User"],"summary":"User Sync Get","description":"Getting user sync status.","operationId":"user_sync_get_user_sync_get","responses":{"200":{"description":"Successful Response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SyncStatusResponse"}}}}}},"post":{"tags":["User"],"summary":"User Sync Post","description":"Syncing users from LDAP to platform.","operationId":"user_sync_post_user_sync_post","requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AuditLogger"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SuccessSchema"}}}},"422":{"description":"Validation Error","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AuditLogger":{"properties":{"action_id":{"type":"integer","title":"Action Id","default":0},"audit_log_fields":{"type":"object","title":"Audit Log Fields","default":[]}},"type":"object","title":"AuditLogger","description":"Logger for security actions"},"AuthPostParams":{"properties":{"email":{"type":"string","title":"Email","description":"User email","examples":["test@example.com"]},"password":{"type":"string","title":"Password","description":"User password","examples":["PasSwOrd"]}},"type":"object","required":["email","password"],"title":"AuthPostParams","description":"Auth post handler params"},"ConnectionPostParams":{"properties":{"base_dn":{"type":"string","title":"Base Dn","description":"Base Distinguished Name - the search will be started from such catalog object","examples":["dc=example,dc=com"]},"address":{"type":"string","title":"Address","description":"LDAP server address","examples":["192.168.0.5"]},"bind_dn":{"type":"string","title":"Bind Dn","description":"The bind user DN with database read right","examples":["cn=admin,dc=example,dc=com"]},"password":{"type":"string","title":"Password","description":"The bind user password","examples":["PaSSwOrd"]},"users_dn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Users Dn","description":"The part for searching users with base DN","examples":["cn=users"]},"groups_dn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Groups Dn","description":"The part for searching groups with base DN","examples":["cn=groups"]},"groupname_attr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Groupname Attr","description":"The name of group attribute for users searching","examples":["memberOf"]},"email_attr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Attr","description":"The name of email attribute for users searching","examples":["mail"]},"blocked_attr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocked Attr","description":"The name of blocked attribute for users searching","examples":["nsaccountlock"]},"type":{"anyOf":[{"$ref":"#\/components\/schemas\/LdapType"},{"type":"null"}],"description":"Type of LDAP server. If AD or FreeIPA some arguments could not be send, i.e. users DN","default":"ldap","examples":["ldap"]},"port":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Port","description":"LDAP server port","default":389,"examples":[389]},"is_ssl":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Ssl","description":"LDAP ssl connection","default":false,"examples":[false]}},"type":"object","required":["base_dn","address","bind_dn","password"],"title":"ConnectionPostParams","description":"Connection post handler params"},"ConnectionPostResponse":{"properties":{"groups":{"items":{"type":"string"},"type":"array","title":"Groups","description":"List of groups found in LDAP","examples":["cn=admins,cn=groups,dc=example,dc=com"]}},"type":"object","required":["groups"],"title":"ConnectionPostResponse","description":"Connection post handler response"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#\/components\/schemas\/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LdapType":{"type":"string","enum":["ldap","active_directory","free_ipa","ald_pro"],"title":"LdapType","description":"LDAP type."},"SettingGetResponse":{"properties":{"groups_bind":{"anyOf":[{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object"},{"type":"null"}],"title":"Groups Bind","description":"List of bind groups in LDAP","examples":["[\"cn=admins,cn=groups,dc=example,dc=com\"]"]},"auto_sync":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auto Sync","description":"The automatically syncing period. Use cron format or null","examples":["0 16 * * *"]},"last_sync":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sync","description":"Last sync time","examples":["2021-02-09T18:09:57"]},"base_dn":{"type":"string","title":"Base Dn","description":"Base Distinguished Name - the search will be started from such catalog object","examples":["dc=example,dc=com"]},"address":{"type":"string","title":"Address","description":"LDAP server address","examples":["192.168.0.5"]},"bind_dn":{"type":"string","title":"Bind Dn","description":"The bind user DN with database read right","examples":["cn=admin,dc=example,dc=com"]},"password":{"type":"string","title":"Password","description":"The bind user password","examples":["PaSSwOrd"]},"groups_dn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Groups Dn","description":"The part for searching groups with base DN","examples":["cn=groups"]},"groupname_attr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Groupname Attr","description":"The name of group attribute for users searching","examples":["memberOf"]},"email_attr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Attr","description":"The name of email attribute for users searching","examples":["mail"]},"blocked_attr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocked Attr","description":"The name of blocked attribute for users searching","examples":["nsaccountlock"]},"users_dn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Users Dn","description":"The part for searching users with base DN","examples":["cn=users"]},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","description":"Type of LDAP server. If AD or FreeIPA some arguments could not be send, i.e. users DN","examples":["ldap"]},"port":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Port","description":"LDAP server port","examples":[389]},"is_ssl":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Ssl","description":"LDAP ssl connection","examples":[false]}},"type":"object","title":"SettingGetResponse","description":"Settings handler response"},"SettingPostParams":{"properties":{"base_dn":{"type":"string","title":"Base Dn","description":"Base Distinguished Name - the search will be started from such catalog object","examples":["dc=example,dc=com"]},"address":{"type":"string","title":"Address","description":"LDAP server address","examples":["192.168.0.5"]},"bind_dn":{"type":"string","title":"Bind Dn","description":"The bind user DN with database read right","examples":["cn=admin,dc=example,dc=com"]},"password":{"type":"string","title":"Password","description":"The bind user password","examples":["PaSSwOrd"]},"users_dn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Users Dn","description":"The part for searching users with base DN","examples":["cn=users"]},"groups_dn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Groups Dn","description":"The part for searching groups with base DN","examples":["cn=groups"]},"groupname_attr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Groupname Attr","description":"The name of group attribute for users searching","examples":["memberOf"]},"email_attr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Attr","description":"The name of email attribute for users searching","examples":["mail"]},"blocked_attr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocked Attr","description":"The name of blocked attribute for users searching","examples":["nsaccountlock"]},"type":{"anyOf":[{"$ref":"#\/components\/schemas\/LdapType"},{"type":"null"}],"description":"Type of LDAP server. If AD or FreeIPA some arguments could not be send, i.e. users DN","default":"ldap","examples":["ldap"]},"port":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Port","description":"LDAP server port","default":389,"examples":[389]},"is_ssl":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Ssl","description":"LDAP ssl connection","default":false,"examples":[false]},"groups_bind":{"anyOf":[{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object"},{"type":"null"}],"title":"Groups Bind","description":"List of bind groups in LDAP","examples":["[\"cn=admins,cn=groups,dc=example,dc=com\"]"]},"auto_sync":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auto Sync","description":"The automatically syncing period. Use cron format or null","examples":["0 16 * * *"]}},"type":"object","required":["base_dn","address","bind_dn","password"],"title":"SettingPostParams","description":"Settings post handler params"},"SuccessSchema":{"properties":{"status":{"type":"string","title":"Status","description":"Success schema response","default":"ok"}},"type":"object","title":"SuccessSchema","description":"Success schema response"},"SyncPostResponseOne":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id","description":"The user identifier in the platform. Null if new user","examples":[1]},"email":{"type":"string","title":"Email","description":"The user email","examples":["test@example.com"]},"role":{"type":"string","title":"Role","description":"The user role in the platform","examples":["@admin"]},"status":{"$ref":"#\/components\/schemas\/UserStatus","description":"What's gone be done with user:\n    * `new` - New user adding or user data changing\n    * `removed` - The user was removed in LDAP and will be blocked at platform\n    * `blocked` - The user was blocked in LDAP and will be blocked at platform\n    * `unblocked` - The user was unblocked or created in LDAP and will be unblocked at platform\n    ","examples":["new"]}},"type":"object","required":["email","role","status"],"title":"SyncPostResponseOne","description":"Sync post response one"},"SyncStatusResponse":{"properties":{"is_running":{"type":"boolean","title":"Is Running","description":"Sync running status","examples":[true]}},"type":"object","required":["is_running"],"title":"SyncStatusResponse","description":"Sync get response status"},"UserStatus":{"type":"string","enum":["new","removed","blocked","unblocked"],"title":"UserStatus","description":"User status for syncing."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"ldap","description":"handlers for ldap service"}]}

The article was last updated on 05.14.2025. The article was prepared by technical writers of ISPsystem