|
|
|
|
@ -25,27 +25,30 @@ controller {
|
|
|
|
|
- `description` - Specifies a friendly description of this controller.
|
|
|
|
|
|
|
|
|
|
- `database` - Configuration block with two valid parameters for connecting to Postgres:
|
|
|
|
|
- `url` - Configures the URL for connecting to Postgres
|
|
|
|
|
- `migration_url` - Can be used to specify a different URL for migrations, as that
|
|
|
|
|
usually requires higher privileges.
|
|
|
|
|
|
|
|
|
|
Either can refer to a file on disk (file://) from which a URL will be read; an env
|
|
|
|
|
var (env://) from which the URL will be read; or a direct database URL (postgres://).
|
|
|
|
|
- `url` - Configures the URL for connecting to Postgres
|
|
|
|
|
- `migration_url` - Can be used to specify a different URL for migrations, as that
|
|
|
|
|
usually requires higher privileges.
|
|
|
|
|
|
|
|
|
|
Either can refer to a file on disk (file://) from which a URL will be read; an env
|
|
|
|
|
var (env://) from which the URL will be read; or a direct database URL (postgres://).
|
|
|
|
|
|
|
|
|
|
- `public_cluster_addr` - Specifies the public host or IP address (and
|
|
|
|
|
optionally port) at which the controller can be reached _by workers_. This will be
|
|
|
|
|
used by workers after initial connection to controllers via the worker's
|
|
|
|
|
`controllers` block. This defaults to the address of the listener marked for
|
|
|
|
|
`cluster` purpose. This is especially useful for cloud environments that do not
|
|
|
|
|
bind a publicly accessible IP to a NIC on the host directly, such as an Amazon
|
|
|
|
|
EIP.
|
|
|
|
|
optionally port) at which the controller can be reached _by workers_. This will
|
|
|
|
|
be used by workers after initial connection to controllers via the worker's
|
|
|
|
|
`controllers` block. This defaults to the address of the listener marked for
|
|
|
|
|
`cluster` purpose. This is especially useful for cloud environments that do not
|
|
|
|
|
bind a publicly accessible IP to a NIC on the host directly, such as an Amazon
|
|
|
|
|
EIP. This value can be a direct address string, can refer to a file on disk (file://)
|
|
|
|
|
from which an address will be read; or an env var (env://) from which the
|
|
|
|
|
address will be read.
|
|
|
|
|
|
|
|
|
|
- `auth_token_time_to_live` - Maximum time to live (TTL) for all auth tokens globally (pertains
|
|
|
|
|
to all tokens from all auth methods). Valid time units are anything specified by Golang's
|
|
|
|
|
[ParseDuration()](https://golang.org/pkg/time/#ParseDuration) method. Default is 7 days.
|
|
|
|
|
to all tokens from all auth methods). Valid time units are anything specified by Golang's
|
|
|
|
|
[ParseDuration()](https://golang.org/pkg/time/#ParseDuration) method. Default is 7 days.
|
|
|
|
|
- `auth_token_time_to_stale` - Maximum time of inactivity for all auth tokens globally (pertains
|
|
|
|
|
to all tokens from all auth methods). Valid time units are anything specified by Golang's
|
|
|
|
|
[ParseDuration()](https://golang.org/pkg/time/#ParseDuration) method. Default is 1 day.
|
|
|
|
|
to all tokens from all auth methods). Valid time units are anything specified by Golang's
|
|
|
|
|
[ParseDuration()](https://golang.org/pkg/time/#ParseDuration) method. Default is 1 day.
|
|
|
|
|
|
|
|
|
|
## KMS Configuration
|
|
|
|
|
|
|
|
|
|
@ -88,7 +91,7 @@ kms "aead" {
|
|
|
|
|
And optionally, a KMS stanza for configuration encryption purpose:
|
|
|
|
|
|
|
|
|
|
```hcl
|
|
|
|
|
# Configuration encryption block: decrypts sensitive values in the
|
|
|
|
|
# Configuration encryption block: decrypts sensitive values in the
|
|
|
|
|
# configuration file. See `boundary config [encrypt|decrypt] -h`.
|
|
|
|
|
kms "aead" {
|
|
|
|
|
purpose = "config"`
|
|
|
|
|
@ -98,7 +101,7 @@ kms "aead" {
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Boundary supports many kinds of KMS integrations. For a complete guide to all available
|
|
|
|
|
KMS types, see our [KMS documentation](/docs/configuration/kms).
|
|
|
|
|
KMS types, see our [KMS documentation](/docs/configuration/kms).
|
|
|
|
|
|
|
|
|
|
# Complete Configuration Example
|
|
|
|
|
|
|
|
|
|
@ -174,5 +177,3 @@ kms "aead" {
|
|
|
|
|
key_id = "global_recovery"
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|