JOSE-JWS-SIG(1)                                                JOSE-JWS-SIG(1)

<?><?><?> (NAME)
       jose-jws-sig - <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> JWK
       <?><?> <?><?><?><?> JWS

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       jose jws sig [-i JWS] [-I PAY] [-s SIG] -k JWK [-o JWS] [-O PAY] [-c]

<?><?><?><?> <?><?><?> (OVERVIEW)
       <?><?><?><?><?> jose jws sig <?><?> <?><?><?><?><?><?> (<?><?><?>
       <?><?><?><?>) <?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?> JWK <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> (-I) <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> JWS <?><?><?><?><?> (-i)
       <?><?><?><?><?> <?><?><?>.

       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> -O
       <?><?><?><?><?><?><?> <?><?> JWS <?><?><?><?><?><?> (detached)
       <?><?><?><?><?> <?><?><?>. <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?> JWS <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?>.

       <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> (-k)<?> <?><?><?><?><?><?><?> JWS <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> -c <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> JWS (JWS Compact
       Serialization) <?><?><?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> JWS
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> JWS (-i) <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> JWS
       (-s) <?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?>. <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> JWS (JWS Protected Header) <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> JWS <?><?><?><?> <?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?> JOSE (<?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> -i <?><?> -s) <?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?>. <?><?> <?><?><?> <?><?><?><?><?> jose <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> JOSE
       <?><?> <?><?><?><?><?> "alg" <?><?><?><?><?> <?><?><?><?><?><?> (<?><?>
       <?><?><?> 4.1.1 <?><?> RFC 7515 <?><?><?><?><?><?> <?><?><?><?>).

       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?>: jose jws sig <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> "alg" <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> JWK <?><?><?><?><?> <?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> -i <?> -s
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> JWS <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> JWS (-i)
       <?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> JWS
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       o   -i JSON, --input=JSON : <?><?><?><?><?> <?><?><?><?><?> JWS <?><?>
           <?><?><?><?> JSON

       o   -i FILE, --input=FILE : <?><?><?><?><?><?> <?><?><?><?><?> JWS
           <?><?> FILE

       o   -i -, --input=- : <?><?><?><?><?><?> <?><?><?><?><?> JWS <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>

       o   -I FILE, --detached=FILE : <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> FILE

       o   -I -, --detached=- : <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?>

       o   -s JSON, --signature=JSON : <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> JWS <?><?> <?><?><?><?> JSON

       o   -s FILE, --signature=FILE : <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> JWS <?><?> FILE

       o   -s -, --signature=- : <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> JWS <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?>

       o   -k FILE, --key=FILE : <?><?><?><?><?><?> JWK (<?><?>
           <?><?><?><?><?><?><?><?><?><?><?> JWKSet) <?><?> FILE

       o   -k -, --key=- : <?><?><?><?><?><?> JWK (<?><?>
           <?><?><?><?><?><?><?><?><?><?><?> JWKSet) <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?>

       o   -o FILE, --output=FILE : <?><?><?><?><?> JWS <?><?> FILE

       o   -o -, --output=- : <?><?><?><?><?> JWS <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>)

       o   -O FILE, --detach=FILE : <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?> <?><?><?><?><?><?><?><?> <?><?> FILE

       o   -O -, --detach=- : <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?>

       o   -c, --compact : <?><?><?><?><?> <?><?><?><?> JWS <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?>

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> JSON <?><?> JWS:

           $ jose jwk gen -i '{"alg":"HS256"}' -o key.jwk
           $ jose jws sig -I msg.txt -k key.jwk -o msg.jws

       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> JWS <?><?> <?><?><?><?> <?><?><?><?><?><?> (detached):

           $ jose jws sig -I msg.txt -k key.jwk -O /dev/null -c -o msg.jws

       <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>:

           $ jose jwk gen -i '{"alg":"ES256"}' -o ec.jwk
           $ jose jwk gen -i '{"alg":"RS256"}' -o rsa.jwk
           $ jose jws sig -I msg.txt -k ec.jwk -k rsa.jwk -o msg.jws

<?><?><?><?><?><?><?> (AUTHOR)
       Nathaniel McCallum <npmccallum@redhat.com>

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       jose-jws-sig(1), jose-jws-ver(1)

                                  06/09/2026                   JOSE-JWS-SIG(1)