# Oracle EPM

### Overview

The Veza integration for Oracle Enterprise Performance Management (EPM) discovers users, groups and roles assigned in EPM. Veza uses an Oracle EPM service account connect to the EPM APIs to run the built in EPM reports for user group and role assignments.

### Configuring Oracle EPM

1. Create a service account in Oracle EPM for Veza to use:
   1. From **Account Type** list select **Basic Auth** and set a username and password
   2. Account must have Service Administrator role
   3. Note the username and password
   4. For more information on Service Accounts see [Oracle Documentation](https://docs.oracle.com/en/cloud/paas/api-platform-cloud-um/apfad/create-service-account.html#GUID-E4A432B4-177B-400E-9C7D-FE64DF8E82A2)
2. Note the URL of the Oracle EPM instance

### Configuring Veza Platform

1. In Veza, open the **Integrations** page.
2. Click *Add New* and pick **Oracle EPM** as the type of integration to add
3. Enter the required information and *Save* the configuration

| Field    | Notes                        |
| -------- | ---------------------------- |
| URL      | URL of Oracle EPM instance   |
| Username | Username for service account |
| Password | Password for service account |

## Notes and Supported Entities

Veza discovers and shows the following metadata for EPM entities. Attribute filters can be used to constrain searches and access reviews based on these properties

### Oracle EPM User

| Attribute (type) | Description                      |
| ---------------- | -------------------------------- |
| id (text)        | User login                       |
| name (text)      | User display name (first + last) |
| email (text)     | User email address               |

### Oracle EPM Group

| Attribute (type) | Description |
| ---------------- | ----------- |
| name (text)      | Group name  |

### Oracle EPM Role

| Attribute (type) | Description |
| ---------------- | ----------- |
| name (text)      | Role Name   |

> Note: Oracle EPM API does not return information on role configurations and permissions


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.veza.com/4yItIzMvkpAvMVFAamTf/integrations/integrations/oracle-epm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
