Splunk Cyberark Ta Setup

---
name: splunk-cyberark-ta-setup
description: "Use when the user asks to onboard, configure, render, or validate CyberArk data in Splunk. Umbrella
  render, install, and validation workflow for CyberArk Splunk add-ons: supported CyberArk EPM API
  collection (Splunk_TA_cyberark_epm, Splunkbase 5160) and archived/not-supported CyberArk EPV/PTA CEF
  parsing (Splunk_TA_cyberark, Splunkbase 2891). Renders product-specific inputs, syslog/SC4S handoffs,
  encrypted account setup, metadata, and validation SPL."
compatibility: "Splunk Cloud Platform 10.5.2605: conditional. Follow documented package, entitlement, topology, and customer-managed runtime guardrails; self-managed paths remain on the public 10.4 baseline."
metadata:
  splunk_cloud_10_5: "conditional"
  compatibility_verified: "2026-08-20"
---

# CyberArk Splunk Add-on Setup

## Prerequisites

| Tool or access | Purpose | Verify |
|---|---|---|
| Bash and Python 3 | Run bundled setup and validation helpers | `bash --version && python3 --version` |
| Required product/platform access | Inspect or configure the selected target | Complete the documented preflight |
| Credential files for live modes | Keep secrets out of chat | Verify paths only |

## Workflow Overview

```text
┌───────────┐   ┌───────────────┐   ┌───────────────┐   ┌─────────────────┐
│ Preflight │ → │ Render/review │ → │ Apply/handoff │ → │ Validate evidence │
└───────────┘   └───────────────┘   └───────────────┘   └─────────────────┘
```

## When to Activate

- Onboard, configure, render, or validate CyberArk data in Splunk.
- Preview and review the splunk cyberark ta setup workflow before any live apply phase.
- Diagnose failed prerequisites, generated assets, configuration, or validation evidence.

## Scope

Follow the documented read-only or render-first path whenever it is available.
This skill does not imply permission to mutate live systems. Require explicit
apply flags, protected credentials, and operator review for state changes.

## Examples

Inspect the supported setup modes before selecting one:

```bash
bash skills/splunk-cyberark-ta-setup/scripts/setup.sh --help
```

Expected output: usage, supported modes, and required arguments are displayed
without changing the target environment.

Inspect validation modes before running completion checks:

```bash
bash skills/splunk-cyberark-ta-setup/scripts/validate.sh --help
```

Expected output: offline, live, and completion options are displayed when the
skill supports them; help exits without mutation.

## Troubleshooting

| Issue | Cause | Resolution |
|---|---|---|
| Preflight fails | A required tool or access path is missing | Resolve it before rendering or applying |
| Rendered assets are incomplete | Required non-secret inputs are absent | Complete intake and render again |
| Apply is blocked | Review, credentials, or explicit acceptance is missing | Use the documented handoff |
| Validation is incomplete | Live evidence is unavailable | Record the gap and keep completion open |

## TA Completion Gate

For every TA/add-on or dashboard companion run, satisfy the shared
[TA completion gate](../shared/ta_completion_gate.md): configure and enable the
data ingest path owned by this skill or its required companion, validate events
or metrics in the target indexes/source types, and verify any
pre-built/package-shipped dashboards are visible, macro-aligned, and returning
data. If the package ships no dashboards, record that evidence explicitly and
hand off dashboard use to the consuming app, ES/ITSI/ARI content, or readiness
doctor.

Render-first umbrella workflow for CyberArk EPM and legacy EPV/PTA parsing.
The skill keeps the support boundary explicit: `Splunk_TA_cyberark_epm`
(Splunkbase `5160`, repo-reviewed pin `5.0.0`) is the supported API path, while
`Splunk_TA_cyberark` (Splunkbase `2891`, verified `1.2.0`) is archived and
parser-only.

## Workflow

```bash
bash skills/splunk-cyberark-ta-setup/scripts/setup.sh --render \
  --products epm,epv_pta --index cyberark
```

Configure the EPM account from `account-setup.md`, and use `transport-handoff.md`
for EPV/PTA CEF transport ownership.

```bash
bash skills/splunk-cyberark-ta-setup/scripts/validate.sh --index cyberark
```

Readiness handoffs: `cyberark_epm` and `cyberark_epv_pta`.