2018-12-19 08:22:49 +00:00
|
|
|
---
|
2020-09-01 15:14:13 +00:00
|
|
|
layout: commands
|
2020-04-07 18:55:19 +00:00
|
|
|
page_title: 'Commands: TLS CA Create'
|
2023-01-26 18:42:13 +00:00
|
|
|
description: |
|
|
|
|
The `consul tls ca create` command creates a self-signed certificate authority (CA) for TLS setup.
|
2018-12-19 08:22:49 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
# Consul TLS CA Create
|
|
|
|
|
|
|
|
Command: `consul tls ca create`
|
|
|
|
|
|
|
|
This command create a self signed CA to be used for Consul TLS setup.
|
|
|
|
|
|
|
|
## Example
|
|
|
|
|
|
|
|
Create CA:
|
|
|
|
|
2020-05-19 18:32:38 +00:00
|
|
|
```shell-session
|
2018-12-19 08:22:49 +00:00
|
|
|
$ consul tls ca create
|
|
|
|
==> Saved consul-ca.pem
|
|
|
|
==> Saved consul-ca-key.pem
|
|
|
|
```
|
|
|
|
|
|
|
|
## Usage
|
2020-04-07 18:55:19 +00:00
|
|
|
|
2018-12-19 08:22:49 +00:00
|
|
|
Usage: `consul tls ca create [filename-prefix] [options]`
|
|
|
|
|
2022-07-27 06:17:11 +00:00
|
|
|
#### Command Options
|
2018-12-19 08:22:49 +00:00
|
|
|
|
2020-05-18 17:01:14 +00:00
|
|
|
- `-additional-name-constraint=<value>` - Add name constraints for the CA.
|
|
|
|
Results in rejecting certificates for other DNS than specified. Can be used
|
|
|
|
multiple times. Only used in combination with `-name-constraint`.
|
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-days=<int>` - Provide number of days the CA is valid for from now on, defaults to 5 years.
|
2020-05-18 17:01:14 +00:00
|
|
|
|
|
|
|
- `-domain=<string>` - Domain of consul cluster. Only used in combination with
|
|
|
|
`-name-constraint`. Defaults to `consul`.
|
|
|
|
|
|
|
|
- `-name-constraint` - Add name constraints for the CA. Results in rejecting
|
|
|
|
certificates for other DNS than specified. If turned on localhost and -domain
|
|
|
|
will be added to the allowed DNS. If the UI is going to be served over HTTPS
|
|
|
|
its DNS has to be added with `-additional-constraint`. It is not possible to
|
|
|
|
add that after the fact! Defaults to false.
|
2021-02-11 21:38:12 +00:00
|
|
|
|
|
|
|
- `cluster-id` - ClusterID of the consul cluster, requires `-domain` to be set as well.
|
|
|
|
When used this will cause URIs to be set with spiffeid.
|
|
|
|
|
|
|
|
- `common-name` - Common Name of CA. Defaults to Consul Agent CA.
|