'\" t
.\"     Title: jose-jwe-fmt
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "JOSE\-JWE\-FMT" "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-jwe-fmt \- Converts a JWE between serialization formats
.SH "SYNOPSIS"
.sp
\fBjose jwe fmt\fP \-i JWE [\-I CT] [\-o JWE] [\-O CT] [\-c]
.SH "OVERVIEW"
.sp
The \fBjose jwe fmt\fP command converts a JWE into alternative serialization
formats. For example, it can:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
Attach ciphertext to a detached JWE.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
Detach ciphertext from a JWE.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 3." 4.2
.\}
Convert JWE Compact Serialization to JWE JSON Serialization.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 4." 4.2
.\}
Convert JWE JSON Serialization to JWE Compact Serialization.
.RE
.SH "OPTIONS"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-i\fP \fIJSON\fP, \fB\-\-input\fP=\fIJSON\fP :
Parse JWE from JSON
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-i\fP \fIFILE\fP, \fB\-\-input\fP=\fIFILE\fP :
Read JWE from FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-i\fP \-, \fB\-\-input\fP=\-:
Read JWE from standard input
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-I\fP \fIFILE\fP, \fB\-\-detached\fP=\fIFILE\fP :
Read decoded ciphertext from FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-I\fP \-, \fB\-\-detached\fP=\- :
Read decoded ciphertext from standard input
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-o\fP \fIFILE\fP, \fB\-\-output\fP=\fIFILE\fP :
Write JWE to FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-o\fP \-, \fB\-\-output\fP=\- :
Write JWE to stdout (default)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-O\fP \fIFILE\fP, \fB\-\-detach\fP=\fIFILE\fP :
Detach ciphertext and decode to FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-O\fP \-, \fB\-\-detach\fP=\- :
Detach ciphertext and decode to standard output
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-c\fP, \fB\-\-compact\fP :
Output JWE using compact serialization
.RE
.SH "EXAMPLES"
.sp
Attach ciphertext to a detached JWE and emit JWE Compact Serialization:
.sp
.if n .RS 4
.nf
.fam C
$ jose jwe fmt \-i msg.jwe \-I msg.ct \-o compact.jwe \-c
.fam
.fi
.if n .RE
.sp
Detach ciphertext from a JWE:
.sp
.if n .RS 4
.nf
.fam C
$ jose jwe fmt \-i msg.jwe \-o detached.jwe \-O detached.ct
.fam
.fi
.if n .RE
.SH "AUTHOR"
.sp
Nathaniel McCallum \c
.MTO "npmccallum\(atredhat.com" "" ""
.SH "SEE ALSO"
.sp
.URL "jose\-jwe\-dec.1.adoc" "\fBjose\-jwe\-dec\fP(1)" ","
.URL "jose\-jwe\-enc.1.adoc" "\fBjose\-jwe\-enc\fP(1)" ""