com.jayway.restassured.module.mockmvc.specification

Interface MockMvcAuthenticationSpecification

All Known Implementing Classes:

MockMvcRequestSpecificationImpl

public interface MockMvcAuthenticationSpecification

Specify an authentication scheme to use when sending a request.

Method Summary

Methods

Modifier and Type	Method and Description
MockMvcRequestSpecification	authentication(Object authentication) Authenticate using the given authentication instance.
MockMvcRequestSpecification	none() Explicitly state that you don't which to use any authentication in this request.
MockMvcRequestSpecification	principal(Object principal) Authenticate using the given principal.
MockMvcRequestSpecification	principal(Principal principal) Authenticate using the given principal.
MockMvcRequestSpecification	principalWithCredentials(Object principal, Object credentials, String... authorities) Authenticate using the given principal and credentials.

Method Detail

principal

MockMvcRequestSpecification principal(Principal principal)

Authenticate using the given principal. This method simply delegates to MockHttpServletRequestBuilder.principal(java.security.Principal).

Parameters:

principal - The principal to use.

Returns:

The request specification

See Also:

MockHttpServletRequestBuilder.principal(java.security.Principal)

principal

MockMvcRequestSpecification principal(Object principal)

Authenticate using the given principal. The principal will be used like this:

 SecurityContextHolder.getContext().setAuthentication(new TestingAuthenticationToken(principal, ""));
 

Note that this method require Spring Security to be on the classpath. Also note that if you use this method Rest Assured will NOT be thread-safe.

Parameters:

principal - The principal to use.

Returns:

The request specification

principalWithCredentials

MockMvcRequestSpecification principalWithCredentials(Object principal,
                                                   Object credentials,
                                                   String... authorities)

Authenticate using the given principal and credentials. The principal and credentials will be used like this:

 SecurityContextHolder.getContext().setAuthentication(new TestingAuthenticationToken(principal, credentials, authorities));
 

Note that this method require Spring Security to be on the classpath. Also note that if you use this method Rest Assured will NOT be thread-safe.

Parameters:

principal - The principal to use.

credentials - The credentials to use

authorities - Optional list of authorities

Returns:

The request specification

authentication

MockMvcRequestSpecification authentication(Object authentication)

Authenticate using the given authentication instance. The authentication instance will be used like this:

 SecurityContextHolder.getContext().setAuthentication(authentication);
 

This means that the supplied object must be an instance of org.springframework.security.core.Authentication.

Note that this method require Spring Security to be on the classpath. Also note that if you use this method Rest Assured will NOT be thread-safe.

Parameters:

authentication - the spring security authentication to use.

Returns:

The request specification

none

MockMvcRequestSpecification none()

Explicitly state that you don't which to use any authentication in this request. This is useful only in cases where you've specified a default authentication scheme and you wish to override it for a single request.

Returns:

The request specification