Skip to content

Java library for Akamai OPEN EdgeGrid Client Authentication

License

Notifications You must be signed in to change notification settings

akamai/AkamaiOPEN-edgegrid-java

Repository files navigation

EdgeGrid Client for Java

This library implements EdgeGrid authentication for Java.

Before you begin, you need to Create authentication credentials.

Install required software

In order to use EdgeGrid Client for Java, you need Java version 11+.

Maven Central Javadocs

Make an API call

You'll need the values for the tokens from your .edgerc file.

ClientCredential credential = ClientCredential.builder()
        .accessToken("akaa-xxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx")
        .clientToken("akaa-xxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx")
        .clientSecret("SOMESECRET")
        .host("akaa-baseurl-xxxxxxxxxxx-xxxxxxxxxxxxx.luna.akamaiapis.net")
        .build();

Example API call:

Request request = Request.builder()
        .method("POST")
        .uri("https://akaa-baseurl-xxxxxxxxxxx-xxxxxxxxxxxxx.luna.akamaiapis.net/diagnostic-tools/v2/ghost-locations/available")
        .body("{ \"field\": \"field value\" }".getBytes())
        .header("X-Some-Signed-Header", "header value")
        .header("X-Some-Other-Signed-Header", "header value 2")
        .build();

This is an example of an API call to List available edge server locations. Change the uri element to reference an endpoint in any of the Akamai APIs.

Modules

This project contains a core implementation module and five bindings to specific HTTP client libraries.

Note: A number of similar libraries for signing requests exist for popular programming languages, and you can find them at https://github.com/akamai?q=edgegrid

Authors

Active

Michał Wójcik [email protected]

Tatiana Slonimskaia [email protected]

Inactive

Martin Meyer [email protected]

Maciej Gawinecki

Roberto López López

Contribute

This is an open-source library, and contributions are welcome. You're welcome to fork this project and send us a pull request.

Find valuable resources on the Akamai Developer website.