diff --git a/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc b/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc index cee5f25cf05..be8e6a762a7 100644 --- a/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc +++ b/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc @@ -2704,20 +2704,7 @@ to the home page at "/" and keep the default for everything else: [source,java,indent=0] ---- - @Configuration - public class WebSecurityConfiguration extends WebSecurityConfigurerAdapter { - - @Override - public void init(WebSecurity web) { - web.ignore("/"); - } - - @Override - protected void configure(HttpSecurity http) throws Exception { - http.antMatcher("/**").authorizeRequests().anyRequest().authenticated(); - } - - } +include::{code-examples}/web/security/UnauthenticatedAccessExample.java[tag=configuration] ---- diff --git a/spring-boot-docs/src/main/java/org/springframework/boot/web/security/UnauthenticatedAccessExample.java b/spring-boot-docs/src/main/java/org/springframework/boot/web/security/UnauthenticatedAccessExample.java new file mode 100644 index 00000000000..43917375e93 --- /dev/null +++ b/spring-boot-docs/src/main/java/org/springframework/boot/web/security/UnauthenticatedAccessExample.java @@ -0,0 +1,52 @@ +/* + * Copyright 2012-2017 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.springframework.boot.web.security; + +import org.springframework.context.annotation.Configuration; +import org.springframework.security.config.annotation.web.builders.HttpSecurity; +import org.springframework.security.config.annotation.web.builders.WebSecurity; +import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter; + +/** + * Example configuration for using a {@link WebSecurityConfigurerAdapter} to configure + * unauthenticated access to the home page at "/". + * + * @author Robert Stern + */ +public class UnauthenticatedAccessExample { + + /** + * {@link WebSecurityConfigurerAdapter} that provides init to configure + * {@link WebSecurity} argument to customize access rules. + */ + // tag::configuration[] + @Configuration + static class WebSecurityConfiguration extends WebSecurityConfigurerAdapter { + + @Override + public void init(WebSecurity web) { + web.ignoring().antMatchers("/"); + } + + @Override + protected void configure(HttpSecurity http) throws Exception { + http.antMatcher("/**").authorizeRequests().anyRequest().authenticated(); + } + } + // end::configuration[] + +}