.nh
.TH pki\-pkcs12\-key 1 "Oct 28, 2016" PKI "PKI PKCS #12 Key Management Commands"
.SH NAME
.PP
pki\-pkcs12\-key \- Command\-line interface for managing individual keys in PKCS #12 file.

.SH SYNOPSIS
.PP
\fBpki\fP [\fICLI\-options\fP] \fBpkcs12\-key\fP
.br
\fBpki\fP [\fICLI\-options\fP] \fBpkcs12\-key\-find\fP [\fIcommand\-options\fP]
.br
\fBpki\fP [\fICLI\-options\fP] \fBpkcs12\-key\-del\fP \fIkey\-ID\fP [\fIcommand\-options\fP]

.SH DESCRIPTION
.PP
The \fBpki pkcs12\-key\fP commands provide command\-line interfaces to manage keys in a PKCS #12 file.

.PP
\fBpki\fP [\fICLI\-options\fP] \fBpkcs12\-key\-find\fP [\fIcommand\-options\fP]
.br
    This command is to list keys in a PKCS #12 file.

.PP
\fBpki\fP [\fICLI\-options\fP] \fBpkcs12\-key\-del\fP \fIkey\-ID\fP [\fIcommand\-options\fP]
.br
    This command is to delete a key from a PKCS #12 file.

.SH OPTIONS
.PP
The CLI options are described in \fBpki(1)\fP\&.

.SH OPERATIONS
.PP
To view available profile commands, type \fBpki pkcs12\-key\fP\&.
To view each command's usage, type \fBpki pkcs12\-key\-\<command\> \-\-help\fP\&.

.PP
All \fBpki pkcs12\-key\fP commands require a PKCS #12 file and its password.
The PKCS #12 file can be specified with the \fB\-\-pkcs12\-file\fP parameter.
The password can be specified either directly with the \fB\-\-pkcs12\-password\fP parameter,
or in a file with the \fB\-\-pkcs12\-password\-file\fP parameter.

.PP
All \fBpki pkcs12\-key\fP commands also require an NSS database and its password.
The NSS database location can be specified with the \fB\-d\fP parameter (default: \~/.dogtag/nssdb).
The NSS database password can be specified with the \fB\-c\fP or the \fB\-C\fP parameter.

.SS Viewing keys in a PKCS #12 file
.PP
To list the keys in a PKCS #12 file:

.PP
.RS

.nf
$ pki <NSS database location> <NSS database password> pkcs12\-key\-find \\
    <PKCS #12 file> <PKCS #12 password>

.fi
.RE

.SS Deleting a key from a PKCS #12 file
.PP
To delete a key from a PKCS #12 file:

.PP
.RS

.nf
$ pki <NSS database location> <NSS database password> pkcs12\-key\-del <key ID> \\
    <PKCS #12 file> <PKCS #12 password>

.fi
.RE

.SH SEE ALSO
.PP
\fBpki\-pkcs12(1)\fP

.SH AUTHORS
.PP
Endi S. Dewata \&lt;edewata@redhat.com\&gt;\&.

.SH COPYRIGHT
.PP
Copyright (c) 2016 Red Hat, Inc.
This is licensed under the GNU General Public License, version 2 (GPLv2).
A copy of this license is available at http://www.gnu.org/licenses/old\-licenses/gpl\-2.0.txt.