The configuration to connect to a directory (LDAP) server.
| Name | Dynamic | Other provider points | 
|---|---|---|
| org.wildfly.security.dir-context | true | none | 
| Attribute | Value | 
|---|---|
| Capability reference | |
| Type | STRING | 
| Nillable | true | 
| Expressions Allowed | false | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Attribute | Value | 
|---|---|
| Default Value | simple | 
| Type | STRING | 
| Nillable | true | 
| Expressions Allowed | true | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Attribute | Value | 
|---|---|
| Type | INT | 
| Nillable | true | 
| Expressions Allowed | true | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Attribute | Value | 
|---|---|
| Type | OBJECT | 
| Nillable | true | 
| Expressions Allowed | false | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | no-services | 
| Attribute | Value | 
|---|---|
| Default Value | false | 
| Type | BOOLEAN | 
| Nillable | true | 
| Expressions Allowed | true | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Attribute | Value | 
|---|---|
| Type | STRING | 
| Nillable | true | 
| Expressions Allowed | true | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Attribute | Value | 
|---|---|
| Type | STRING | 
| Nillable | true | 
| Expressions Allowed | true | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Attribute | Value | 
|---|---|
| Type | OBJECT | 
| Nillable | true | 
| Expressions Allowed | false | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Attribute | Value | 
|---|---|
| Type | INT | 
| Nillable | true | 
| Expressions Allowed | true | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Attribute | Value | 
|---|---|
| Default Value | IGNORE | 
| Type | STRING | 
| Nillable | true | 
| Expressions Allowed | true | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Allowed Values | FOLLOW IGNORE THROW | 
| Attribute | Value | 
|---|---|
| Capability reference | |
| Type | STRING | 
| Nillable | true | 
| Expressions Allowed | false | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Attribute | Value | 
|---|---|
| Type | STRING | 
| Nillable | false | 
| Expressions Allowed | true | 
| Storage | configuration | 
| Access Type | read-write | 
| Restart Required | all-services | 
| Request Parameter | Type | Required | Expressions Allowed | Default value | Description | 
|---|---|---|---|---|---|
| authentication-context | STRING | false | false | The authentication context to obtain login credentials to connect to the LDAP server. Can be omitted if authentication-level is "none" (anonymous). | |
| authentication-level | STRING | false | true | simple | The authentication level (security level/authentication mechanism) to use. Corresponds to SECURITY_AUTHENTICATION ("java.naming.security.authentication") environment property. Allowed values: "none", "simple", sasl_mech, where sasl_mech is a space-separated list of SASL mechanism names. | 
| connection-timeout | INT | false | true | The timeout for connecting to the LDAP server in milliseconds. | |
| credential-reference | OBJECT | false | false | The credential reference to authenticate and connect to the LDAP server. Can be omitted if authentication-level is "none" (anonymous). | |
| enable-connection-pooling | BOOLEAN | false | true | false | Indicates if connection pooling is enabled. | 
| module | STRING | false | true | Name of module that will be used as class loading base. | |
| principal | STRING | false | true | The principal to authenticate and connect to the LDAP server. Can be omitted if authentication-level is "none" (anonymous). | |
| properties | OBJECT | false | false | The additional connection properties for the DirContext. | |
| read-timeout | INT | false | true | The read timeout for an LDAP operation in milliseconds. | |
| referral-mode | STRING | false | true | IGNORE | If referrals should be followed. | 
| ssl-context | STRING | false | false | The name of ssl-context used to secure connection to the LDAP server. | |
| url | STRING | true | true | The connection url. |