WildFly 37 Model Reference

A realm definition for authentication and authorization of identities distributed between multiple realms.

Provided capabilities(1)

Name	Dynamic	Other provider points
org.wildfly.security.security-realm	true	/subsystem=elytron/jaas-realm=* /subsystem=elytron/jdbc-realm=* /subsystem=elytron/filesystem-realm=* /subsystem=elytron/token-realm=* /subsystem=elytron/ldap-realm=* /subsystem=elytron/key-store-realm=* /subsystem=elytron/failover-realm=* /subsystem=elytron/custom-modifiable-realm=* /subsystem=elytron/identity-realm=* /subsystem=elytron/aggregate-realm=* /subsystem=elytron/properties-realm=* /subsystem=elytron/caching-realm=* /subsystem=elytron/custom-realm=*

Attributes (3)

emit-events Whether a SecurityEvent signifying realm unavailability should be emitted, applicable only when the ignore-unavailable-realms attribute is set to true. The default value is true.

Attribute	Value
Default Value	true
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	all-services
Stability	default

ignore-unavailable-realms Whether subsequent realms should be checked after an unavailable realm is reached. If set to false or not set, when the unavailable realm is reached "org.wildfly.security.auth.server.RealmUnavailableException" is thrown and the search stops. The default value is false.

Attribute	Value
Default Value	false
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	all-services
Stability	default

realms References to one or more security realms for authentication and authorization.

Attribute	Value
Capability reference	/subsystem=elytron/jaas-realm=* /subsystem=elytron/jdbc-realm=* /subsystem=elytron/filesystem-realm=* /subsystem=elytron/token-realm=* /subsystem=elytron/ldap-realm=* /subsystem=elytron/distributed-realm=* /subsystem=elytron/key-store-realm=* /subsystem=elytron/failover-realm=* /subsystem=elytron/custom-modifiable-realm=* /subsystem=elytron/identity-realm=* /subsystem=elytron/aggregate-realm=* /subsystem=elytron/properties-realm=* /subsystem=elytron/caching-realm=* /subsystem=elytron/custom-realm=*
Type	LIST
Nillable	false
Expressions Allowed	false
Storage	configuration
Access Type	read-write
Restart Required	all-services
Stability	default

Operations (2)

add The add operation for the security realm.

Request Parameter	Type	Required	Expressions Allowed	Default value	Description
emit-events	BOOLEAN	false	true	true	Whether a SecurityEvent signifying realm unavailability should be emitted, applicable only when the ignore-unavailable-realms attribute is set to true. The default value is true.
ignore-unavailable-realms	BOOLEAN	false	true	false	Whether subsequent realms should be checked after an unavailable realm is reached. If set to false or not set, when the unavailable realm is reached "org.wildfly.security.auth.server.RealmUnavailableException" is thrown and the search stops. The default value is false.
realms	LIST	true	false		References to one or more security realms for authentication and authorization.

remove The remove operation for the security realm.