# OpenVPN CloudConnexa

> Source: https://truto.one/docs/integration-guides/openvpn/

OpenVPN CloudConnexa connects with API credentials (a Client ID and Client Secret) that Truto exchanges for tokens with the OAuth 2.0 client credentials grant.

:::callout{type="info"}
- You need to be the Owner of the CloudConnexa account.
:::

## Install the OpenVPN CloudConnexa integration

Install OpenVPN CloudConnexa from [Available integrations](https://app.truto.one/integrations/available/45b1f717-bb3e-4623-ad2e-3ad2537c24c9) in each environment you connect accounts from.

## Create API credentials

1. Sign in to CloudConnexa and go to **API & Logs** → **API**.
   ![API](https://docs-assets.truto.one/openvpn-details-1.png)
2. Click **Create Credentials**.
   ![Create credentials](https://docs-assets.truto.one/openvpn-details-2.png)
3. Enter a name. Keep the default one-month lifetime or pick two weeks, six months or one year. Optionally allow only the IP range calls come from. Click **Create**.
   ![Credential details](https://docs-assets.truto.one/openvpn-details-3.png)
4. Back on the **API** page, turn on the CloudConnexa API with the toggle.
   ![Enable the API](https://docs-assets.truto.one/openvpn-details-4.png)
5. Copy the Client ID and Client Secret.

The company name is in the CloudConnexa URL in your browser.

![Company name](https://docs-assets.truto.one/openvpn-details-5.png)

API credentials expire at the end of their lifetime. After that, create new credentials and reconnect the account.

## Connect an OpenVPN CloudConnexa account

1. Click **Connect Account**.
   ![Click Connect Account](https://docs-assets.truto.one/truto-connect-account.png)
2. Enter a Tenant ID. This can be any ID you choose. Click **Get connection link**.
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)
3. Open the generated link. You can also share it with your customer so they connect their own OpenVPN CloudConnexa account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)
4. Select **OpenVPN CloudConnexa**.
5. Fill in the form and click **Connect**:

   | Field | Required | What to enter |
   |---|---|---|
   | **Client ID** | Yes | The API credentials' Client ID. |
   | **Client Secret** | Yes | The API credentials' Client Secret. |
   | **Company Name** | No | The first part of your API endpoint, `https://<company_name>.api.openvpn.com`. The form doesn't enforce it, but Truto calls this endpoint, so enter it. |
6. Close the tab when you see the connection successful message. The new account appears under **Integrated Accounts**. Click its Account ID to see its details and make API calls.
