JarCastingsimter-jwt [中文]
Pure Java implementation for JSON Web Token (JWT) [RFC7519]
Installation
<dependency>
<groupId>tech.simter</groupId>
<artifactId>simter-jwt</artifactId>
<version>1.0.0</version>
</dependency>
Requirement
- Java 8+ - this component use java8 native Base64 and HMACSHA-256
- At lease one JSR-353 provider (Java API for JSON Processing)
e.g. Genson, Jackson, Glassfish
Usage
Create a JWT
// create a default header:
// e.g. {"typ":"JWT","alg":"HS256"}
Header header = Header.DEFAULT;
// create a payload
// e.g. {"iss":"RJ","aud":"you","exp":1483200000,"iat":1451577600,"name":"tester"}
Payload payload = new Payload();
// set some registed claims
payload.issuer = "RJ";
payload.audience = "you";
payload.issuedAt = ZonedDateTime.now().toEpochSecond();
payload.expires = ZonedDateTime.now().plusMonths(1).toEpochSecond();
// add your public/private claims
payload.add("name", "tester");
...
// sign and encode with the secret key
// eg. [header].[payload].[signature]
String jwt = new JWT(header, payload).generate("the-secret-key");
Verify a JWT
// verify and decode to a JWT instance
JWT jwt = JWT.verify("[header].[payload].[signature]", "the-secret-key");
// get your public/private claims value
String name = jwt.payload.get("name");
Build
mvn clean package
Deploy
First take a look at simter-parent deploy config.
Deploy to LAN Nexus Repository
mvn clean deploy -Plan
Deploy to Sonatype Repository
mvn clean deploy -Psonatype
After deployed, login into https://oss.sonatype.org. Through Staging Repositories, search this package, then close and release it. After couple hours, it will be synced to Maven Central Repository.
Deploy to Bintray Repository
mvn clean deploy -Pbintray
Will deploy to https://api.bintray.com/maven/simter/maven/tech.simter:simter-jwt/;publish=1. So first create a package https://bintray.com/simter/maven/tech.simter:simter-jwt on Bintray. After deployed, check it from https://jcenter.bintray.com/tech/simter/simter-jwt.
