In addition to the three built-in realms, you can also create custom realms that store user data in some other way, such as in a relational database. Development of a custom realm is outside the scope of this document.
For administration purposes, custom realms are implemented by a class (called the LoginModule
) derived from the Java Authentication and Authorization Service (JAAS) package.
Follow the procedure in To Create a Realm, typing the name of the custom realm and the name of the LoginModule
class.
Use any unique name for the custom realm, for example myCustomRealm
.
Click OK.
Edit the domain's login configuration file, domain-dir/config/login.conf
, and add the fully qualified class name of the JAAS LoginModule
at the end of the file, as follows:
realmName { fully-qualified-LoginModule-classname required; };
For example,
myCustomRealm { com.foo.bar.security.customrealm.simpleCustomLoginModule required; };
Copy the LoginModule
class and all dependent classes into the directory domain-dir/lib/classes
.
Restart the server if Restart Required appears in the Administration Console.
Ensure that the realm is properly loaded.
Check domain-dir/logs/server.log
to ensure that the server loaded the realm. The server should invoke the realm's init
method.