mirror of
https://github.com/spring-projects/spring-boot.git
synced 2024-08-29 03:06:45 +08:00
Disable hypermedia in actuator endpoints by default
This change permanently removes links from the endpoints that return arrays or collections, and also disables them in the rest of the endpoints (except /actuator) by default. Fixes gh-4616
This commit is contained in:
parent
860a9b94ea
commit
c7c685f65f
@ -18,6 +18,7 @@ package org.springframework.boot.actuate.autoconfigure;
|
|||||||
|
|
||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
import java.lang.reflect.Type;
|
import java.lang.reflect.Type;
|
||||||
|
import java.util.Collection;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
import java.util.Map;
|
import java.util.Map;
|
||||||
import java.util.concurrent.ConcurrentHashMap;
|
import java.util.concurrent.ConcurrentHashMap;
|
||||||
@ -205,10 +206,9 @@ public class EndpointWebMvcHypermediaManagementContextConfiguration {
|
|||||||
* Controller advice that adds links to the existing Actuator endpoints. By default
|
* Controller advice that adds links to the existing Actuator endpoints. By default
|
||||||
* all the top-level resources are enhanced with a "self" link. Those resources that
|
* all the top-level resources are enhanced with a "self" link. Those resources that
|
||||||
* could not be enhanced (e.g. "/env/{name}") because their values are "primitive" are
|
* could not be enhanced (e.g. "/env/{name}") because their values are "primitive" are
|
||||||
* ignored. Those that have values of type Collection (e.g. /trace) are transformed in
|
* ignored.
|
||||||
* to maps, and the original collection value is added with a key equal to the
|
|
||||||
* endpoint name.
|
|
||||||
*/
|
*/
|
||||||
|
@ConditionalOnProperty(prefix = "endpoints.hypermedia", name = "enabled", matchIfMissing = false)
|
||||||
@ControllerAdvice(assignableTypes = MvcEndpoint.class)
|
@ControllerAdvice(assignableTypes = MvcEndpoint.class)
|
||||||
public static class MvcEndpointAdvice implements ResponseBodyAdvice<Object> {
|
public static class MvcEndpointAdvice implements ResponseBodyAdvice<Object> {
|
||||||
|
|
||||||
@ -245,6 +245,10 @@ public class EndpointWebMvcHypermediaManagementContextConfiguration {
|
|||||||
// Assume it already was handled or it already has its links
|
// Assume it already was handled or it already has its links
|
||||||
return body;
|
return body;
|
||||||
}
|
}
|
||||||
|
if (body instanceof Collection || body.getClass().isArray()) {
|
||||||
|
// We can't add links to a collection without wrapping it
|
||||||
|
return body;
|
||||||
|
}
|
||||||
HttpMessageConverter<Object> converter = findConverter(selectedConverterType,
|
HttpMessageConverter<Object> converter = findConverter(selectedConverterType,
|
||||||
selectedContentType);
|
selectedContentType);
|
||||||
if (converter == null || isHypermediaDisabled(returnType)) {
|
if (converter == null || isHypermediaDisabled(returnType)) {
|
||||||
|
@ -0,0 +1,109 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2012-2015 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.actuate.endpoint.mvc;
|
||||||
|
|
||||||
|
import org.junit.Before;
|
||||||
|
import org.junit.Test;
|
||||||
|
import org.junit.runner.RunWith;
|
||||||
|
|
||||||
|
import org.springframework.beans.factory.annotation.Autowired;
|
||||||
|
import org.springframework.boot.SpringApplication;
|
||||||
|
import org.springframework.boot.actuate.autoconfigure.MinimalActuatorHypermediaApplication;
|
||||||
|
import org.springframework.boot.actuate.endpoint.mvc.HalBrowserMvcEndpointDisabledIntegrationTests.SpringBootHypermediaApplication;
|
||||||
|
import org.springframework.boot.test.SpringApplicationConfiguration;
|
||||||
|
import org.springframework.context.annotation.Configuration;
|
||||||
|
import org.springframework.http.MediaType;
|
||||||
|
import org.springframework.test.annotation.DirtiesContext;
|
||||||
|
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
|
||||||
|
import org.springframework.test.context.web.WebAppConfiguration;
|
||||||
|
import org.springframework.test.web.servlet.MockMvc;
|
||||||
|
import org.springframework.test.web.servlet.MvcResult;
|
||||||
|
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
|
||||||
|
import org.springframework.web.context.WebApplicationContext;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Integration tests for {@link HalBrowserMvcEndpoint}
|
||||||
|
*
|
||||||
|
* @author Dave Syer
|
||||||
|
* @author Andy Wilkinson
|
||||||
|
*/
|
||||||
|
@RunWith(SpringJUnit4ClassRunner.class)
|
||||||
|
@SpringApplicationConfiguration(SpringBootHypermediaApplication.class)
|
||||||
|
@WebAppConfiguration
|
||||||
|
@DirtiesContext
|
||||||
|
public class HalBrowserMvcEndpointDisabledIntegrationTests {
|
||||||
|
|
||||||
|
@Autowired
|
||||||
|
private WebApplicationContext context;
|
||||||
|
|
||||||
|
@Autowired
|
||||||
|
private MvcEndpoints mvcEndpoints;
|
||||||
|
|
||||||
|
private MockMvc mockMvc;
|
||||||
|
|
||||||
|
@Before
|
||||||
|
public void setUp() {
|
||||||
|
this.mockMvc = MockMvcBuilders.webAppContextSetup(this.context).build();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void linksOnActuator() throws Exception {
|
||||||
|
this.mockMvc.perform(get("/actuator").accept(MediaType.APPLICATION_JSON))
|
||||||
|
.andExpect(status().isOk()).andExpect(jsonPath("$._links").exists())
|
||||||
|
.andExpect(header().doesNotExist("cache-control"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void browser() throws Exception {
|
||||||
|
MvcResult response = this.mockMvc
|
||||||
|
.perform(get("/actuator/").accept(MediaType.TEXT_HTML))
|
||||||
|
.andExpect(status().isOk()).andReturn();
|
||||||
|
assertEquals("/actuator/browser.html", response.getResponse().getForwardedUrl());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void endpointsDoNotHaveLinks() throws Exception {
|
||||||
|
for (MvcEndpoint endpoint : this.mvcEndpoints.getEndpoints()) {
|
||||||
|
String path = endpoint.getPath();
|
||||||
|
if ("/actuator".equals(path)) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
path = path.length() > 0 ? path : "/";
|
||||||
|
this.mockMvc.perform(get(path).accept(MediaType.APPLICATION_JSON))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$._links").doesNotExist());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@MinimalActuatorHypermediaApplication
|
||||||
|
@Configuration
|
||||||
|
public static class SpringBootHypermediaApplication {
|
||||||
|
|
||||||
|
public static void main(String[] args) {
|
||||||
|
SpringApplication.run(SpringBootHypermediaApplication.class,
|
||||||
|
new String[] { "--endpoints.hypermedia.enabled=false" });
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
@ -93,10 +93,8 @@ public class HalBrowserMvcEndpointManagementContextPathIntegrationTests {
|
|||||||
@Test
|
@Test
|
||||||
public void trace() throws Exception {
|
public void trace() throws Exception {
|
||||||
this.mockMvc.perform(get("/admin/trace").accept(MediaType.APPLICATION_JSON))
|
this.mockMvc.perform(get("/admin/trace").accept(MediaType.APPLICATION_JSON))
|
||||||
.andExpect(status().isOk())
|
.andExpect(status().isOk()).andExpect(jsonPath("$._links").doesNotExist())
|
||||||
.andExpect(jsonPath("$._links.self.href")
|
.andExpect(jsonPath("$").isArray());
|
||||||
.value("http://localhost/admin/trace"))
|
|
||||||
.andExpect(jsonPath("$.content").isArray());
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
|
@ -16,6 +16,10 @@
|
|||||||
|
|
||||||
package org.springframework.boot.actuate.endpoint.mvc;
|
package org.springframework.boot.actuate.endpoint.mvc;
|
||||||
|
|
||||||
|
import java.util.Arrays;
|
||||||
|
import java.util.HashSet;
|
||||||
|
import java.util.Set;
|
||||||
|
|
||||||
import org.junit.Before;
|
import org.junit.Before;
|
||||||
import org.junit.Test;
|
import org.junit.Test;
|
||||||
import org.junit.runner.RunWith;
|
import org.junit.runner.RunWith;
|
||||||
@ -27,6 +31,7 @@ import org.springframework.boot.test.SpringApplicationConfiguration;
|
|||||||
import org.springframework.context.annotation.Configuration;
|
import org.springframework.context.annotation.Configuration;
|
||||||
import org.springframework.http.MediaType;
|
import org.springframework.http.MediaType;
|
||||||
import org.springframework.test.annotation.DirtiesContext;
|
import org.springframework.test.annotation.DirtiesContext;
|
||||||
|
import org.springframework.test.context.TestPropertySource;
|
||||||
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
|
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
|
||||||
import org.springframework.test.context.web.WebAppConfiguration;
|
import org.springframework.test.context.web.WebAppConfiguration;
|
||||||
import org.springframework.test.web.servlet.MockMvc;
|
import org.springframework.test.web.servlet.MockMvc;
|
||||||
@ -50,6 +55,7 @@ import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.
|
|||||||
@SpringApplicationConfiguration(SpringBootHypermediaApplication.class)
|
@SpringApplicationConfiguration(SpringBootHypermediaApplication.class)
|
||||||
@WebAppConfiguration
|
@WebAppConfiguration
|
||||||
@DirtiesContext
|
@DirtiesContext
|
||||||
|
@TestPropertySource(properties = "endpoints.hypermedia.enabled=true")
|
||||||
public class HalBrowserMvcEndpointVanillaIntegrationTests {
|
public class HalBrowserMvcEndpointVanillaIntegrationTests {
|
||||||
|
|
||||||
@Autowired
|
@Autowired
|
||||||
@ -83,9 +89,8 @@ public class HalBrowserMvcEndpointVanillaIntegrationTests {
|
|||||||
@Test
|
@Test
|
||||||
public void trace() throws Exception {
|
public void trace() throws Exception {
|
||||||
this.mockMvc.perform(get("/trace").accept(MediaType.APPLICATION_JSON))
|
this.mockMvc.perform(get("/trace").accept(MediaType.APPLICATION_JSON))
|
||||||
.andExpect(status().isOk())
|
.andExpect(status().isOk()).andExpect(jsonPath("$._links").doesNotExist())
|
||||||
.andExpect(jsonPath("$._links.self.href").value("http://localhost/trace"))
|
.andExpect(jsonPath("$").isArray());
|
||||||
.andExpect(jsonPath("$.content").isArray());
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
@ -111,8 +116,13 @@ public class HalBrowserMvcEndpointVanillaIntegrationTests {
|
|||||||
|
|
||||||
@Test
|
@Test
|
||||||
public void endpointsEachHaveSelf() throws Exception {
|
public void endpointsEachHaveSelf() throws Exception {
|
||||||
|
Set<String> collections = new HashSet<String>(
|
||||||
|
Arrays.asList("/trace", "/beans", "/dump"));
|
||||||
for (MvcEndpoint endpoint : this.mvcEndpoints.getEndpoints()) {
|
for (MvcEndpoint endpoint : this.mvcEndpoints.getEndpoints()) {
|
||||||
String path = endpoint.getPath();
|
String path = endpoint.getPath();
|
||||||
|
if (collections.contains(path)) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
path = path.length() > 0 ? path : "/";
|
path = path.length() > 0 ? path : "/";
|
||||||
this.mockMvc.perform(get(path).accept(MediaType.APPLICATION_JSON))
|
this.mockMvc.perform(get(path).accept(MediaType.APPLICATION_JSON))
|
||||||
.andExpect(status().isOk()).andExpect(jsonPath("$._links.self.href")
|
.andExpect(status().isOk()).andExpect(jsonPath("$._links.self.href")
|
||||||
|
@ -70,7 +70,7 @@ public class MvcEndpointIntegrationTests {
|
|||||||
this.context = new AnnotationConfigWebApplicationContext();
|
this.context = new AnnotationConfigWebApplicationContext();
|
||||||
this.context.register(DefaultConfiguration.class);
|
this.context.register(DefaultConfiguration.class);
|
||||||
MockMvc mockMvc = createMockMvc();
|
MockMvc mockMvc = createMockMvc();
|
||||||
mockMvc.perform(get("/beans")).andExpect(content().string(startsWith("{\"")));
|
mockMvc.perform(get("/mappings")).andExpect(content().string(startsWith("{\"")));
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
@ -199,7 +199,7 @@ public class MvcEndpointIntegrationTests {
|
|||||||
EnvironmentTestUtils.addEnvironment(this.context,
|
EnvironmentTestUtils.addEnvironment(this.context,
|
||||||
"spring.jackson.serialization.indent-output:true");
|
"spring.jackson.serialization.indent-output:true");
|
||||||
MockMvc mockMvc = createMockMvc();
|
MockMvc mockMvc = createMockMvc();
|
||||||
mockMvc.perform(get("/beans"))
|
mockMvc.perform(get("/mappings"))
|
||||||
.andExpect(content().string(startsWith("{" + LINE_SEPARATOR)));
|
.andExpect(content().string(startsWith("{" + LINE_SEPARATOR)));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -37,7 +37,7 @@ import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.
|
|||||||
@RunWith(SpringJUnit4ClassRunner.class)
|
@RunWith(SpringJUnit4ClassRunner.class)
|
||||||
@SpringApplicationConfiguration(SampleHypermediaGsonApplication.class)
|
@SpringApplicationConfiguration(SampleHypermediaGsonApplication.class)
|
||||||
@WebAppConfiguration
|
@WebAppConfiguration
|
||||||
@TestPropertySource(properties = "endpoints.health.sensitive: false")
|
@TestPropertySource(properties = "endpoints.hypermedia.enabled: true")
|
||||||
public class SampleHypermediaGsonApplicationTests {
|
public class SampleHypermediaGsonApplicationTests {
|
||||||
|
|
||||||
@Autowired
|
@Autowired
|
||||||
@ -61,9 +61,8 @@ public class SampleHypermediaGsonApplicationTests {
|
|||||||
@Test
|
@Test
|
||||||
public void trace() throws Exception {
|
public void trace() throws Exception {
|
||||||
this.mockMvc.perform(get("/trace").accept(MediaType.APPLICATION_JSON))
|
this.mockMvc.perform(get("/trace").accept(MediaType.APPLICATION_JSON))
|
||||||
.andExpect(status().isOk())
|
.andExpect(status().isOk()).andExpect(jsonPath("$.links").doesNotExist())
|
||||||
.andExpect(jsonPath("$.links[0].href").value("http://localhost/trace"))
|
.andExpect(jsonPath("$").isArray());
|
||||||
.andExpect(jsonPath("$.content").isArray());
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
|
@ -61,7 +61,8 @@ public class SampleHypermediaJpaApplicationIntegrationTests {
|
|||||||
@Test
|
@Test
|
||||||
public void health() throws Exception {
|
public void health() throws Exception {
|
||||||
this.mockMvc.perform(get("/admin/health").accept(MediaType.APPLICATION_JSON))
|
this.mockMvc.perform(get("/admin/health").accept(MediaType.APPLICATION_JSON))
|
||||||
.andExpect(status().isOk()).andExpect(jsonPath("$._links").exists());
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$._links").doesNotExist());
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
|
Loading…
Reference in New Issue
Block a user