VMware Cloud Director API - LdapSettings

VMware Cloud Director API - LdapSettings

LdapSettingsType

Element:
LdapSettings
Type:
LdapSettingsType
Namespace:
http://www.vmware.com/vcloud/extension/v1.5
Description:
Defines the hostname and connection details for system LDAP service.
Since:
1.5
Schema:
settings.xsd
Media type(s):
application/vnd.vmware.admin.ldapSettings+json
application/vnd.vmware.admin.ldapSettings+xml
Extends:
ResourceType
XML Representation:
<LdapSettings xmlns="http://www.vmware.com/vcloud/extension/v1.5" xmlns:vcloud_v1.5="http://www.vmware.com/vcloud/v1.5" href="xs:anyURI" type="xs:string">
    <vcloud_v1.5:Link href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"
            rel="xs:string" model="xs:string"/>
    <HostName> xs:string </HostName>
    <Port> xs:int </Port>
    <IsSsl> xs:boolean </IsSsl>
    <CustomTruststore> xs:string </CustomTruststore>
    <Realm> xs:string </Realm>
    <PagedSearchDisabled> xs:boolean </PagedSearchDisabled>
    <PageSize> xs:int </PageSize>
    <MaxResults> xs:int </MaxResults>
    <MaxUserGroups> xs:int </MaxUserGroups>
    <SearchBase> xs:string </SearchBase>
    <UserName> xs:string </UserName>
    <Password> xs:string </Password>
    <AuthenticationMechanism> xs:string </AuthenticationMechanism>
    <GroupSearchBase> xs:string </GroupSearchBase>
    <IsGroupSearchBaseEnabled> xs:boolean </IsGroupSearchBaseEnabled>
    <ConnectorType> xs:string </ConnectorType>
    <UserAttributes href="xs:anyURI" type="xs:string">
        <vcloud_v1.5:Link href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"
                rel="xs:string" model="xs:string"/>
        <ObjectClass> xs:string </ObjectClass>
        <ObjectIdentifier> xs:string </ObjectIdentifier>
        <UserName> xs:string </UserName>
        <Email> xs:string </Email>
        <FullName> xs:string </FullName>
        <GivenName> xs:string </GivenName>
        <Surname> xs:string </Surname>
        <Telephone> xs:string </Telephone>
        <GroupMembershipIdentifier> xs:string </GroupMembershipIdentifier>
        <GroupBackLinkIdentifier> xs:string </GroupBackLinkIdentifier>
    </UserAttributes>
    <GroupAttributes href="xs:anyURI" type="xs:string">
        <vcloud_v1.5:Link href="xs:anyURI" id="xs:string" type="xs:string" name="xs:string"
                rel="xs:string" model="xs:string"/>
        <ObjectClass> xs:string </ObjectClass>
        <ObjectIdentifier> xs:string </ObjectIdentifier>
        <GroupName> xs:string </GroupName>
        <Membership> xs:string </Membership>
        <MembershipIdentifier> xs:string </MembershipIdentifier>
        <BackLinkIdentifier> xs:string </BackLinkIdentifier>
    </GroupAttributes>
    <CustomUiButtonLabel> xs:string </CustomUiButtonLabel>
</LdapSettings>

Attributes

Attribute Type Required Modifiable Since Deprecated Description
href anyURI No always 1.5 The URI of the entity.
type string No always 1.5 The MIME type of the entity.

Elements

Element Type Required Modifiable Since Deprecated Description
AuthenticationMechanism string Yes always 1.5 Defines the authentication mechanism used by the LDAP service.
ConnectorType string Yes always 1.5 Defines the type of the LDAP service.
CustomTruststore string No always 31.0 34.0 Optional Custom Truststore for the LDAP HostName. Until it is removed the certificate can still be set here, however this field will always be null on return. This field is under accelerated deprecation and will be removed more quickly than the normal deprecation cycle. In order to manage LDAP certificates, please instead use the Centralized SSL management API.
CustomUiButtonLabel string No always 38.1 Custom label to use when displaying this LDAP configuration on the VCD login pane. If null, a default label will be used.
GroupAttributes LdapGroupAttributesType Yes always 1.5 Defines how LDAP attributes are used when importing a group.
GroupSearchBase string No always 1.5 LDAP group search base.
HostName string No always 1.5 Hostname of the LDAP server.
IsGroupSearchBaseEnabled boolean Yes always 1.5 True if the group search base is enabled.
IsSsl boolean Yes always 1.5 True if the LDAP service requires an SSL connection.
Link LinkType No none 1.5 A reference to an entity or operation associated with this object.
MaxResults int No always 1.5 Maximum results returned.
MaxUserGroups int No always 1.5 Maximum results returned for user groups.
PageSize int No always 1.5 Size of the page.
PagedSearchDisabled boolean Yes always 1.5 True if paged search is disabled.
Password string No always 1.5 Password for the user identified by UserName. This value is never returned by GET. It is inspected on create and modify. On modify, the absence of this element indicates that the password should not be changed.
Port int Yes always 1.5 Port at which to connect to the LDAP service.
Realm string No always 1.5 LDAP realm to use when looking up users.
SearchBase string No always 1.5 LDAP search base.
UserAttributes LdapUserAttributesType Yes always 1.5 Defines how LDAP attributes are used when importing a user.
UserName string No always 1.5 Username to use when logging in to LDAP, specified using LDAP attribute=value pairs (for example: cn="ldap-admin", c="example", dc="com").
VCloudExtension VCloudExtensionType No always 1.5 An optional extension element that can contain an arbitrary number of elements and attributes. Not related to extension services.

Operations

CRUD Operation Description Since Deprecated
read GET /admin/extension/settings/ldapSettings Retrieve system LDAP settings. 1.5
as input PUT /admin/extension/settings/ldapSettings Update system LDAP settings. 1.5