jws

Table of Contents

• Features
• Usage
  • Signing:
  • Detached Content
  • Verifying
  • Directory Structure

Features

• Signing a JWS (JSON Web Signature) with a DID
• Verifying a JWS with a DID

Usage

Signing

package main

import (
    "fmt"
    "github.com/abaxxtech/abaxx-id-go/pkg/dids/didjwk"
    "github.com/abaxxtech/abaxx-id-go/pkg/jws"
)

func main() {
    did, err := didjwk.Create()
    if err != nil {
        fmt.Printf("failed to create did: %v", err)
        return
    }

    payload := map[string]interface{}{"hello": "world"}
    
    compactJWS, err := jws.Sign(payload, did)
    if err != nil {
        fmt.Printf("failed to sign: %v", err)
        return
    }

    fmt.Printf("compact JWS: %s", compactJWS)
}

Detached Content

returning a JWS with detached content can be done like so:

package main

import (
    "fmt"
    "github.com/abaxxtech/abaxx-id-go/pkg/dids/didjwk"
    "github.com/abaxxtech/abaxx-id-go/pkg/jws"
)

func main() {
    did, err := didjwk.Create()
    if err != nil {
        fmt.Printf("failed to create did: %v", err)
        return
    }

    payload := map[string]interface{}{"hello": "world"}
    
    compactJWS, err := jws.Sign(payload, did, Detached(true))
    if err != nil {
        fmt.Printf("failed to sign: %v", err)
        return
    }

    fmt.Printf("compact JWS: %s", compactJWS)
}

specifying a specific category of key associated with the provided did to sign with can be done like so:

package main

import (
    "fmt"
    "github.com/abaxxtech/abaxx-id-go/pkg/dids/didjwk"
    "github.com/abaxxtech/abaxx-id-go/pkg/jws"
)

func main() {
    bearerDID, err := didjwk.Create()
    if err != nil {
        fmt.Printf("failed to create did: %v", err)
        return
    }

    payload := map[string]interface{}{"hello": "world"}
    
    compactJWS, err := jws.Sign(payload, did, Purpose("authentication"))
    if err != nil {
        fmt.Printf("failed to sign: %v", err)
    }

    fmt.Printf("compact JWS: %s", compactJWS)
}

Verifying

package main

import (
    "fmt"
    "github.com/abaxxtech/abaxx-id-go/pkg/dids/didjwk"
    "github.com/abaxxtech/abaxx-id-go/pkg/jws"
)

func main() {
    compactJWS := "SOME_JWS"
    ok, err := jws.Verify(compactJWS)
    if (err != nil) {
        fmt.Printf("failed to verify JWS: %v", err)
    }

    if (!ok) {
        fmt.Errorf("integrity check failed")
    }
}

an error is returned if something in the process of verification failed whereas !ok means the signature is actually shot

Directory Structure

jws
├── jws.go
└── jws_test.go