Skip to content

Commit

Permalink
docs: add documentation for the OCI config integration (#509)
Browse files Browse the repository at this point in the history
Signed-off-by: Kolbeinn Karlsson <kolbeinn.karlsson@lacework.net>
Co-authored-by: Ross <rmoles@users.noreply.github.com>
Co-authored-by: Salim Afiune <afiune@lacework.net>
  • Loading branch information
3 people authored Jul 6, 2023
1 parent 32d757b commit c0ac0c8
Show file tree
Hide file tree
Showing 2 changed files with 59 additions and 0 deletions.
56 changes: 56 additions & 0 deletions website/docs/r/integration_oci_cfg.html.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
subcategory: "Cloud Account Integrations"
layout: "lacework"
page_title: "Lacework: lacework_integration_oci_cfg"
description: |-
Create and manage OCI Configuration integrations
---

# lacework\_integration\_oci\_cfg

Use this resource to configure an OCI Configuration integration to analyze OCI compliance.

## Example Usage

```hcl
resource "lacework_integration_oci_cfg" "account_abc" {
name = "account ABC"
tenant_id = "ocid1.tenancy.oc1..abcdefghijklmnopqrstuvxyz1234567890"
tenant_name = "tenant_xyz"
home_region = "us-sanjose-1"
user_ocid = "ocid1.user.oc1..abcdefghijklmnopqrstuvxyz1234567890"
credentials {
fingerprint = "00:01:02:03:04:05:06:07:08:09:0a:0b:0c:0d:0e:0f"
private_key = "-----BEGIN PRIVATE KEY-----\n ... -----END PRIVATE KEY-----\n"
}
}
```

## Argument Reference

The following arguments are supported:

* `name` - (Required) The OCI Configuration integration name.
* `tenant_id` - (Required) The OCID of the tenant to be integrated with Lacework.
* `tenant_name` - (Required) The name of the tenant to be integrated with Lacework.
* `home_region` - (Required) The home region of the tenant to be integrated with Lacework.
* `user_ocid` - (Required) The OCID of the OCI user used used in the integration.
* `credentials` - (Required) The credentials needed by the integration. See [Credentials](#credentials) below for details.

### Credentials

`credentials` supports the following arguments:

* `fingerprint` - (Required) The fingerprint of the public key used for authentication.
* `private_key` - (Required) The private key used for authentication in PEM format.

## Import

A Lacework OCI Config integration can be imported using a `INT_GUID`, e.g.

```
$ terraform import lacework_integration_oci_cfg.account_abc EXAMPLE_1234BAE1E42182964D23973F44CFEA3C4AB63B99E9A1EC5
```
-> **Note:** To retrieve the `INT_GUID` from existing integrations in your account, use the
Lacework CLI command `lacework cloud-account list`. To install this tool follow
[this documentation](https://docs.lacework.com/cli/).
3 changes: 3 additions & 0 deletions website/lacework.erb
Original file line number Diff line number Diff line change
Expand Up @@ -157,6 +157,9 @@
<li>
<a href="/docs/providers/lacework/r/integration_gcp_pub_sub_audit_log.html">lacework_integration_gcp_pub_sub_audit_log</a>
</li>
<li>
<a href="/docs/providers/lacework/r/integration_oci_cfg.html">lacework_integration_oci_cfg</a>
</li>

</ul>
</li>
Expand Down

0 comments on commit c0ac0c8

Please sign in to comment.