对于最新的稳定版本,请使用 Spring Security 6.5.3! |
Java 身份验证和授权服务 (JAAS) 提供程序
Spring Security 提供了一个包,用于将身份验证请求委托给 Java 身份验证和授权服务 (JAAS)。 本节讨论该包。
抽象JaasAuthenticationProvider
这AbstractJaasAuthenticationProvider
类是所提供 JAAS 的基础AuthenticationProvider
实现。
子类必须实现一个方法,该方法创建LoginContext
.
这AbstractJaasAuthenticationProvider
有许多可以注入其中的依赖项,如本节其余部分所述。
JAAS 回调处理程序
大多数 JAASLoginModule
实例需要某种回调。
这些回调通常用于从用户那里获取用户名和密码。
在 Spring Security 部署中,Spring Security 负责此用户交互(通过身份验证机制)。
因此,当身份验证请求通过 JAAS 委托时,Spring Security 的身份验证机制已经完全填充了Authentication
包含 JAAS 所需的所有信息的对象LoginModule
.
因此,Spring Security的JAAS包提供了两个默认的回调处理程序:JaasNameCallbackHandler
和JaasPasswordCallbackHandler
.
这些回调处理程序中的每一个都实现了JaasAuthenticationCallbackHandler
.
在大多数情况下,这些回调处理程序可以在不了解内部机制的情况下使用。
对于那些需要完全控制回调行为的用户,AbstractJaasAuthenticationProvider
内部包装这些JaasAuthenticationCallbackHandler
实例中InternalCallbackHandler
.
这InternalCallbackHandler
是实际实现 JAAS normal 的类CallbackHandler
接口。
任何时候 JAASLoginModule
,则会传递已配置的应用程序上下文列表InternalCallbackHandler
实例。
如果LoginModule
请求针对InternalCallbackHandler
实例中,回调又传递给JaasAuthenticationCallbackHandler
实例被包装。
JAAS权威授予者
JAAS 与校长合作。
甚至“角色”在 JAAS 中也表示为主体。
另一方面,Spring Security 与Authentication
对象。
每Authentication
对象包含单个主体和多个GrantedAuthority
实例。
为了促进这些不同概念之间的映射,Spring Security 的 JAAS 包包括一个AuthorityGranter
接口。
一AuthorityGranter
负责检查 JAAS 主体并返回一组String
表示分配给主体的权限的对象。
对于每个返回的权限字符串,AbstractJaasAuthenticationProvider
创建一个JaasGrantedAuthority
(实现 Spring Security 的GrantedAuthority
接口),其中包含权限字符串和 JAAS 主体,该AuthorityGranter
被通过了。
这AbstractJaasAuthenticationProvider
通过首先使用 JAAS 成功验证用户的凭证来获取 JAAS 主体LoginModule
,然后访问LoginContext
它返回。
对LoginContext.getSubject().getPrincipals()
,每个生成的主体都会传递给每个AuthorityGranter
根据AbstractJaasAuthenticationProvider.setAuthorityGranters(List)
财产。
Spring Security 不包括任何生产AuthorityGranter
实例,因为每个 JAAS 主体都具有特定于实现的含义。
但是,有一个TestAuthorityGranter
在单元测试中,演示了简单的AuthorityGranter
实现。
默认 JaasAuthenticationProvider
这DefaultJaasAuthenticationProvider
让 JAASConfiguration
对象作为依赖项注入其中。
然后它会创建一个LoginContext
通过使用注入的 JAASConfiguration
.
这意味着DefaultJaasAuthenticationProvider
不受任何特定实现的约束Configuration
如JaasAuthenticationProvider
是。
内存配置
为了便于注射Configuration
到DefaultJaasAuthenticationProvider
,默认内存中实现名为InMemoryConfiguration
被提供。
实现构造函数接受Map
其中每个键代表一个登录配置名称,该值代表一个Array
之AppConfigurationEntry
实例。InMemoryConfiguration
还支持默认的Array
之AppConfigurationEntry
如果在提供的Map
.
有关详细信息,请参阅Javadoc 的InMemoryConfiguration
.
DefaultJaasAuthenticationProvider 示例配置
虽然 Spring 配置InMemoryConfiguration
可以比标准 JAAS 配置文件更详细,将其与DefaultJaasAuthenticationProvider
比JaasAuthenticationProvider
,因为它不依赖于默认值Configuration
实现。
下一个示例提供了DefaultJaasAuthenticationProvider
使用InMemoryConfiguration
.
请注意,自定义实现Configuration
可以很容易地注射到DefaultJaasAuthenticationProvider
也。
<bean id="jaasAuthProvider"
class="org.springframework.security.authentication.jaas.DefaultJaasAuthenticationProvider">
<property name="configuration">
<bean class="org.springframework.security.authentication.jaas.memory.InMemoryConfiguration">
<constructor-arg>
<map>
<!--
SPRINGSECURITY is the default loginContextName
for AbstractJaasAuthenticationProvider
-->
<entry key="SPRINGSECURITY">
<array>
<bean class="javax.security.auth.login.AppConfigurationEntry">
<constructor-arg value="sample.SampleLoginModule" />
<constructor-arg>
<util:constant static-field=
"javax.security.auth.login.AppConfigurationEntry$LoginModuleControlFlag.REQUIRED"/>
</constructor-arg>
<constructor-arg>
<map></map>
</constructor-arg>
</bean>
</array>
</entry>
</map>
</constructor-arg>
</bean>
</property>
<property name="authorityGranters">
<list>
<!-- You will need to write your own implementation of AuthorityGranter -->
<bean class="org.springframework.security.authentication.jaas.TestAuthorityGranter"/>
</list>
</property>
</bean>
Jaas身份验证提供程序
这JaasAuthenticationProvider
假定默认的Configuration
是ConfigFile
.
做出此假设是为了尝试更新Configuration
.
这JaasAuthenticationProvider
然后使用默认的Configuration
创建LoginContext
.
假设我们有一个 JAAS 登录配置文件/WEB-INF/login.conf
,内容如下:
JAASTest {
sample.SampleLoginModule required;
};
与所有 Spring Security Bean 一样,JaasAuthenticationProvider
通过应用程序上下文进行配置。
以下定义将对应于上述 JAAS 登录配置文件:
<bean id="jaasAuthenticationProvider"
class="org.springframework.security.authentication.jaas.JaasAuthenticationProvider">
<property name="loginConfig" value="/WEB-INF/login.conf"/>
<property name="loginContextName" value="JAASTest"/>
<property name="callbackHandlers">
<list>
<bean
class="org.springframework.security.authentication.jaas.JaasNameCallbackHandler"/>
<bean
class="org.springframework.security.authentication.jaas.JaasPasswordCallbackHandler"/>
</list>
</property>
<property name="authorityGranters">
<list>
<bean class="org.springframework.security.authentication.jaas.TestAuthorityGranter"/>
</list>
</property>
</bean>
作为一个主题跑步
如果已配置,则JaasApiIntegrationFilter
尝试以Subject
在JaasAuthenticationToken
.
这意味着Subject
可以使用以下方式访问:
Subject subject = Subject.getSubject(AccessController.getContext());
您可以使用 jaas-api-provision 属性配置此集成。 当与依赖于要填充的 JAAS 主题的旧 API 或外部 API 集成时,此功能非常有用。