GSSAPI SASL Mechanism Handler

The GSSAPI SASL mechanism performs all processing related to SASL GSSAPI authentication using Kerberos V5.

The GSSAPI SASL mechanism provides the ability for clients to authenticate themselves to the server using existing authentication in a Kerberos environment. This mechanism provides the ability to achieve single sign-on for Kerberos-based clients.

Parent

The GSSAPI SASL Mechanism Handler object inherits from SASL Mechanism Handler.

Dependencies

GSSAPI SASL Mechanism Handlers depend on the following objects:

Properties

Use the --advanced option to access advanced properties.

Basic Properties

enabled

SynopsisIndicates whether the SASL mechanism handler is enabled for use.
Default ValueNone
Allowed Valuestrue
false
Multi-valuedNo
RequiredYes
Admin Action RequiredNone
AdvancedNo
Read-OnlyNo

identity-mapper

SynopsisSpecifies the name of the identity mapper that is to be used with this SASL mechanism handler to match the Kerberos principal included in the SASL bind request to the corresponding user in the directory.
Default ValueNone
Allowed ValuesThe name of an existing Identity Mapper. The referenced identity mapper must be enabled when the GSSAPI SASL Mechanism Handler is enabled.
Multi-valuedNo
RequiredYes
Admin Action RequiredNone
AdvancedNo
Read-OnlyNo

kdc-address

SynopsisSpecifies the address of the KDC that is to be used for Kerberos processing.
DescriptionIf provided, this property must be a fully-qualified DNS-resolvable name. If this property is not provided, then the server attempts to determine it from the system-wide Kerberos configuration.
Default ValueThe server attempts to determine the KDC address from the underlying system configuration.
Allowed ValuesA string.
Multi-valuedNo
RequiredNo
Admin Action RequiredNone
AdvancedNo
Read-OnlyNo

keytab

SynopsisSpecifies the path to the keytab file that should be used for Kerberos processing.
DescriptionIf provided, this is either an absolute path or one that is relative to the server instance root.
Default ValueThe server attempts to use the system-wide default keytab.
Allowed ValuesA string.
Multi-valuedNo
RequiredNo
Admin Action RequiredNone
AdvancedNo
Read-OnlyNo

principal-name

SynopsisSpecifies the principal name.
DescriptionIt can either be a simple user name or a service name such as host/example.com. If this property is not provided, then the server attempts to build the principal name by appending the fully qualified domain name to the string "ldap/".
Default ValueThe server attempts to determine the principal name from the underlying system configuration.
Allowed ValuesA string.
Multi-valuedNo
RequiredNo
Admin Action RequiredNone
AdvancedNo
Read-OnlyNo

quality-of-protection

SynopsisThe name of a property that specifies the quality of protection the server will support.
Default Valuenone
Allowed Values

confidentiality: Quality of protection equals authentication with integrity and confidentiality protection.

integrity: Quality of protection equals authentication with integrity protection.

none: QOP equals authentication only.

Multi-valuedNo
RequiredNo
Admin Action RequiredNone
AdvancedNo
Read-OnlyNo

realm

SynopsisSpecifies the realm to be used for GSSAPI authentication.
Default ValueThe server attempts to determine the realm from the underlying system configuration.
Allowed ValuesA string.
Multi-valuedNo
RequiredNo
Admin Action RequiredNone
AdvancedNo
Read-OnlyNo

server-fqdn

SynopsisSpecifies the DNS-resolvable fully-qualified domain name for the system.
Default ValueThe server attempts to determine the fully-qualified domain name dynamically .
Allowed ValuesA string.
Multi-valuedNo
RequiredNo
Admin Action RequiredNone
AdvancedNo
Read-OnlyNo

Advanced Properties

java-class

SynopsisSpecifies the fully-qualified name of the Java class that provides the SASL mechanism handler implementation.
Default Valueorg.opends.server.extensions.GSSAPISASLMechanismHandler
Allowed ValuesA Java class that extends or implements:
org.opends.server.api.SASLMechanismHandler
Multi-valuedNo
RequiredYes
Admin Action RequiredThe object must be disabled and re-enabled for changes to take effect.
AdvancedYes
Read-OnlyNo