blob: f98b5d4aec14a06078a8cec5262e3988864531d3 [file] [log] [blame]
Alexander Afanasyev151a8552014-04-11 00:54:43 -07001ndnsec-cert-install
2===================
3
Davide Pesaventob310efb2019-04-11 22:10:24 -04004Synopsis
5--------
Alexander Afanasyev151a8552014-04-11 00:54:43 -07006
Davide Pesaventob310efb2019-04-11 22:10:24 -04007**ndnsec-cert-install** [**-h**] [**-I**\|\ **-K**\|\ **-N**] *file*
Alexander Afanasyev151a8552014-04-11 00:54:43 -07008
9Description
10-----------
11
Davide Pesaventob310efb2019-04-11 22:10:24 -040012:program:`ndnsec-cert-install` allows importing a certificate into the
13**Public Information Base (PIB)**. By default, the installed certificate
14will be set as the default certificate for the corresponding identity and
15the identity will be set as the user's default identity.
Alexander Afanasyev151a8552014-04-11 00:54:43 -070016
Davide Pesaventob310efb2019-04-11 22:10:24 -040017*file* can be a filesystem path or an HTTP URL of a file containing the certificate
18to install. If *file* is "-", the certificate will be read from the standard input.
Alexander Afanasyev151a8552014-04-11 00:54:43 -070019
20Options
21-------
22
Davide Pesaventob310efb2019-04-11 22:10:24 -040023.. option:: -I, --identity-default
Alexander Afanasyev151a8552014-04-11 00:54:43 -070024
Davide Pesaventob310efb2019-04-11 22:10:24 -040025 Set the certificate as the default certificate for the corresponding identity,
26 but do not change the user's default identity.
Alexander Afanasyev151a8552014-04-11 00:54:43 -070027
Davide Pesaventob310efb2019-04-11 22:10:24 -040028.. option:: -K, --key-default
Alexander Afanasyev151a8552014-04-11 00:54:43 -070029
Davide Pesaventob310efb2019-04-11 22:10:24 -040030 Set the certificate as the default certificate for the corresponding key, but
31 do not change the identity's default key or the user's default identity.
Alexander Afanasyev151a8552014-04-11 00:54:43 -070032
Davide Pesaventob310efb2019-04-11 22:10:24 -040033.. option:: -N, --no-default
Alexander Afanasyev151a8552014-04-11 00:54:43 -070034
Davide Pesaventob310efb2019-04-11 22:10:24 -040035 Install the certificate but do not change any default settings.
36
37Example
38-------
39
40Install a certificate and set it as the default certificate::
Alexander Afanasyev151a8552014-04-11 00:54:43 -070041
42 $ ndnsec-cert-install cert_file.cert
43
Davide Pesaventob310efb2019-04-11 22:10:24 -040044Install a certificate via HTTP and set it as the default certificate::
Alexander Afanasyev151a8552014-04-11 00:54:43 -070045
Davide Pesavento97157b42021-05-27 21:00:43 -040046 $ ndnsec-cert-install "http://ndncert.domain.com/cert/get/my-certificate.ndncert"
Alexander Afanasyev151a8552014-04-11 00:54:43 -070047
Davide Pesaventob310efb2019-04-11 22:10:24 -040048Install a certificate but do not change any default settings::
Alexander Afanasyev151a8552014-04-11 00:54:43 -070049
50 $ ndnsec-cert-install -N cert_file.cert