# Idira Detailed Raw Events Ingests detailed raw events from Idira (formerly CyberArk EPM / Endpoint Privilege Manager) through the EPM **Get detailed raw events** API. The [Idira Policy Audit Events](./idira-raw-events) input reads the policy audit API, which only returns events triggered by a policy. This input returns those policy-triggered events too, so running both inputs collects policy events twice. If you run both, drop policy-triggered events from this input with a [JQ](/docs/transforms/jq) transform. Events not tied to a policy have a null `policyName`: ```json { "operation": "jq", "arguments": { "query": "select(.policyName == null)" } } ``` **Sync Type: Incremental** Ingestion runs about two minutes behind real time, because EPM makes events searchable shortly after they arrive. ## Prerequisites Before connecting Monad to Idira, you need: 1. An active Idira (CyberArk EPM) tenant with access to the EPM API 2. A CyberArk Identity tenant with an **Idira EPM API Client** web app for service-to-service authentication 3. An OAuth2 service user (client ID and client secret) whose EPM role can view events in the Sets you want to collect 4. The EPM server hostname for your tenant (e.g. `na101.epm.cyberark.com`) 5. The CyberArk Identity tenant hostname used for OAuth2 token exchange (e.g. `abc1234.id.cyberark.cloud`) ## Authentication Idira uses OAuth2 client credentials (service user) for authentication. The connector exchanges a client ID and client secret against the CyberArk Identity tenant to obtain a bearer token, which is then used for all EPM API calls. To set up authentication: 1. **Find your CyberArk Identity tenant hostname.** In Identity Administration, click your user name, then **About**. The hostname looks like `abc1234.id.cyberark.cloud`. 2. **Create a service user.** Go to **Manage › Inventory › Users › Add User**. Under **Status**, select **Is OAuth confidential client**, **Is Service User** and **Password never expires**. Note the username (Client ID) and password (Client Secret). 3. **Assign the service user to an EPM role** that can view events in the Sets you want to collect. 4. **Create the API web app.** Go to **Manage › Inventory › Targets › Applications › Add Application**, search for **EPM**, and add **Idira EPM API Client**. Note its Application ID (e.g. `EPMforMonad`). This is the OAuth Application ID. 5. **Bind the user to the app.** On the app's **Permissions** tab, add the service user, then confirm the app shows **Deployed**. 6. **Find your EPM server hostname.** Log in to the EPM management console and copy the hostname from the address bar (e.g. `na101.epm.cyberark.com`). Do not use `login.epm.cyberark.com`. See [Set up API authentication for EPM REST APIs using ISPSS](https://docs.cyberark.com/epm/latest/en/content/webservices/authenticate-with-tenant-url.htm) for details. ## Configuration ### Settings | Setting | Type | Required | Description | | ------- | ---- | -------- | ----------- | | Identity Host | string | Yes | CyberArk Identity tenant hostname used for OAuth2 token exchange (e.g. `abc1234.id.cyberark.cloud`). | | EPM Host | string | Yes | Region-specific Idira (formerly CyberArk EPM) API hostname used as the base URL for all EPM API calls (e.g. `na101.epm.cyberark.com`). | | OAuth Application ID | string | Yes | OAuth application ID configured on the CyberArk Identity tenant. Sent as the trailing segment of the token URL (e.g. `EPMforMyApp`). | | Client ID | string | Yes | OAuth2 client ID — the service user's username sent as HTTP Basic auth to the token endpoint. | | Set IDs | array of strings | No | List of EPM Set IDs to fetch raw events for. When empty, all Sets accessible to the authenticated user are enumerated automatically. | | Event Types | array of strings | No | Event types to fetch. Valid values: `AttackAttempt`, `AttackBlock`, `SuspiciousActivityAttempt`, `SuspiciousActivityBlock`, `RestrictAccess`, `DetectAccess`, `Ransomware`, `ElevationRequest`, `Trust`, `ManualRequest`, `Installation`, `Launch`, `Block`, `Access`, `Skipped`. When empty, events of every type are fetched. | | Backfill Start Time | string | No | The date to start fetching raw events from (RFC3339 format, e.g. `2026-01-15T00:00:00Z`). If not specified, collection starts from when the pipeline is created. | | API Rate Limit | object | No | Optional limit on the connector's outbound request rate to the source API. Maximum 3 requests per second. Leave blank for no throttling. A value of 2 per second keeps the connector within EPM's limit of 1,000 requests per 5 minutes and leaves headroom for other tools. See [API Rate Limiting](../../../guides/rate-limiting) for the field format, limits, and how to choose a value. | | Use Synthetic Data | boolean | No | Generate synthetic demo data instead of connecting to the real data source. | ### Secrets | Secret | Type | Required | Description | | ------ | ---- | -------- | ----------- | | Client Secret | string | Yes | OAuth2 client secret — the service user's password sent as HTTP Basic auth to the token endpoint. | ### Example: collect only Trust and Installation events ```json { "identity_host": "abc1234.id.cyberark.cloud", "epm_host": "na101.epm.cyberark.com", "oauth_app_id": "EPMforMonad", "client_id": "monad-svc@abc1234.id.cyberark.cloud", "set_ids": ["123456cf-1234-5678-abcd-b12345678d14"], "event_types": ["Trust", "Installation"], "backfill_start_time": "2026-10-01T00:00:00Z" } ``` ## Troubleshooting ### Common Issues 1. **Authentication Failures (401 Unauthorized)** - Verify the Client ID and Client Secret are correct and belong to the service user bound to the web app. - Confirm the OAuth Application ID exactly matches the web app's Application ID. - Check that the Identity Host is your tenant's Identity hostname, not the EPM host. 2. **`failed to obtain bearer token` or `token request failed`** - The connector could not get a token from CyberArk Identity before calling the EPM Sets or Events Search API. Check the **Identity Host**, **OAuth Application ID**, **Client ID** and **Client Secret**. - These errors are not caused by the **EPM Host**. If EPM API calls fail after a token is issued, confirm the EPM Host is the hostname from your EPM management console, not the login server (`login.epm.cyberark.com`). 3. **Test Connection fails for one Set** - Test Connection searches every Set listed in **Set IDs**. If the service user's role cannot read any one of them, the whole test fails, even when the other Sets are fine. The error names the Set that failed. - Remove that Set from **Set IDs** or give the service user's role access to it. When **Set IDs** is empty, the test checks only the first Set the service user can access. 4. **Missing Events** - If **Event Types** is set, confirm it includes the types you expect. Leave it empty to collect every type. - If specific Sets are configured via **Set IDs**, confirm the IDs are correct and that the service user's role can view those Sets. - Adjust **Backfill Start Time** to extend the historical window. 5. **Rate Limiting (429)** - EPM allows 1,000 event API requests per 5 minutes (about 3.3 per second) and 100,000 extracted events per 24 hours, per tenant. Other tools that read the same tenant, including the [Idira Policy Audit Events](./idira-raw-events) input, share this budget. - With **API Rate Limit** left blank, the connector is not throttled and only backs off after a 429. Set **API Rate Limit** to stay under the EPM allowance, for example **Rate** `2`, **Unit** `per_second` (600 requests per 5 minutes), which leaves headroom for other tools. Lower it further if several pipelines or tools read the same tenant. - If you hit the daily extracted-events limit, narrow **Event Types** or **Set IDs**. ## Related Articles - [Get detailed raw events](https://docs.cyberark.com/epm/latest/en/content/webservices/getdetailedrawevents.htm) - [EPM query language](https://docs.cyberark.com/epm/latest/en/content/webservices/epmquerylanguage.htm) - [Set up API authentication for EPM REST APIs using ISPSS](https://docs.cyberark.com/epm/latest/en/content/webservices/authenticate-with-tenant-url.htm) - [Idira Policy Audit Events](./idira-raw-events)