https://github.com/monry/JWT-for-Unity

JWT (JSON Web Token) implementation for .NET 3.5+ (Public Domain)
https://github.com/monry/JWT-for-Unity

Last synced: 12 days ago
JSON representation

JWT (JSON Web Token) implementation for .NET 3.5+ (Public Domain)

• Host: GitHub
• URL: https://github.com/monry/JWT-for-Unity
• Owner: monry
• License: other
• Fork: true (jwt-dotnet/jwt)
• Created: 2016-02-14T13:25:05.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2016-02-14T13:37:31.000Z (over 8 years ago)
• Last Synced: 2024-02-24T12:37:41.762Z (4 months ago)
• Language: C#
• Homepage: Install-Package JWT
• Size: 4.48 MB
• Stars: 69
• Watchers: 4
• Forks: 15
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Lists

• awesome-stars - monry/JWT-for-Unity - JWT (JSON Web Token) implementation for .NET 3.5+ (Public Domain) (C# #)
• awesome-unity - JWT for Unity - JWT (JSON Web Token) implementation for .NET 3.5+ (Public Domain). (:satellite: Networking <a name="networking"></a> / JWT)
• AwesomeUnityCommunity - JWT for Unity - JWT (JSON Web Token) implementation for .NET 3.5+ (Public Domain). (:satellite: Networking <a name="networking"></a> / JWT)

README

        
# JSON Web Token (JWT) Implementation for Unity (C\#)

This library supports generating and decoding [JSON Web Tokens](http://tools.ietf.org/html/draft-jones-json-web-token-10).

## Installation

The easiest way to install is via NuGet.  See [here](https://nuget.org/packages/JWT).  Else, you can download and compile it yourself.

## Usage

### Creating Tokens

```csharp

var payload = new Dictionary()

{

    { "claim1", 0 },

    { "claim2", "claim2-value" }

};

var secretKey = "GQDstcKsx0NHjPOuXOYg5MbeJ1XT0uFiwDVvVBrk";

string token = JWT.JsonWebToken.Encode(payload, secretKey, JWT.JwtHashAlgorithm.HS256);

Console.WriteLine(token);

```

Output will be:

    eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjbGFpbTEiOjAsImNsYWltMiI6ImNsYWltMi12YWx1ZSJ9.8pwBI_HtXqI3UgQHQ_rDRnSQRxFL1SR8fbQoS-5kM5s

### Verifying and Decoding Tokens

```csharp

var token = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjbGFpbTEiOjAsImNsYWltMiI6ImNsYWltMi12YWx1ZSJ9.8pwBI_HtXqI3UgQHQ_rDRnSQRxFL1SR8fbQoS-5kM5s";

var secretKey = "GQDstcKsx0NHjPOuXOYg5MbeJ1XT0uFiwDVvVBrk";

try

{

    string jsonPayload = JWT.JsonWebToken.Decode(token, secretKey);

    Console.WriteLine(jsonPayload);

}

catch (JWT.SignatureVerificationException)

{

    Console.WriteLine("Invalid token!");

}

```

Output will be:

    {"claim1":0,"claim2":"claim2-value"}

You can also deserialize the JSON payload directly to a .Net object with DecodeToObject:

```csharp

var payload = JWT.JsonWebToken.DecodeToObject(token, secretKey) as IDictionary;

Console.WriteLine(payload["claim2"]);

```

which will output:

    

    claim2-value

#### exp claim

As described in the [JWT RFC](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.4) the `exp` "claim identifies the expiration time on or after which the JWT MUST NOT be accepted for processing." If an `exp` claim is present and is prior to the current time the token will fail verification. The exp (expiry) value must be specified as the number of seconds since 1/1/1970 UTC.

```csharp

var unixEpoch = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);

var now = Math.Round((DateTime.UtcNow - unixEpoch).TotalSeconds);

var payload = new Dictionary()

{

    { "exp", now }

};

var secretKey = "GQDstcKsx0NHjPOuXOYg5MbeJ1XT0uFiwDVvVBrk";

string token = JWT.JsonWebToken.Encode(payload, secretKey, JWT.JwtHashAlgorithm.HS256);

string jsonPayload = JWT.JsonWebToken.Decode(token, secretKey); // JWT.SignatureVerificationException!

```

### Configure JSON Serialization

By default JSON Serialization is done by System.Web.Script.Serialization.JavaScriptSerializer.  To configure a different one first implement the IJsonSerializer interface.

```csharp

public class CustomJsonSerializer : IJsonSerializer

{

    public string Serialize(object obj)

    {

        // Implement using favorite JSON Serializer

    }

    public T Deserialize(string json)

    {

        // Implement using favorite JSON Serializer

    }

}

```

Next configure this serializer as the JsonSerializer.

```cs

JsonWebToken.JsonSerializer = new CustomJsonSerializer();

```