Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 1 | ndnsec-cert-install |
| 2 | =================== |
| 3 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 4 | Synopsis |
| 5 | -------- |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 6 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 7 | **ndnsec-cert-install** [**-h**] [**-I**\|\ **-K**\|\ **-N**] *file* |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 8 | |
| 9 | Description |
| 10 | ----------- |
| 11 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 12 | :program:`ndnsec-cert-install` allows importing a certificate into the |
| 13 | **Public Information Base (PIB)**. By default, the installed certificate |
| 14 | will be set as the default certificate for the corresponding identity and |
| 15 | the identity will be set as the user's default identity. |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 16 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 17 | *file* can be a filesystem path or an HTTP URL of a file containing the certificate |
| 18 | to install. If *file* is "-", the certificate will be read from the standard input. |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 19 | |
| 20 | Options |
| 21 | ------- |
| 22 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 23 | .. option:: -I, --identity-default |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 24 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 25 | Set the certificate as the default certificate for the corresponding identity, |
| 26 | but do not change the user's default identity. |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 27 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 28 | .. option:: -K, --key-default |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 29 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 30 | 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 Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 32 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 33 | .. option:: -N, --no-default |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 34 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 35 | Install the certificate but do not change any default settings. |
| 36 | |
| 37 | Example |
| 38 | ------- |
| 39 | |
| 40 | Install a certificate and set it as the default certificate:: |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 41 | |
| 42 | $ ndnsec-cert-install cert_file.cert |
| 43 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 44 | Install a certificate via HTTP and set it as the default certificate:: |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 45 | |
Davide Pesavento | 97157b4 | 2021-05-27 21:00:43 -0400 | [diff] [blame] | 46 | $ ndnsec-cert-install "http://ndncert.domain.com/cert/get/my-certificate.ndncert" |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 47 | |
Davide Pesavento | b310efb | 2019-04-11 22:10:24 -0400 | [diff] [blame] | 48 | Install a certificate but do not change any default settings:: |
Alexander Afanasyev | 151a855 | 2014-04-11 00:54:43 -0700 | [diff] [blame] | 49 | |
| 50 | $ ndnsec-cert-install -N cert_file.cert |