对于最新的稳定版本,请使用 Spring Security 6.5.3spring-doc.cadn.net.cn

SecurityMockMvcResult匹配器

有时,需要对请求做出各种与安全相关的断言。 为了满足这一需求,Spring Security Test 支持实现了 Spring MVC Test 的ResultMatcher接口。 为了使用 Spring Security 的ResultMatcher实现确保使用以下静态导入:spring-doc.cadn.net.cn

import static org.springframework.security.test.web.servlet.response.SecurityMockMvcResultMatchers.*;
import org.springframework.security.test.web.servlet.response.SecurityMockMvcResultMatchers.*

未经身份验证的断言

有时,断言没有与MockMvc调用。 例如,您可能想要测试提交无效的用户名和密码,并验证没有用户经过身份验证。 您可以使用以下内容通过 Spring Security 的测试支持轻松完成此作:spring-doc.cadn.net.cn

mvc
	.perform(formLogin().password("invalid"))
	.andExpect(unauthenticated());
mvc
    .perform(formLogin().password("invalid"))
    .andExpect { unauthenticated() }

经过身份验证的断言

通常,我们必须断言存在经过身份验证的用户。 例如,我们可能想要验证我们是否成功进行了身份验证。 我们可以使用以下代码片段验证基于表单的登录是否成功:spring-doc.cadn.net.cn

mvc
	.perform(formLogin())
	.andExpect(authenticated());
mvc
    .perform(formLogin())
    .andExpect { authenticated() }

如果我们想断言用户的角色,我们可以优化之前的代码,如下所示:spring-doc.cadn.net.cn

mvc
	.perform(formLogin().user("admin"))
	.andExpect(authenticated().withRoles("USER","ADMIN"));
mvc
    .perform(formLogin())
    .andExpect { authenticated().withRoles("USER","ADMIN") }

或者,我们可以验证用户名:spring-doc.cadn.net.cn

mvc
	.perform(formLogin().user("admin"))
	.andExpect(authenticated().withUsername("admin"));
mvc
    .perform(formLogin().user("admin"))
    .andExpect { authenticated().withUsername("admin") }

我们还可以结合断言:spring-doc.cadn.net.cn

mvc
	.perform(formLogin().user("admin"))
	.andExpect(authenticated().withUsername("admin").withRoles("USER", "ADMIN"));
mvc
    .perform(formLogin().user("admin"))
    .andExpect { authenticated().withUsername("admin").withRoles("USER", "ADMIN") }

我们还可以对身份验证进行任意断言spring-doc.cadn.net.cn

mvc
	.perform(formLogin())
	.andExpect(authenticated().withAuthentication(auth ->
		assertThat(auth).isInstanceOf(UsernamePasswordAuthenticationToken.class)));
mvc
    .perform(formLogin())
    .andExpect {
        authenticated().withAuthentication { auth ->
            assertThat(auth).isInstanceOf(UsernamePasswordAuthenticationToken::class.java) }
        }
    }