Legrand / Raritan / Server Technology Xerus™ JSON-RPC API: auth::LdapManager Interface Reference

Legrand / Raritan / Server Technology Xerus™ JSON-RPC API

Loading...
Searching...
No Matches
Classes | Public Types | Public Member Functions | Public Attributes | List of all members
auth::LdapManager Interface Reference

LDAP server configuration interface. More...

## Classes
struct | ServerSettings
| Server settings. More...

## Public Types
enum | ServerType { ACTIVE_DIRECTORY , OPEN_LDAP }
| LDAP server type. More...
enum | SecurityProtocol { SEC_PROTO_NONE , SEC_PROTO_SSL , SEC_PROTO_STARTTLS }
| LDAP server type. More...

## Public Member Functions
vector< ServerSettings > | getLdapServers ()
| Get a list of LDAP server settings. More...
int | setLdapServers (in vector< ServerSettings > serverList)
| Sets a list of LDAP servers. More...
int | testLdapServer (in string username, in string password, in ServerSettings settings, out string diagMsg)
| Tests an LDAP server configuration. More...

## Public Attributes
constant int | ERR_CYCLIC_DEP = 1
| Cyclic dependency in server list.
constant int | ERR_INVALID_CFG = 2
| The server configuration is invalid.
constant int | ERR_SERVER_UNSPECIFIED = 1
| Unspecified error.
constant int | ERR_SERVER_UNREACHABLE = 3
| LDAP server could not be contacted.
constant int | ERR_AUTHENTICATION_FAILED = 4
| User could not be authenticated.
constant int | ERR_NO_ROLES = 5
| No roles are defined for the user.
constant int | ERR_NO_KNOWN_ROLES = 6
| No known rules are defined for the user.

## Detailed Description

LDAP server configuration interface.

## Member Enumeration Documentation

## ◆ SecurityProtocol

enum auth::LdapManager::SecurityProtocol

LDAP server type.

Enumerator
SEC_PROTO_NONE | no security protocol
SEC_PROTO_SSL | use SSL
SEC_PROTO_STARTTLS | use STARTTLS

## ◆ ServerType

enum auth::LdapManager::ServerType

LDAP server type.

Enumerator
ACTIVE_DIRECTORY | Active directory.
OPEN_LDAP | OpenLDAP.

## Member Function Documentation

## ◆ getLdapServers()

vector< ServerSettings > auth::LdapManager::getLdapServers | ( |  | ) |

Get a list of LDAP server settings.

Returns
  list of ServerSettings

## ◆ setLdapServers()

int auth::LdapManager::setLdapServers | ( | in vector< ServerSettings > | serverList | ) |

Sets a list of LDAP servers.

Any existing LDAP Server configuration will be cleared / overwritten.

Returns
  0 on success
  `ERR_CYCLIC_DEP` in case of cyclic dependency
  `ERR_INVALID_CFG` in case of invalid configuration

## ◆ testLdapServer()

int auth::LdapManager::testLdapServer | ( | in string | username,
|  | in string | password,
|  | in ServerSettings | settings,
|  | out string | diagMsg
| ) |  |

Tests an LDAP server configuration.

Returns
  0 on success
  `ERR_SERVER_UNSPECIFIED` an unspecified error occurred
  `ERR_INVALID_CFG` LDAP server configuration is invalid (reused from setLdapServers)
  `ERR_SERVER_UNREACHABLE` LDAP server could not be contacted
  `ERR_AUTHENTICATION_FAILED` user could not be authenticated
  `ERR_NO_ROLES` no roles are defined for the user
  `ERR_NO_KNOWN_ROLES` no known roles are defined for the user

The documentation for this interface was generated from the following file:

- LdapManager.idl