<?xml version="1.0" encoding="UTF-8"?>
|
<!--
|
! CDDL HEADER START
|
!
|
! The contents of this file are subject to the terms of the
|
! Common Development and Distribution License, Version 1.0 only
|
! (the "License"). You may not use this file except in compliance
|
! with the License.
|
!
|
! You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
|
! or http://forgerock.org/license/CDDLv1.0.html.
|
! See the License for the specific language governing permissions
|
! and limitations under the License.
|
!
|
! When distributing Covered Code, include this CDDL HEADER in each
|
! file and include the License file at legal-notices/CDDLv1_0.txt.
|
! If applicable, add the following below this CDDL HEADER, with the
|
! fields enclosed by brackets "[]" replaced with your own identifying
|
! information:
|
! Portions Copyright [yyyy] [name of copyright owner]
|
!
|
! CDDL HEADER END
|
!
|
!
|
! Copyright 2007-2008 Sun Microsystems, Inc.
|
! -->
|
<adm:managed-object name="digest-md5-sasl-mechanism-handler"
|
plural-name="digest-md5-sasl-mechanism-handlers"
|
package="org.opends.server.admin.std" extends="sasl-mechanism-handler"
|
xmlns:adm="http://www.opends.org/admin"
|
xmlns:ldap="http://www.opends.org/admin-ldap">
|
<adm:synopsis>
|
The DIGEST-MD5 SASL mechanism
|
is used to perform all processing related to SASL DIGEST-MD5
|
authentication.
|
</adm:synopsis>
|
<adm:description>
|
The DIGEST-MD5 SASL mechanism is very similar
|
to the CRAM-MD5 mechanism in that it allows for password-based
|
authentication without exposing the password in the clear
|
(although it does require that both the client and the server
|
have access to the clear-text password). Like the CRAM-MD5
|
mechanism, it uses data that is randomly generated by the server
|
to make it resistant to replay attacks, but it also includes
|
randomly-generated data from the client, which makes it also
|
resistant to problems resulting from weak server-side random
|
number generation.
|
</adm:description>
|
<adm:profile name="ldap">
|
<ldap:object-class>
|
<ldap:name>ds-cfg-digest-md5-sasl-mechanism-handler</ldap:name>
|
<ldap:superior>ds-cfg-sasl-mechanism-handler</ldap:superior>
|
</ldap:object-class>
|
</adm:profile>
|
<adm:property-override name="java-class" advanced="true">
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>
|
org.opends.server.extensions.DigestMD5SASLMechanismHandler
|
</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
</adm:property-override>
|
<adm:property name="realm">
|
<adm:synopsis>
|
Specifies the realms that is to be used by the server for
|
DIGEST-MD5 authentication.
|
</adm:synopsis>
|
<adm:description>
|
If this value is not provided, then the server defaults to use the fully
|
qualified hostname of the machine.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:alias>
|
<adm:synopsis>
|
If this value is not provided, then the server defaults to use the fully
|
qualified hostname of the machine.
|
</adm:synopsis>
|
</adm:alias>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:string>
|
<adm:pattern>
|
<adm:regex>.*</adm:regex>
|
<adm:usage>STRING</adm:usage>
|
<adm:synopsis>
|
Any realm string that does not contain a comma.
|
</adm:synopsis>
|
</adm:pattern>
|
</adm:string>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-realm</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="quality-of-protection">
|
<adm:synopsis>
|
The name of a property that specifies the quality of protection
|
the server will support.
|
</adm:synopsis>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>none</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:enumeration>
|
<adm:value name="none">
|
<adm:synopsis>
|
QOP equals authentication only.
|
</adm:synopsis>
|
</adm:value>
|
<adm:value name="integrity">
|
<adm:synopsis>
|
Quality of protection equals authentication with integrity
|
protection.
|
</adm:synopsis>
|
</adm:value>
|
<adm:value name="confidentiality">
|
<adm:synopsis>
|
Quality of protection equals authentication with integrity and
|
confidentiality protection.
|
</adm:synopsis>
|
</adm:value>
|
</adm:enumeration>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-quality-of-protection</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="identity-mapper" mandatory="true">
|
<adm:synopsis>
|
Specifies the name of the identity mapper that is to be used
|
with this SASL mechanism handler to match the authentication
|
or authorization
|
ID included in the SASL bind request to the corresponding
|
user in the directory.
|
</adm:synopsis>
|
<adm:syntax>
|
<adm:aggregation relation-name="identity-mapper"
|
parent-path="/">
|
<adm:constraint>
|
<adm:synopsis>
|
The referenced identity mapper must be enabled when the
|
<adm:user-friendly-name />
|
is enabled.
|
</adm:synopsis>
|
<adm:target-needs-enabling-condition>
|
<adm:contains property="enabled" value="true" />
|
</adm:target-needs-enabling-condition>
|
<adm:target-is-enabled-condition>
|
<adm:contains property="enabled" value="true" />
|
</adm:target-is-enabled-condition>
|
</adm:constraint>
|
</adm:aggregation>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-identity-mapper</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
|
<adm:property name="server-fqdn">
|
<adm:synopsis>
|
Specifies the DNS-resolvable fully-qualified domain name for the
|
server that is used when validating the digest-uri parameter during
|
the authentication process.
|
</adm:synopsis>
|
<adm:description>
|
If this configuration attribute is
|
present, then the server expects that clients use a digest-uri equal
|
to "ldap/" followed by the value of this attribute. For example, if
|
the attribute has a value of "directory.example.com", then the
|
server expects clients to use a digest-uri of
|
"ldap/directory.example.com". If no value is provided, then the
|
server does not attempt to validate the digest-uri provided by the
|
client and accepts any value.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:alias>
|
<adm:synopsis>
|
The server attempts to determine the
|
fully-qualified domain name dynamically.
|
</adm:synopsis>
|
</adm:alias>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:string>
|
<adm:pattern>
|
<adm:regex>.*</adm:regex>
|
<adm:usage>STRING</adm:usage>
|
<adm:synopsis>
|
The fully-qualified address that is expected for clients to use
|
when connecting to the server and authenticating via DIGEST-MD5.
|
</adm:synopsis>
|
</adm:pattern>
|
</adm:string>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-server-fqdn</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
</adm:managed-object>
|
