com.bazaarvoice.auth:jersey-hmac-auth-sample2

Sample Jersey 2 application using jersey-hmac-auth

Categories	Jersey Program Interface REST Frameworks
GroupId	com.bazaarvoice.auth
ArtifactId	jersey-hmac-auth-sample2
Last Version	1.1
Release Date	Mar 28, 2019
Type	war
Description	Sample Jersey 2 application using jersey-hmac-auth

Download jersey-hmac-auth-sample2

Filename	Size
jersey-hmac-auth-sample2-1.1.pom
jersey-hmac-auth-sample2-1.1.war	6 MB
jersey-hmac-auth-sample2-1.1-sources.jar	2 KB
jersey-hmac-auth-sample2-1.1-javadoc.jar	45 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.bazaarvoice.auth/jersey-hmac-auth-sample2/ -->
<dependency>
    <groupId>com.bazaarvoice.auth</groupId>
    <artifactId>jersey-hmac-auth-sample2</artifactId>
    <version>1.1</version>
    <type>war</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.bazaarvoice.auth/jersey-hmac-auth-sample2/
implementation 'com.bazaarvoice.auth:jersey-hmac-auth-sample2:1.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.bazaarvoice.auth/jersey-hmac-auth-sample2/
implementation ("com.bazaarvoice.auth:jersey-hmac-auth-sample2:1.1")

Apache Buildr

'com.bazaarvoice.auth:jersey-hmac-auth-sample2:war:1.1'

Apache Ivy

<dependency org="com.bazaarvoice.auth" name="jersey-hmac-auth-sample2" rev="1.1">
  <artifact name="jersey-hmac-auth-sample2" type="war" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.bazaarvoice.auth', module='jersey-hmac-auth-sample2', version='1.1')
)

Scala SBT

libraryDependencies += "com.bazaarvoice.auth" % "jersey-hmac-auth-sample2" % "1.1"

Leiningen

[com.bazaarvoice.auth/jersey-hmac-auth-sample2 "1.1"]

Dependencies

compile (3)

Group / Artifact	Type	Version
com.bazaarvoice.auth : jersey-hmac-auth-server2	jar	1.1
org.glassfish.jersey.containers : jersey-container-servlet-core	jar	2.6
ch.qos.logback : logback-classic	jar	1.1.3

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.10

Project Modules

There are no modules declared in this project.

jersey-hmac-auth

Jersey-based HMAC authentication for the client and server.

This library makes it easy to add HMAC authentication to REST API's that are implemented using the Jersey library. Note that this also works for Jersey-based frameworks, like Dropwizard.

HMAC authentication provides a way for you to ensure the integrity and authenticity of API requests. You grant API access to permitted callers by giving each one an API key and a secret key that they use when generating requests. You can use this library to add support for HMAC authentication on the client and server.

On the client side, e.g. in an SDK library that interfaces with the API, the client must build requests following the authentication contract that jersey-hmac-auth implements. You can do this in any language. However, the jersey-hmac-auth library provides support in Java for client libraries that use the Jersey Client for making HTTP requests.

Getting Started

Server Side

• Jersey 2.x - org.glassfish.jersey
• Jersey 1.x - com.sun.jersey
• Jersey 2.x Sample

Client Side

• Jersey 2.x - org.glassfish.jersey
• Jersey 1.x - com.sun.jersey

HMAC Versions

The HMAC version so far have only been used to distinguished between using POST/PUT data in signature or not.

The server may support any number of versions, however client must supply a version and appropriate include or not include data in signature.

• Version 1 - Has mixed implementations for including content data in signature (deprecated)
• Version 2 - Will not include content data in signature
• Version 3 - Will include content data in signature

User Guide

See the User Guide for more details.

Contributing

To build and run tests locally:

$ git clone [email protected]:bazaarvoice/jersey-hmac-auth.git
$ cd jersey-hmac-auth
$ mvn clean install

To submit a new request or issue, please visit the Issues page.

Pull requests are always welcome.

Continuous Integration

Bazaarvoice

Versions

Version
1.1 Mar 28, 2019
1.0 Feb 22, 2018
0.18 Mar 14, 2017
0.17 Jul 7, 2016
0.16 Mar 1, 2016