Skip to content

Commit

Permalink
Merge pull request #174 from formalco/fix_documentation
Browse files Browse the repository at this point in the history
add doc
  • Loading branch information
ahmb84 authored Oct 29, 2023
2 parents c4e805b + 5026a85 commit ba33ff7
Show file tree
Hide file tree
Showing 9 changed files with 23 additions and 0 deletions.
1 change: 1 addition & 0 deletions docs/resources/datastore.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ Registering a Datastore with Formal.
- `environment` (String) Environment for the datastore, options: DEV, TEST, QA, UAT, EI, PRE, STG, NON_PROD, PROD, CORP.
- `health_check_db_name` (String) Database name to use for health checks. Default `postgres`.
- `port` (Number) The port your Datastore is listening on.
- `termination_protection` (Boolean) If set to true, the datastore cannot be deleted.
- `timeouts` (Block, Optional) (see [below for nested schema](#nestedblock--timeouts))

### Read-Only
Expand Down
4 changes: 4 additions & 0 deletions docs/resources/default_field_encryption.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,10 @@ Creating Field Encryptions in Formal.
- `encryption_alg` (String) Encryption Algorithm to use. Supported values are `aes_random` and `aes_deterministic`. For highest security, `aes_random` is recommended, but `aes_deterministic` is required to enable search (WHERE clauses) over underlying data in encrypted fields.
- `kms_key_id` (String) Formal ID of the encryption key to be used for this field encryption. This encryption key will be used to encrypt the data key. Read about envelope encryption here: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#enveloping

### Optional

- `termination_protection` (Boolean) If set to true, this field encryption policy cannot be deleted.

### Read-Only

- `id` (String) The ID of this resource.
Expand Down
4 changes: 4 additions & 0 deletions docs/resources/group.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,10 @@ Creating a Group in Formal.
- `description` (String) Description for this Group.
- `name` (String) Friendly Name for this Group.

### Optional

- `termination_protection` (Boolean) If set to true, this Group cannot be deleted.

### Read-Only

- `id` (String) The Formal ID for this Group.
Expand Down
1 change: 1 addition & 0 deletions docs/resources/native_role.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ This resource creates a Native Role.

### Optional

- `termination_protection` (Boolean) If set to true, this Native Role cannot be deleted.
- `use_as_default` (Boolean) The password of the Native Role.

### Read-Only
Expand Down
4 changes: 4 additions & 0 deletions docs/resources/native_role_link.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,10 @@ This resource creates assigns a Native Role to a Formal Identity.
- `formal_identity_type` (String) The type of Formal Identity to be linked. Accepted values are `role` and `group`.
- `native_role_id` (String) The Native Role ID of the Native Role.

### Optional

- `termination_protection` (Boolean) If set to true, this Native Role link cannot be deleted.

### Read-Only

- `id` (String) The ID of this resource.
Expand Down
4 changes: 4 additions & 0 deletions docs/resources/policy.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,10 @@ Creating a Policy in Formal.
- `owners` (List of String) Owners of this policy.
- `status` (String) Defines the current status of the policy. It can be one of the following: 'draft', 'dry-run', or 'active'.

### Optional

- `termination_protection` (Boolean) If set to true, this Policy cannot be deleted.

### Read-Only

- `created_at` (String) When the policy was created.
Expand Down
2 changes: 2 additions & 0 deletions docs/resources/satellite.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,12 @@ Registering a Satellite

### Optional

- `termination_protection` (Boolean) If set to true, this Satellite cannot be deleted.
- `timeouts` (Block, Optional) (see [below for nested schema](#nestedblock--timeouts))

### Read-Only

- `api_key` (String, Sensitive) Api key of the Satellite.
- `id` (String) The ID of the Satellite.
- `tls_cert` (String) TLS certificate of the Satellite.

Expand Down
2 changes: 2 additions & 0 deletions docs/resources/sidecar.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,11 +29,13 @@ Registering a Sidecar with Formal.
- `fail_open` (Boolean) Configure DNS failover from the sidecar to the original datastore. In the unlikely case where the sidecar is unhealthy, having this value of `true` will forward traffic to the original database. Default `false`.
- `formal_hostname` (String) The hostname of the created sidecar.
- `network_type` (String) Configure the sidecar network type. Value can be `internet-facing`, `internal` or `internet-and-internal`.
- `termination_protection` (Boolean) If set to true, this Sidecar cannot be deleted.
- `timeouts` (Block, Optional) (see [below for nested schema](#nestedblock--timeouts))
- `version` (String) Version of the Sidecar to deploy for `managed`.

### Read-Only

- `api_key` (String, Sensitive) Api key for the deployed Sidecar.
- `created_at` (Number) Creation time of the sidecar.
- `formal_control_plane_tls_certificate` (String, Sensitive) If deployment_type is onprem, this is the Control Plane TLS Certificate to add to the deployed Sidecar.
- `id` (String) The ID of this Sidecar.
Expand Down
1 change: 1 addition & 0 deletions docs/resources/user.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ User in Formal.
- `first_name` (String) For human users, their first name.
- `last_name` (String) For human users, their last name.
- `name` (String) For machine users, the name of the user.
- `termination_protection` (Boolean) If set to true, this User cannot be deleted.

### Read-Only

Expand Down

0 comments on commit ba33ff7

Please sign in to comment.