'\" t
.\"     Title: jose
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "JOSE" "1" "" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
jose \- Toolkit for performing JSON Object Signing and Encryption
.SH "SYNOPSIS"
.sp
\fBjose alg\fP [\-k KIND]
.sp
\fBjose b64 dec\fP \-i B64 [\-O BIN]
.sp
\fBjose b64 enc\fP \-I BIN [\-o B64]
.sp
\fBjose jwe dec\fP \-i JWE [\-I CT] \-k JWK [\-p] [\-O PT]
.sp
\fBjose jwe enc\fP [\-i JWE] \-I PT \-k JWK [\-p] [\-r RCP] [\-o JWE] [\-O CT] [\-c]
.sp
\fBjose jwe fmt\fP \-i JWE [\-I CT] [\-o JWE] [\-O CT] [\-c]
.sp
\fBjose jwk exc\fP [\-i JWK] \-l JWK \-r JWK [\-o JWK]
.sp
\fBjose jwk gen\fP \-i JWK [\-o JWK]
.sp
\fBjose jwk pub\fP \-i JWK [\-o JWK]
.sp
\fBjose jwk thp\fP \-i JWK [\-a ALG] [\-o THP]
.sp
\fBjose jwk use\fP \-i JWK [\-a] [\-r] \-u OP
.sp
\fBjose jws fmt\fP \-i JWS [\-I PAY] [\-o JWS] [\-O PAY] [\-c]
.sp
\fBjose jws sig\fP [\-i JWS] [\-I PAY] [\-s SIG] \-k JWK [\-o JWS] [\-O PAY] [\-c]
.sp
\fBjose jws ver\fP \-i JWS [\-I PAY] \-k JWK [\-O PAY] [\-a]
.SH "OVERVIEW"
.sp
José is a C\-language implementation of the Javascript Object Signing and
Encryption standards. Specifically, José aims towards implementing the
following standards:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
RFC 7515 \- JSON Web Signature (JWS)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
RFC 7516 \- JSON Web Encryption (JWE)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
RFC 7517 \- JSON Web Key (JWK)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
RFC 7518 \- JSON Web Algorithms (JWA)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
RFC 7519 \- JSON Web Token (JWT)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
RFC 7520 \- Examples of Protecting Content Using JOSE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
RFC 7638 \- JSON Web Key (JWK) Thumbprint
.RE
.sp
The José command line utility provides facilities for the following:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
URL\-safe Base64 Encoding & Decoding
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Key Generation and Management
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Encryption & Decryption
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Signing & Verification
.RE
.SH "AUTHOR"
.sp
Nathaniel McCallum \c
.MTO "npmccallum\(atredhat.com" "" ""
.SH "SEE ALSO"
.sp
.URL "jose\-alg.1.adoc" "\fBjose\-alg\fP(1)" ","
.URL "jose\-b64\-dec.1.adoc" "\fBjose\-b64\-dec\fP(1)" ","
.URL "jose\-b64\-enc.1.adoc" "\fBjose\-b64\-enc\fP(1)" ","
.URL "jose\-jwe\-dec.1.adoc" "\fBjose\-jwe\-dec\fP(1)" ","
.URL "jose\-jwe\-enc.1.adoc" "\fBjose\-jwe\-enc\fP(1)" ","
.URL "jose\-jwe\-fmt.1.adoc" "\fBjose\-jwe\-fmt\fP(1)" ","
.URL "jose\-jwk\-exc.1.adoc" "\fBjose\-jwk\-exc\fP(1)" ","
.URL "jose\-jwk\-gen.1.adoc" "\fBjose\-jwk\-gen\fP(1)" ","
.URL "jose\-jwk\-pub.1.adoc" "\fBjose\-jwk\-pub\fP(1)" ","
.URL "jose\-jwk\-thp.1.adoc" "\fBjose\-jwk\-thp\fP(1)" ","
.URL "jose\-jwk\-use.1.adoc" "\fBjose\-jwk\-use\fP(1)" ","
.URL "jose\-jws\-fmt.1.adoc" "\fBjose\-jws\-fmt\fP(1)" ","
.URL "jose\-jws\-sig.1.adoc" "\fBjose\-jws\-sig\fP(1)" ","
.URL "jose\-jws\-ver.1.adoc" "\fBjose\-jws\-ver\fP(1)" ""