[[415177]]
Keycloak对流行的Java应用提供了适配器。在系列著作的上一篇咱们演示了针对Spring Boot的安全保护，用的即是适配器的一种。Keycloak雷同提供Spring Security的适配器，后续的几篇著作咱们就来共同学习Spring Security适配器的使用。
Keycloak的装配可参考前边的系列教程。
适配器集成在Spring 应用中咱们集成keycloak-spring-security-adapter：
<dependency> <groupId>org.keycloak</groupId> <artifactId>keycloak-spring-security-adapter</artifactId> <version>15.0.0</version> </dependency>
在Spring Boot中不错这么集成：
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-security</artifactId> </dependency> <dependency> <groupId>org.keycloak</groupId> <artifactId>keycloak-spring-boot-starter</artifactId> <version>15.0.0</version> </dependency>
然后就能应用Spring Security的特质来集成Keycloak。Keycloak 提供了一个 KeycloakWebSecurityConfigurerAdapter 看成创建WebSecurityConfigurer 实例的便捷基类。咱们不错编写了一个设置类来定制咱们的安全计策，就像这么：
@KeycloakConfiguration public class SecurityConfig extends KeycloakWebSecurityConfigurerAdapter { /** * 注册了一个Keycloak的AuthenticationProvider */ @Autowired public void configureGlobal(AuthenticationManagerBuilder auth) throws Exception { auth.authenticationProvider(keycloakAuthenticationProvider()); } /** * 界说会话计策 */ @Bean @Override protected SessionAuthenticationStrategy sessionAuthenticationStrategy() { return new RegisterSessionAuthenticationStrategy(new SessionRegistryImpl()); } /** * 常见的Spring Security安全计策 */ @Override protected void configure(HttpSecurity http) throws Exception { super.configure(http); http .authorizeRequests() .antMatchers("/customers*").hasRole("USER") .antMatchers("/admin/**").hasRole("base_user") .anyRequest().permitAll(); } }
真贵：上头的设置并不可告成。
设置完上头的然后咱们平直开动应用，恶果并不像祈望的那样：
java.io.FileNotFoundException: Unable to locate Keycloak configuration file: keycloak.json
抛出找不到 keycloak.json文献的相配。Keycloak维持的每个Java适配器都不错通过一个简便的JSON文献进行设置，咱们缺失的即是这个文献。
{ "realm" : "demo", "resource" : "customer-portal", "realm-public-key" : "MIGfMA0GCSqGSIb3D...31LwIDAQAB", "auth-server-url" : "https://localhost:8443/auth", "ssl-required" : "external", "use-resource-role-mappings" : false, "enable-cors" : true, "cors-max-age" : 1000, "cors-allowed-methods" : "POST, PUT, DELETE, GET", "cors-exposed-headers" : "WWW-Authenticate, My-custom-exposed-Header", "bearer-only" : false, "enable-basic-auth" : false, "expose-token" : true, "verify-token-audience" : true, "credentials" : { "secret" : "234234-234234-234234" }, "connection-pool-size" : 20, "socket-timeout-millis": 5000, "connection-timeout-millis": 6000, "connection-ttl-millis": 500, "disable-trust-manager": false, "allow-any-hostname" : false, "truststore" : "path/to/truststore.jks", "truststore-password" : "geheim", "client-keystore" : "path/to/client-keystore.jks", "client-keystore-password" : "geheim", "client-key-password" : "geheim", "token-minimum-time-to-live" : 10, "min-time-between-jwks-requests" : 10, "public-key-cache-ttl": 86400, "redirect-rewrite-rules" : { "^/wsmaster/api/(.*)$" : "/api/$1" } }
上头包含的客户端设置属性都不错在Keycloak截止台进行设置，见下图：
设置Keycloak客户端属性
也即是说咱们需要的json文献和图中的设置项是对应的。相比东谈主性化的是咱们不需要自行编写这个json文献，Keycloak提供了下载客户端设置的表率，这里我只使用了必要的设置项：
你不错下载客户端json设置
引入客户端设置天然告成拿到json文献，可是加载这个json设置却不太告成，经过我的摸索需要终了一个KeycloakConfigResolver并注入Spring IoC，有底下两种终了款式。
复用Spring Boot Adapter设置
平直复用Spring Boot的设置体式，先声明Spring Boot的KeycloakConfigResolver终了：
/** * 复用spring boot 的表率 * * @return the keycloak config resolver */ @Bean public KeycloakConfigResolver keycloakConfigResolver() { return new KeycloakSpringBootConfigResolver(); }
然后复用Spring Boot的application.yaml的设置项：
复用Spring Boot设置项
正本的变装资源映射不断失效。
自界说终了
你也不错自界说写观念，这个技能json体式仍是不紧要了，你不错将json文献的内容存储到任何你擅长的方位。
/** * 我方写观念 * * @return the keycloak config resolver */ @Bean public KeycloakConfigResolver fileKeycloakConfigResolver() { return new KeycloakConfigResolver() { @SneakyThrows @Override public KeycloakDeployment resolve(HttpFacade.Request request) { // json 文献放到resources 文献夹下 ClassPathResource classPathResource = new ClassPathResource("./keycloak.json"); AdapterConfig adapterConfig = new ObjectMapper().readValue(classPathResource.getFile(), AdapterConfig.class); return KeycloakDeploymentBuilder.build(adapterConfig); } }; }
变装定名计策
Spring Security会为每个变装添加ROLE_前缀，这需要咱们声明GrantedAuthoritiesMapper的终了SimpleAuthorityMapper来完成这一功能。Keycloak在KeycloakAuthenticationProvider中设置该功能：
KeycloakAuthenticationProvider authenticationProvider = keycloakAuthenticationProvider(); authenticationProvider.setGrantedAuthoritiesMapper(new SimpleAuthorityMapper());竣工的设置
applicaiton.yaml:
keycloak: # 声明客户端所在的realm realm: felord.cn # keycloak授权行状器的地址 auth-server-url: http://localhost:8011/auth # 客户端称号 resource: springboot-client # 声明这是一个公开的客户端，不然不可在keycloak外部环境使用，会403 public-client: true
这里要皆集Keycloak导出的json文献设置。
Spring Security设置：
@KeycloakConfiguration public class SecurityConfig extends KeycloakWebSecurityConfigurerAdapter { /** * 复用spring boot 的表率 * * @return the keycloak config resolver */ @Bean public KeycloakConfigResolver keycloakConfigResolver() { return new KeycloakSpringBootConfigResolver(); } /** * 我方写观念 * * @return the keycloak config resolver */ // @Bean public KeycloakConfigResolver fileKeycloakConfigResolver() { return request -> { // json 文献放到resources 文献夹下 ClassPathResource classPathResource = new ClassPathResource("./keycloak.json"); AdapterConfig adapterConfig = null; try { adapterConfig = new ObjectMapper().readValue(classPathResource.getFile(), AdapterConfig.class); } catch (IOException e) { e.printStackTrace(); } return KeycloakDeploymentBuilder.build(adapterConfig); }; } /** * 设置{@link AuthenticationManager} * 这里会引入Keycloak的{@link AuthenticationProvider}终了 * * @param auth the auth */ @Autowired public void configureGlobal(AuthenticationManagerBuilder auth) { KeycloakAuthenticationProvider authenticationProvider = keycloakAuthenticationProvider(); authenticationProvider.setGrantedAuthoritiesMapper(new SimpleAuthorityMapper()); auth.authenticationProvider(authenticationProvider); } /** * 会话身份考证计策 */ @Bean @Override protected SessionAuthenticationStrategy sessionAuthenticationStrategy() { return new RegisterSessionAuthenticationStrategy(new SessionRegistryImpl()); } /** * 设置 session 监听器 保证单点退降奏效 * * @return the servlet listener registration bean */ @Bean public ServletListenerRegistrationBean<HttpSessionEventPublisher> httpSessionEventPublisher() { return new ServletListenerRegistrationBean<>(new HttpSessionEventPublisher()); } @Override protected void configure(HttpSecurity http) throws Exception { super.configure(http); http .authorizeRequests() .antMatchers("/customers*").hasRole("USER") .antMatchers("/admin/**").hasRole("base_user") .anyRequest().permitAll(); } }
调用经由
资源客户端springboot-client有一个接口/admin/foo，当未登录调用该接口时会转发到:
http://localhost:8011/auth/realms/felord.cn/protocol/openid-connect/auth?response_type=code&client_id=springboot-client&redirect_uri=http://localhost:8080/sso/login&state=ec00d608-5ce7-47a0-acc8-8a20a2bfadfd&login=true&scope=openid
输入正确的用户密码后才智获得祈望的恶果。
典型的authorazation code flow。
转头Keycloak整合Spring Security的重点这里需要再梳理一下。在原生情况下，客户端的设置、用户的信息、变装信息都由Keycloak适当;客户端只适当变装和资源的映射关系。后续会潜入并定制Keycloak和Spring Security以逍遥本色场景需要。
本文转载自微信公众号「码农小胖哥」，不错通过以下二维码关爱。转载本文请关连码农小胖哥公众号。
