celmex

Elm SDK and CLI for the Cortex Platform REST API.

Elm library

Install:

elm install vanhecke/celmex

Use:

import Cortex.Client exposing (Config, send)
import Cortex.Auth exposing (Credentials)
import Cortex.Api.AuditLogs as AuditLogs

config : Config
config =
    { tenant = "https://api-yourfqdn.xdr.eu.paloaltonetworks.com"
    , credentials = { apiKeyId = "...", apiKey = "..." }
    }

-- Send a request
send config GotAuditLogs AuditLogs.search

CLI

One-off (no install):

export CORTEX_TENANT_URL="https://api-yourfqdn.xdr.eu.paloaltonetworks.com"
export CORTEX_API_KEY_ID="..."
export CORTEX_API_KEY="..."

npx celmex healthcheck
npx celmex audit-logs search

Persistent install (adds cortex to your PATH):

npm install -g celmex
cortex audit-logs search

Environment contract

Development

cp .envrc.example .envrc    # fill in credentials, then: source .envrc
npm install
just build                  # format + compile cli/dist/elm.js
just test                   # run BATS integration tests against a real tenant
just cli healthcheck        # rebuild if needed, then invoke ./cli/bin/cortex
just clean                  # remove build artifacts

Releasing

just publish 1.0.1          # bump elm.json + package.json, tag, push, publish both