|
对于最新的稳定版本,请使用 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.
有关详细信息,请参阅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 集成时,此功能非常有用。