Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add documentation for the OCI config integration #509

Merged
merged 4 commits into from
Jul 6, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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