> For the complete documentation index, see [llms.txt](https://docs.p0.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.p0.dev/integrations/resource-integrations/oracle-cloud.md).

# Oracle Cloud

Install P0's Oracle Cloud integration so your users can request just-in-time membership in Oracle Cloud Infrastructure (OCI) groups.

P0's Oracle Cloud integration grants your users just-in-time membership in groups in an Oracle Cloud Infrastructure (OCI) identity domain. When a request is approved, P0 adds the user to the group. When access expires or is revoked, P0 removes them.

{% hint style="info" %}
The Oracle Cloud integration is in preview. Functionality and configuration may change.
{% endhint %}

P0 calls the Oracle Cloud API as a service user that you create for it, and signs each call with that user's API key. P0 can manage users and groups in any identity domain in your tenancy. Install each identity domain separately.

## Before you begin

* An Oracle Cloud tenancy in the commercial realm. Government and sovereign cloud realms aren't supported.
* The groups your users will request, in any identity domain in the tenancy.
* An Oracle Cloud user who can create users, groups, and policies in the tenancy, such as a member of the **Administrators** group.
* A P0 account with permission to install integrations.

## Prepare Oracle Cloud

Do these steps in the Oracle Cloud console, in your tenancy's Default identity domain, even if the groups are in another domain.

1. **Create a user for P0**, such as `p0-service`.
2. **Create a group**, such as `p0-service-group`, and add the P0 user to it.
3. **Create a policy** in the root compartment of the tenancy with these statements. Replace `p0-service-group` if you named the group differently.

   ```
   Allow group p0-service-group to manage users in tenancy
   Allow group p0-service-group to manage groups in tenancy
   Allow group p0-service-group to read domains in tenancy
   Allow group p0-service-group to inspect compartments in tenancy
   ```
4. **Add an API key** to the P0 user. Open the user, go to **API keys**, and choose to generate a key pair. Download the private key, then add the key. Keep the private key file and the fingerprint that the console shows.
5. **Collect these values** for the next section:
   * The OCID of the identity domain that holds the groups, from the domain's details page.
   * The OCID of your tenancy, from the tenancy's details page.
   * The OCID of the P0 user.
   * The identifier of your tenancy's home region, such as `us-ashburn-1`.

## Install Oracle Cloud in P0

1. Navigate to **Integrations** on [p0.app](https://p0.app), select **Oracle Cloud**, and choose **IAM management**.
2. Click **Add domain**. Enter the **Domain OCID**, then click **Next**.
3. P0 shows the Oracle Cloud steps from [#prepare-oracle-cloud](#prepare-oracle-cloud "mention"). If you've done them, click **Next**.
4. Fill in the domain's details:
   * **How are users provisioned?**: keep **As Oracle IAM users**.
   * **How are users identified?**: keep **User name is user email**.
   * **Tenancy OCID**: the OCID of your tenancy.
   * **P0 service user OCID**: the OCID of the user you created for P0.
   * **API key fingerprint**: the fingerprint of the P0 user's API key, such as `12:34:56:78:9a:bc:de:f0:12:34:56:78:9a:bc:de:f0`.
   * **API private key**: paste the whole private key file, including the `-----BEGIN PRIVATE KEY-----` and `-----END PRIVATE KEY-----` lines. P0 encrypts the key when you save it. Keys protected by a passphrase aren't supported.
   * **Home region**: your tenancy's home region identifier, such as `us-ashburn-1`.
5. Click **Finish**.

When you click **Finish**, P0 signs in with the API key, reads the identity domain, and lists its groups. If a check fails, P0 shows the reason. Fix the value and click **Finish** again. A rejected API key usually means a wrong OCID, fingerprint, or private key. If the region you entered isn't your tenancy's home region, P0 shows the home region to enter. If P0 can't find the identity domain or its groups, check the domain OCID and the policy statements.

When the checks pass, the domain appears with its name and the state **Installed**.

To replace the API key later, open the domain on the **IAM management** page. Turn on the switch next to **API private key**, paste the new key, update the fingerprint, and click **Update**.

## How P0 matches users

P0 matches each requester to an Oracle Cloud user in the identity domain by email address. If no user in the domain has the requester's email, P0 creates one, named after the email address, before adding it to the group.

## Write access policies

You can write access policies in [Policy Studio](https://docs.p0.dev/policy-studio/policy-studio.md) for Oracle Cloud by group name or group OCID, and by domain or compartment. Requests and approvals show the group and domain names.

## Limitations

* The integration is in preview.
* P0 grants Oracle Cloud group membership only.
* Only the commercial realm is supported.
* API keys protected by a passphrase aren't supported.

## Request access

See [Requesting Oracle Cloud access](https://docs.p0.dev/integrations/resource-integrations/oracle-cloud/requesting-access.md).
