edgegrid-signer-apache-http-client

EdgeGrid Client for Java

Java implementation of Akamai {OPEN} EdgeGrid signing.

Description

This library implements Akamai {OPEN} EdgeGrid Authentication for Java. This particular module is a binding for the Apache HTTP Client library.

Usage of Apache HTTP Client

Include the following Maven dependency in your project POM:

<dependency>
    <groupId>com.akamai.edgegrid</groupId>
    <artifactId>edgegrid-signer-apache-http-client</artifactId>
    <version>3.0.1</version>
</dependency>

Create an HTTP client that will sign your HTTP request with a defined client credential:

HttpClient client = HttpClientBuilder.create()
        .addInterceptorFirst(new ApacheHttpClientEdgeGridInterceptor(clientCredential))
        .setRoutePlanner(new ApacheHttpClientEdgeGridRoutePlanner(clientCredential))
        .build();

HttpGet request = new HttpGet("http://endpoint.net/billing-usage/v1/reportSources");
client.execute(request);

Usage with REST-assured

This signing module can also be used with REST-assured instead of using the REST-assured signing module. In this situation you would be configuring the Apache HTTP Client as the low-level transport for REST-assured requests and the RestAssuredEdgeGridFilter would not be used at all. This may be advantageous because of some capabilities available to the Apache HTTP Client that are not available to REST-assured request filters or interceptors. In particular, REST-assured does not support re-signing requests when it follows a redirect.

To use this module with REST-assured, you need to define an HttpClientFactory:

public HttpClientFactory getSigningHttpClientFactory() {
    return new HttpClientConfig.HttpClientFactory() {
            @Override
            public HttpClient createHttpClient() {
                final DefaultHttpClient client = new DefaultHttpClient();
                client.addRequestInterceptor(new ApacheHttpClientEdgeGridInterceptor(clientCredential));
                client.setRoutePlanner(new ApacheHttpClientEdgeGridRoutePlanner(clientCredential));
                return client;
            }
        };
}

Next, make REST-assured use it:

given()
    .config()
        .httpClient(HttpClientConfig.httpClientConfig().httpClientFactory(getSigningHttpClientFactory()))
.when()
    .get("/billing-usage/v1/reportSources")
.then()
    .statusCode(200);