2018-05-29 21:07:40 +00:00
|
|
|
---
|
2020-04-07 18:55:19 +00:00
|
|
|
layout: docs
|
|
|
|
page_title: 'Commands: Connect CA'
|
2020-04-13 18:40:26 +00:00
|
|
|
sidebar_title: ca
|
2018-05-29 21:07:40 +00:00
|
|
|
description: >
|
|
|
|
The connect CA subcommand is used to view and modify the Connect Certificate
|
|
|
|
Authority (CA) configuration.
|
|
|
|
---
|
|
|
|
|
|
|
|
# Consul Connect Certificate Authority (CA)
|
|
|
|
|
|
|
|
Command: `consul connect ca`
|
|
|
|
|
|
|
|
The CA connect command is used to interact with Consul Connect's Certificate Authority
|
|
|
|
subsystem. The command can be used to view or modify the current CA configuration. See the
|
2020-04-09 23:46:54 +00:00
|
|
|
[Connect CA documentation](/docs/connect/ca) for more information.
|
2018-05-29 21:07:40 +00:00
|
|
|
|
|
|
|
```text
|
|
|
|
Usage: consul connect ca <subcommand> [options] [args]
|
|
|
|
|
|
|
|
This command has subcommands for interacting with Consul Connect's
|
|
|
|
Certificate Authority (CA).
|
|
|
|
|
|
|
|
Here are some simple examples, and more detailed examples are available
|
|
|
|
in the subcommands or the documentation.
|
|
|
|
|
|
|
|
Get the configuration:
|
|
|
|
|
|
|
|
$ consul connect ca get-config
|
|
|
|
|
|
|
|
Update the configuration:
|
|
|
|
|
|
|
|
$ consul connect ca set-config -config-file ca.json
|
|
|
|
|
|
|
|
For more examples, ask for subcommand help or view the documentation.
|
|
|
|
|
|
|
|
Subcommands:
|
|
|
|
get-config Display the current Connect Certificate Authority (CA) configuration
|
|
|
|
set-config Modify the current Connect CA configuration
|
|
|
|
```
|
|
|
|
|
|
|
|
## get-config
|
|
|
|
|
|
|
|
This command displays the current CA configuration.
|
|
|
|
|
|
|
|
Usage: `consul connect ca get-config [options]`
|
|
|
|
|
|
|
|
#### API Options
|
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
@include 'http_api_options_client.mdx'
|
2020-04-07 23:56:08 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
@include 'http_api_options_server.mdx'
|
2018-05-29 21:07:40 +00:00
|
|
|
|
|
|
|
The output looks like this:
|
|
|
|
|
|
|
|
```
|
|
|
|
{
|
|
|
|
"Provider": "consul",
|
2018-06-21 23:54:59 +00:00
|
|
|
"Config": {},
|
2018-05-29 21:07:40 +00:00
|
|
|
"CreateIndex": 5,
|
|
|
|
"ModifyIndex": 197
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
## set-config
|
|
|
|
|
|
|
|
Modifies the current CA configuration. If this results in a new root certificate
|
2020-04-09 23:46:54 +00:00
|
|
|
being used, the [Root Rotation](/docs/connect/ca#root-certificate-rotation) process
|
2018-05-29 21:07:40 +00:00
|
|
|
will be triggered.
|
|
|
|
|
|
|
|
Usage: `consul connect ca set-config [options]`
|
|
|
|
|
|
|
|
#### API Options
|
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
@include 'http_api_options_client.mdx'
|
2020-04-07 23:56:08 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
@include 'http_api_options_server.mdx'
|
2018-05-29 21:07:40 +00:00
|
|
|
|
|
|
|
#### Command Options
|
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-config-file` - (required) Specifies a JSON-formatted file to use for the new configuration.
|
|
|
|
The format of this config file matches the request payload documented in the
|
2020-04-09 23:46:54 +00:00
|
|
|
[Update CA Configuration API](/api/connect/ca#update-ca-configuration).
|
2018-05-29 21:07:40 +00:00
|
|
|
|
|
|
|
The output looks like this:
|
|
|
|
|
|
|
|
```
|
|
|
|
Configuration updated!
|
|
|
|
```
|
|
|
|
|
|
|
|
The return code will indicate success or failure.
|