Skip to content

Commit

Permalink
doc/EasyRSA-Renew-and-Revoke.md: Add details for command 'renew-ca'
Browse files Browse the repository at this point in the history
Signed-off-by: Richard T Bonhomme <[email protected]>
  • Loading branch information
TinCanTech committed Nov 27, 2024
1 parent 40b04db commit ee55a64
Showing 1 changed file with 23 additions and 7 deletions.
30 changes: 23 additions & 7 deletions doc/EasyRSA-Renew-and-Revoke.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,22 +86,26 @@ Command Details: `renew`

#### `renew` has three different versions:

* `renew` **Version 1**: Easy-RSA version `3.0.6`, `3.0.7` and `3.0.8`.
* `renew` **Version 1**: Easy-RSA versions `3.0.6`, `3.0.7` and `3.0.8`.
- Both certificate and private key are rebuilt.
- Once a certificate has been renewed it **cannot** be revoked.

* `renew` **Version 2**: Easy-RSA version `3.0.9` and `3.1.0`.
* `renew` **Version 2**: Easy-RSA versions `3.0.9` and `3.1.0`.
- Both certificate and private key are rebuilt.
- Once a certificate has been renewed it **can** be revoked.
- Use command:

`revoke-renewed file-name-base [ reason ]`

* `renew` **Version 3**: Easy-RSA version `3.1.1+`.
* `renew` **Version 3**: Easy-RSA versions `3.1.1` through `3.1.7`.
- Only certificate is renewed.
- The original `renew` command has been renamed to `rebuild`, which
rebuilds both certificate and private key.

* `renew` **Version 4**: Easy-RSA version `3.2.0+`.
- Only certificate is renewed.
- Supports standard Easy-RSA X509 extension duplication.


Resolving issues with `renew` version 1
---------------------------------------
Expand Down Expand Up @@ -149,7 +153,14 @@ Renewed certificate can be revoked:
This is the preferred method to renew a certificate because the original
private key is still valid.

`renew` version 3 is **only** available since Easy-RSA version `3.1.1+`.
Using `renew` version 4
-----------------------

#### Upgrade Easy-RSA to version `3.2.0+` is required.

This is the most comprensive version of `renew`, which supports automatic
copying of Easy-RSA X509 extensions.


----

Expand Down Expand Up @@ -186,7 +197,14 @@ an old certificate/key pair, which has been _rebuilt_ by command `rebuild`.
Renew CA Certificate
====================

Easy-RSA Version 3.2.1+ supports a simple way to effectively renew a CA Certificate.
Easy-RSA Version `3.2.2+ includes command `renew-ca`, which will create a new
CA certificate using the original CA key. This new certificate will completely
replace the previous CA certificate. This command can be safely tested without
disturbing your current PKI. The command requires user confirmation before
installing the new CA certificate.


Easy-RSA Version `3.2.1+` supports a simple way to effectively renew a CA Certificate.

**Preamble** - Specifically for use with OpenVPN:

Expand Down Expand Up @@ -246,5 +264,3 @@ Please consider the method outlined here, which requires very little work:
`inline` files in the `pki/inline/private` directory include security keys,
which MUST only be transmitted over a secure connection, such as `https`.

As of Easy-RSA Version 3.2.1, this is the only supported way to renew an
expired CA certificate.

0 comments on commit ee55a64

Please sign in to comment.