Uses of Interface
org.apache.shiro.realm.Realm
-
Packages that use Realm Package Description org.apache.shiro.authc.pam Support for PAM, or Pluggable Authentication Modules, which is the capability to authenticate a user against multiple configurable (pluggable) modules (Shiro calls theseRealm
s).org.apache.shiro.authz Core interfaces and exceptions supporting Authorization (access control).org.apache.shiro.config org.apache.shiro.mgt Provides the masterSecurityManager
interface and a default implementation hierarchy for managing all aspects of Shiro's functionality in an application.org.apache.shiro.realm Components and sub-packages used in supporting the coreRealm
interface.org.apache.shiro.realm.activedirectory Realms that acquire security data from a Microsoft Active Directory.org.apache.shiro.realm.jdbc Realms that acquire security data from an RDBMS (Relational Database Management System) using the JDBC API.org.apache.shiro.realm.jndi Support for acquiring Realms from JNDI, particularly useful for configuring Shiro in JEE or EJB environments.org.apache.shiro.realm.ldap Realms that acquire security data from an LDAP (Lightweight Directory Access Protocol) server utilizing LDAP/Naming APIs.org.apache.shiro.realm.text Realms that acquire security data from text-based data sources such asFile
s or text streams. -
-
Uses of Realm in org.apache.shiro.authc.pam
Methods in org.apache.shiro.authc.pam that return types with arguments of type Realm Modifier and Type Method Description protected Collection<Realm>
ModularRealmAuthenticator. getRealms()
Returns the realm(s) used by thisAuthenticator
during an authentication attempt.Methods in org.apache.shiro.authc.pam with parameters of type Realm Modifier and Type Method Description AuthenticationInfo
AbstractAuthenticationStrategy. afterAttempt(Realm realm, AuthenticationToken token, AuthenticationInfo singleRealmInfo, AuthenticationInfo aggregateInfo, Throwable t)
Base implementation that will aggregate the specifiedsingleRealmInfo
into theaggregateInfo
and then returns the aggregate.AuthenticationInfo
AllSuccessfulStrategy. afterAttempt(Realm realm, AuthenticationToken token, AuthenticationInfo info, AuthenticationInfo aggregate, Throwable t)
Merges the specifiedinfo
into theaggregate
argument and returns it (just as the parent implementation does), but additionally ensures the following: if theThrowable
argument is notnull
, re-throws it to immediately cancel the authentication process, since this strategy requires all realms to authenticate successfully. neither theinfo
oraggregate
argument isnull
to ensure that each realm did in fact authenticate successfullyAuthenticationInfo
AuthenticationStrategy. afterAttempt(Realm realm, AuthenticationToken token, AuthenticationInfo singleRealmInfo, AuthenticationInfo aggregateInfo, Throwable t)
Method invoked by the ModularAuthenticator just after the given realm has been consulted for authentication, allowing post-authentication-attempt logic for that realm only.AuthenticationInfo
AbstractAuthenticationStrategy. beforeAttempt(Realm realm, AuthenticationToken token, AuthenticationInfo aggregate)
Simply returns theaggregate
method argument, without modification.AuthenticationInfo
AllSuccessfulStrategy. beforeAttempt(Realm realm, AuthenticationToken token, AuthenticationInfo info)
Because all realms in this strategy must complete successfully, this implementation ensures that the givenRealm
supports
the giventoken
argument.AuthenticationInfo
AuthenticationStrategy. beforeAttempt(Realm realm, AuthenticationToken token, AuthenticationInfo aggregate)
Method invoked by the ModularAuthenticator just prior to the realm being consulted for account data, allowing pre-authentication-attempt logic for that realm only.AuthenticationInfo
FirstSuccessfulStrategy. beforeAttempt(Realm realm, AuthenticationToken token, AuthenticationInfo aggregate)
Throws ShortCircuitIterationException if stopAfterFirstSuccess is set and authentication is successful with a previously consulted realm.protected AuthenticationInfo
ModularRealmAuthenticator. doSingleRealmAuthentication(Realm realm, AuthenticationToken token)
Performs the authentication attempt by interacting with the single configured realm, which is significantly simpler than performing multi-realm logic.Method parameters in org.apache.shiro.authc.pam with type arguments of type Realm Modifier and Type Method Description AuthenticationInfo
AbstractAuthenticationStrategy. beforeAllAttempts(Collection<? extends Realm> realms, AuthenticationToken token)
Simply returnsnew
, which supports aggregating account data across realms.SimpleAuthenticationInfo
();AuthenticationInfo
AuthenticationStrategy. beforeAllAttempts(Collection<? extends Realm> realms, AuthenticationToken token)
Method invoked by the ModularAuthenticator signifying that the authentication process is about to begin for the specifiedtoken
- called before anyRealm
is actually invoked.AuthenticationInfo
FirstSuccessfulStrategy. beforeAllAttempts(Collection<? extends Realm> realms, AuthenticationToken token)
Returnsnull
immediately, relying on this class'smerge
implementation to return only the firstinfo
object it encounters, ignoring all subsequent ones.protected AuthenticationInfo
ModularRealmAuthenticator. doMultiRealmAuthentication(Collection<Realm> realms, AuthenticationToken token)
Performs the multi-realm authentication attempt by calling back to aAuthenticationStrategy
object as each realm is consulted forAuthenticationInfo
for the specifiedtoken
.void
ModularRealmAuthenticator. setRealms(Collection<Realm> realms)
Sets all realms used by this Authenticator, providing PAM (Pluggable Authentication Module) configuration. -
Uses of Realm in org.apache.shiro.authz
Fields in org.apache.shiro.authz with type parameters of type Realm Modifier and Type Field Description protected Collection<Realm>
ModularRealmAuthorizer. realms
The realms to consult during any authorization check.Methods in org.apache.shiro.authz that return types with arguments of type Realm Modifier and Type Method Description Collection<Realm>
ModularRealmAuthorizer. getRealms()
Returns the realms wrapped by thisAuthorizer
which are consulted during an authorization check.Method parameters in org.apache.shiro.authz with type arguments of type Realm Modifier and Type Method Description void
ModularRealmAuthorizer. setRealms(Collection<Realm> realms)
Sets the realms wrapped by thisAuthorizer
which are consulted during an authorization check.Constructor parameters in org.apache.shiro.authz with type arguments of type Realm Constructor Description ModularRealmAuthorizer(Collection<Realm> realms)
Constructor that accepts theRealm
s to consult during an authorization check. -
Uses of Realm in org.apache.shiro.config
Methods in org.apache.shiro.config that return Realm Modifier and Type Method Description protected Realm
IniSecurityManagerFactory. createRealm(org.apache.shiro.config.Ini ini)
Deprecated.Creates aRealm
from the Ini instance containing account data.Method parameters in org.apache.shiro.config with type arguments of type Realm Modifier and Type Method Description protected void
IniSecurityManagerFactory. applyRealmsToSecurityManager(Collection<Realm> realms, SecurityManager securityManager)
Deprecated. -
Uses of Realm in org.apache.shiro.mgt
Methods in org.apache.shiro.mgt that return types with arguments of type Realm Modifier and Type Method Description Collection<Realm>
RealmSecurityManager. getRealms()
Returns theRealm
s managed by this SecurityManager instance.Methods in org.apache.shiro.mgt with parameters of type Realm Modifier and Type Method Description void
RealmSecurityManager. setRealm(Realm realm)
Convenience method for applications using a single realm that merely wraps the realm in a list and then invokes theRealmSecurityManager.setRealms(java.util.Collection<org.apache.shiro.realm.Realm>)
method.Method parameters in org.apache.shiro.mgt with type arguments of type Realm Modifier and Type Method Description void
RealmSecurityManager. setRealms(Collection<Realm> realms)
Sets the realms managed by this SecurityManager instance.Constructors in org.apache.shiro.mgt with parameters of type Realm Constructor Description DefaultSecurityManager(Realm singleRealm)
Supporting constructor for a single-realm application.Constructor parameters in org.apache.shiro.mgt with type arguments of type Realm Constructor Description DefaultSecurityManager(Collection<Realm> realms)
Supporting constructor for multiplerealms
. -
Uses of Realm in org.apache.shiro.realm
Classes in org.apache.shiro.realm that implement Realm Modifier and Type Class Description class
AuthenticatingRealm
A top-level abstract implementation of the Realm interface that only implements authentication support (log-in) operations and leaves authorization (access control) behavior to subclasses.class
AuthorizingRealm
AnAuthorizingRealm
extends theAuthenticatingRealm
's capabilities by adding Authorization (access control) support.class
CachingRealm
A very basic abstract extension point for theRealm
interface that provides caching support for subclasses.class
SimpleAccountRealm
A simple implementation of theRealm
interface that uses a set of configured user accounts and roles to support authentication and authorization.Methods in org.apache.shiro.realm that return types with arguments of type Realm Modifier and Type Method Description Collection<Realm>
RealmFactory. getRealms()
Returns a collection ofRealm
instances that will be used to construct the application's SecurityManager instance. -
Uses of Realm in org.apache.shiro.realm.activedirectory
Classes in org.apache.shiro.realm.activedirectory that implement Realm Modifier and Type Class Description class
ActiveDirectoryRealm
ARealm
that authenticates with an active directory LDAP server to determine the roles for a particular user. -
Uses of Realm in org.apache.shiro.realm.jdbc
Classes in org.apache.shiro.realm.jdbc that implement Realm Modifier and Type Class Description class
JdbcRealm
Realm that allows authentication and authorization via JDBC calls. -
Uses of Realm in org.apache.shiro.realm.jndi
Methods in org.apache.shiro.realm.jndi that return types with arguments of type Realm Modifier and Type Method Description Collection<Realm>
JndiRealmFactory. getRealms()
Performs the JNDI lookups for each specifiedJNDI name
and returns all discovered Realms in an ordered collection. -
Uses of Realm in org.apache.shiro.realm.ldap
Classes in org.apache.shiro.realm.ldap that implement Realm Modifier and Type Class Description class
AbstractLdapRealm
ARealm
that authenticates with an LDAP server to build the Subject for a user.class
DefaultLdapRealm
An LDAPRealm
implementation utilizing Sun's/Oracle's JNDI API as an LDAP API.class
JndiLdapRealm
Deprecated.Renamed toDefaultLdapRealm
, this class will be removed prior to 2.0 -
Uses of Realm in org.apache.shiro.realm.text
Classes in org.apache.shiro.realm.text that implement Realm Modifier and Type Class Description class
IniRealm
class
PropertiesRealm
ATextConfigurationRealm
that defers all logic to the parent class, but just enablesProperties
based configuration in addition to the parent class's String configuration.class
TextConfigurationRealm
A SimpleAccountRealm that enables text-based configuration of the initial User, Role, and Permission objects created at startup.
-