Skip to content

Commit a5d7915

Browse files
Documentation on creating new CA in existing infrastructure
1 parent d932657 commit a5d7915

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

docs/faq.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,27 @@ The default setting for CRL lifetime of 1 day should be appropriate for most use
106106
### How do I renew a certificate?
107107
Create a new Certificate Signing Request (CSR) using a new private key. Resubmit as detailed in [Client Certificates](client-certificates.md#renewing-certificates).
108108

109+
### How can I change the name or details of my CA?
110+
Changing the name or other details of a CA invalidates its digital signature, so you need to:
111+
112+
* update Terraform variable `issuing_ca_info` or `root_ca_info` with new details
113+
* recreate CA as described in the FAQ [How can I create a new CA within existing infrastructure?](faq.md#how-can-i-create-a-new-ca-within-existing-infrastructure)
114+
115+
### How can I create a new CA within existing infrastructure?
116+
To create a new Root CA or Issuing CA, without destroying the underlying infrastructure:
117+
118+
* delete DynamoDB item for the CA you wish to delete
119+
* if you want the recreated CA to have a new private key, delete the relevant KMS key and apply Terraform
120+
* run the CA Step Function
121+
122+
You may wish to delete all DynamoDB items, in order to remove details of certificates issued by the old CA:
123+
```
124+
pip install -r scripts/requirements.txt
125+
python scripts/delete_db_table_items.py
126+
```
127+
128+
If you recreate the Root CA, the Issuing CA will no longer be valid so will also need to be recreated.
129+
109130
### Can the CA be used for Application Load Balancer mTLS?
110131
A walkthrough with configuration of certificate authentication for AWS Application Load Balancer is provided in [How-to Guides](https://serverlessca.com/how-to-guides/alb/) and [this blog post](https://medium.com/@paulschwarzenberger/aws-application-load-balancer-mtls-with-open-source-cloud-ca-277cb40d60c7).
111132

0 commit comments

Comments
 (0)