Delphi DLL

JWE Using Flattened JWE JSON Serialization

See more JSON Web Encryption (JWE) Examples

This example duplicates the example A.5 in RFC 7516 for JSON Web Encryption (JWE).

This example demonstrates using the flattened JWE JSON Serialization syntax. This example demonstrates the capability for encrypting the plaintext to a single recipient in a flattened JSON structure.

Note: This example requires Chilkat v9.5.0.66 or greater.

Delphi DLL

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Jwe, StringBuilder, JsonObject;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
plaintext: PWideChar;
jwe: HCkJwe;
jweProtHdr: HCkJsonObject;
jweRecipientHdr: HCkJsonObject;
recipientIndex: Integer;
jweUnprotHdr: HCkJsonObject;
aesWrappingKey: PWideChar;
strJwe: PWideChar;
jsonTemp: HCkJsonObject;
jwe2: HCkJwe;
originalPlaintext: PWideChar;
sbJwe: HCkStringBuilder;

begin
success := False;

// This requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// Note: This example requires Chilkat v9.5.0.66 or greater.

plaintext := 'Live long and prosper.';

jwe := CkJwe_Create();

// First build the JWE Protected Header: {"enc":"A128CBC-HS256"}
jweProtHdr := CkJsonObject_Create();
CkJsonObject_AppendString(jweProtHdr,'enc','A128CBC-HS256');
CkJwe_SetProtectedHeader(jwe,jweProtHdr);

// We have a single recipient that uses AES Key Wrap to encrypt the CEK.
// 
//      {"alg":"A128KW","kid":"7"}

jweRecipientHdr := CkJsonObject_Create();
CkJsonObject_AppendString(jweRecipientHdr,'alg','A128KW');
CkJsonObject_AppendString(jweRecipientHdr,'kid','7');
recipientIndex := 0;
CkJwe_SetRecipientHeader(jwe,recipientIndex,jweRecipientHdr);

// Set the Shared Unprotected Header:  {"jku":"https://server.example.com/keys.jwks"}
jweUnprotHdr := CkJsonObject_Create();
CkJsonObject_AppendString(jweUnprotHdr,'jku','https://server.example.com/keys.jwks');
CkJwe_SetUnprotectedHeader(jwe,jweUnprotHdr);

// Set the AES key wrapping key.
aesWrappingKey := 'GawgguFyGrWKav7AX4VKUg';
recipientIndex := 0;
CkJwe_SetWrappingKey(jwe,recipientIndex,aesWrappingKey,'base64url');

// OK.. everything has been specified.
// Now encrypt.  
// Indicate that we prefer the flattened JSON serialization.
CkJwe_putPreferFlattened(jwe,True);
strJwe := CkJwe__encrypt(jwe,plaintext,'utf-8');
if (CkJwe_getLastMethodSuccess(jwe) <> True) then
  begin
    Memo1.Lines.Add(CkJwe__lastErrorText(jwe));
    Exit;
  end;

// The JWE is produced in the most compact form possible (a single line).
// Let's load it into a JSON object and examine in a non-compact pretty-printed format:
jsonTemp := CkJsonObject_Create();
CkJsonObject_Load(jsonTemp,strJwe);
CkJsonObject_putEmitCompact(jsonTemp,False);
Memo1.Lines.Add(CkJsonObject__emit(jsonTemp));

// The JWE looks like this:
// (Note: Because of random values used in the encryption process, your encrypted results will be different.)

// 	{ 
// 	  "protected": "eyJlbmMiOiJBMTI4Q0JDLUhTMjU2In0",
// 	  "unprotected": { 
// 	    "jku": "https://server.example.com/keys.jwks"
// 	  },
// 	  "header": { 
// 	    "alg": "A128KW",
// 	    "kid": "7"
// 	  },
// 	  "encrypted_key": "FW7z9VxOvnF2ClicvUT4HTeqcdyh90C6qytfEFJsOb77FOwTfYrc3w",
// 	  "iv": "O6Ly5-eML3zTs-_fNX3D5Q",
// 	  "ciphertext": "Q8NLmeac9JhLh0CQPuG_7D9wVDb55eToCh0g5-FQ4M0",
// 	  "tag": "slzlo6-J9C7wSDF4dh_kBg"
// 	} 

// Now decrypt......................................

// First, load the JWE..
jwe2 := CkJwe_Create();
success := CkJwe_LoadJwe(jwe2,strJwe);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkJwe__lastErrorText(jwe2));
    Exit;
  end;

// Set the AES wrap key..
recipientIndex := 0;
CkJwe_SetWrappingKey(jwe2,recipientIndex,aesWrappingKey,'base64url');

// Decrypt
originalPlaintext := CkJwe__decrypt(jwe2,recipientIndex,'utf-8');
if (CkJwe_getLastMethodSuccess(jwe2) <> True) then
  begin
    Memo1.Lines.Add(CkJwe__lastErrorText(jwe2));
    Exit;
  end;

Memo1.Lines.Add('original text decrypted with AES key wrap key: ');
Memo1.Lines.Add(originalPlaintext);

// ---------------------------------------------------------------------------------
// It should also be possible to decrypt the flattened JWE as shown in RFC 7516, Appendix A.5
// because it was produced using the same key.

sbJwe := CkStringBuilder_Create();

CkStringBuilder_Append(sbJwe,'{');
CkStringBuilder_Append(sbJwe,'"protected":');
CkStringBuilder_Append(sbJwe,'"eyJlbmMiOiJBMTI4Q0JDLUhTMjU2In0",');
CkStringBuilder_Append(sbJwe,'"unprotected":');
CkStringBuilder_Append(sbJwe,'{"jku":"https://server.example.com/keys.jwks"},');
CkStringBuilder_Append(sbJwe,'"header":');
CkStringBuilder_Append(sbJwe,'{"alg":"A128KW","kid":"7"},');
CkStringBuilder_Append(sbJwe,'"encrypted_key":');
CkStringBuilder_Append(sbJwe,'"6KB707dM9YTIgHtLvtgWQ8mKwboJW3of9locizkDTHzBC2IlrT1oOQ",');
CkStringBuilder_Append(sbJwe,'"iv":');
CkStringBuilder_Append(sbJwe,'"AxY8DCtDaGlsbGljb3RoZQ",');
CkStringBuilder_Append(sbJwe,'"ciphertext":');
CkStringBuilder_Append(sbJwe,'"KDlTtXchhZTGufMYmOYGS4HffxPSUrfmqCHXaI9wOGY",');
CkStringBuilder_Append(sbJwe,'"tag":');
CkStringBuilder_Append(sbJwe,'"Mz-VPPyU4RlcuYv1IwIvzw"');
CkStringBuilder_Append(sbJwe,'}');

success := CkJwe_LoadJweSb(jwe2,sbJwe);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkJwe__lastErrorText(jwe2));
    Exit;
  end;

recipientIndex := 0;
CkJwe_SetWrappingKey(jwe2,recipientIndex,aesWrappingKey,'base64url');

originalPlaintext := CkJwe__decrypt(jwe2,recipientIndex,'utf-8');
if (CkJwe_getLastMethodSuccess(jwe2) <> True) then
  begin
    Memo1.Lines.Add(CkJwe__lastErrorText(jwe2));
    Exit;
  end;

Memo1.Lines.Add('original text decrypted from published flattened JWE: ');
Memo1.Lines.Add(originalPlaintext);

// The output:

// original text decrypted with AES key wrap key: 
// Live long and prosper.
// original text decrypted from published flattened JWE: 
// Live long and prosper.

CkJwe_Dispose(jwe);
CkJsonObject_Dispose(jweProtHdr);
CkJsonObject_Dispose(jweRecipientHdr);
CkJsonObject_Dispose(jweUnprotHdr);
CkJsonObject_Dispose(jsonTemp);
CkJwe_Dispose(jwe2);
CkStringBuilder_Dispose(sbJwe);

end;