How to use service credentials in Simulations?

This section is pertaining to the Load DSL mode, and demonstrates how to use service to service authentication for OAuth enabled services. In Scenario mode you send authorization headers by using your HTTP client and its header methods. Please refer to the HTTP client’s documentation of your choice.

  @Scenario(name = "Discovery API")
  public void performHealth(Measurement measurement, UserSession session) {

    User user = session.getUser();
    OAuthUser oauthUser = null;
    if (user instanceof OAuthUser) {
      oauthUser = ((OAuthUser) session.getUser());

    assert oauthUser != null;

    String serviceAccessToken = null;
    if (oauthUser.getOAuthService() != null) {
      serviceAccessToken = oauthUser.getOAuthService().getAccessToken();

    var response = client
        .header(X_REQUEST_ID, "Rhino-" + uuid)
        .header("Authorization", "Bearer " + serviceAccessToken)
        .header("X-User-Token", oauthUser.getAccessToken())

    measurement.measure("Discovery API Call", String.valueOf(response.getStatus()));

Please Note

Since accessing service token has been so painful, Rhino provides a new provider, OAuthServiceProvider, available from the version 1.8.0.

  @Provider(factory = OAuthServiceProvider.class)
  private OAuthServiceProvider serviceProvider;

Using S2S in Load DSL

In web services environment, it is a common practice that client services send a service token along with the user’ access tokens to APIs being tested. In this case, one of the tokens is used in Authorization header as Bearer token whereas the other token is sent in a custom header to the backend, e.g X-Service-Token. Other option is to send the service token with Authorization header and to use a custom one for the user’s access token. The test developer can set the type of the Bearer which is sent in Authorization header with the configuration: dev.oauth.bearer whereas the dev.oauth.headerName defines the name of the non-bearer token. The following example demonstrates the service token being as bearer, whereas the X-User-Token is being used for the user token:


The first line enables the service-to-service authentication. The service will be authenticated with clientId, clientSecret, grantType and the clientCode against authorisation server. As of 1.6.0, the only accepted grant type value is the authorization_code. The service token will be sent as bearer while the user token is sent in X-User-Token.

WARNING: As of 1.6.0, the only accepted grant type value for service-to-service authentication is the authorization_code

dev.oauth.bearer can take either service or user pre-defined values. The service string literal stands for service token as the user is for user token. To enable service-to-service authentication together with user token, use auth() directive on DSL:

     .run(http("API Request")
        .header(session -> from(X_REQUEST_ID, "Rhino-" + UUID.randomUUID().toString()))
        .header(X_API_KEY, SimulationConfig.getApiKey())

Please note that, the service tokens cannot be sent unattended. They must be accompanied by user tokens in requests. How to deal with test users in simulations, you can refer to Test Users.