# JumpCloud

![jumpcloud_logo.png](https://assets.relyanceuat.xyz/images/docs/9636595449741/9636620026637.png)
JumpCloud is a zero-trust open directory platform that customers use to authenticate, authorize, and manage users, devices, and applications. It allows sysadmins to tightly integrate the directory service with tools like chatops and intelligent automation.

In order to integrate JumpCloud with Relyance AI you will need a JumpCloud **API Key**.

#### In JumpCloud:

1. Login to your JumpCloud account as an administrator.
2. Go to the JumpCloud Console here: [https://console.jumpcloud.com/](https://console.jumpcloud.com/)
3. Click the profile dropdown menu in the upper right-hand corner and click **My API Key**.
4. This will bring up the API Key dialog box. Copy the API Key to be used in Relyance.

![JumpCloud-3.png](https://assets.relyanceuat.xyz/images/docs/9636595449741/9637112309261.png)

#### In the Relyance AI application:

1. Login to your Relyance account.
2. Navigate to the **Settings** Menu in the bottom left-hand side.
3. Select **Integrations**.
4. Click on the **Vendor Integration** tab.
5. Find the **JumpCloud** integration card and click it to open its connections.
6. Under **Authentication Method**, choose **Custom**.
8. Paste the **API Key** into its respective field.

![JumpCloud-1.png](https://assets.relyanceuat.xyz/images/docs/9636595449741/9636829138189.png)

The **Authentication** step asks for:

- **API Key**: required; held as a secret.

9. Click **Authenticate**.
10. At this point, you should see the following result on the **Vendor** Integrations page:

![JumpCloud-2.png](https://assets.relyanceuat.xyz/images/docs/9636595449741/10629259247117.png)

11. Congratulations, you are now connected to **JumpCloud**.

<!-- terraform-examples:begin (generated from the integration catalog; do not hand-edit) -->

## Manage this integration with Terraform

Connections for this integration can be managed as code with the [Relyance Terraform provider](https://registry.terraform.io/providers/Relyance/relyance/latest). Non-secret fields go in `auth.params`; secret fields go in `auth.secrets_wo`, which is write-only — never stored in Terraform state. Rotate secrets by bumping `auth.secrets_wo_version`.

```hcl
resource "relyance_integration_connection" "jumpcloud" {
  vendor = "jumpcloud"
  name   = "<your connection name>"

  auth = {
    method = "api-key"
    params = {
      data_storage_location = "us"
    }
    # Secret fields are write-only: sent to Relyance, never stored in state.
    secrets_wo = {
      api_key = var.jumpcloud_api_key
    }
    secrets_wo_version = 1
  }

  scans = { "property-inspection" = { enabled = true } }
}
```

<!-- terraform-examples:end -->