Skip to content

armgit / AiSOC

Public Imported from GitHub
0

Open-source AI Security Operations Center: alert fusion, LLM-agent triage, MITRE ATT&CK investigation, and a replayable decision ledger for every agent step. Self-hostable, runs with no API keys, MIT licensed. Ships an MCP server for Claude, Cursor and Continue.

docs: rebrand to AiSOC community + fix repo URLs and metadata

Beenu Aroraebe2d5ea0374
diff --git a/.env.example b/.env.example
index 2b289eb17..c5440372f 100644
--- a/.env.example
+++ b/.env.example
@@ -115,4 +115,5 @@ AZURE_WORKSPACE_NAME=
# ─── Frontend ─────────────────────────────────────────────────────────────────
NEXT_PUBLIC_API_URL=http://localhost:8000
-NEXT_PUBLIC_WS_URL=ws://localhost:4000
+NEXT_PUBLIC_REALTIME_URL=http://localhost:8086
+NEXT_PUBLIC_WS_URL=ws://localhost:8086
diff --git a/AGENTS.md b/AGENTS.md
index 0b0679139..dc67f5ba2 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -9,7 +9,7 @@
## Learned Workspace Facts
-- Project: AiSOC — AI-powered Security Operations Center, open-source, built by Cyble under the MIT license.
+- Project: AiSOC — open-source, AI-powered Security Operations Center maintained by the AiSOC community under the MIT license.
- Monorepo managed with pnpm ([email protected]) and Turborepo; workspaces defined in `apps/*` and `packages/*`.
- Apps: `apps/web` (Next.js frontend), `apps/docs` (documentation site).
- Backend services in `services/`: `api` (FastAPI/Python 3.11), `agents`, `alert-fusion`, `connectors`, `demo-producer`, `enrichment`, `fusion`, `ingest`, `realtime`, `threatintel`, `ocsf`.
diff --git a/LICENSE b/LICENSE
index 07ae411db..f93b07304 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
MIT License
-Copyright (c) 2024 Cyble
+Copyright (c) 2024-present AiSOC contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
diff --git a/ROADMAP.md b/ROADMAP.md
index 290a5da69..26acbbf43 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -26,7 +26,7 @@ This document captures the planned direction for AiSOC across major versions. Al
- [x] Public REST API v1 at `/api/v1`, OpenAPI 3.1 at `docs/openapi.yaml`
- [x] GraphQL gateway (Strawberry) proxying REST
- [x] Scoped API tokens (`cases:read`, `playbooks:run`, `plugins:install`)
-- [x] Auto-generated client SDKs: `@aisoc/sdk` (TypeScript), `aisoc-sdk` (Python/PyPI), `github.com/beenuar/aisoc-go`
+- [x] Auto-generated client SDKs: `@aisoc/sdk` (TypeScript), `aisoc-sdk` (Python/PyPI), `github.com/beenuar/aisoc/sdk-go`
- [x] Docusaurus docs site at `docs/site/`, deployed to GitHub Pages
- [x] Demo Lab: `pnpm aisoc:lab` one-command full-stack + Conti-style ransomware scenario
- [x] 4 reference plugins: Okta connector, YARA enricher, Slack quarantine responder, MTTR sparkline widget
diff --git a/SECURITY.md b/SECURITY.md
index b128627e8..29b316b88 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -14,21 +14,14 @@ AiSOC is security software, so we take vulnerabilities in our own stack seriousl
Please **do not** open a public GitHub issue or PR for security problems.
-Report to **`[email protected]`** with as much detail as possible:
+Use [GitHub's private vulnerability reporting](https://github.com/beenuar/AiSOC/security/advisories/new) to send us a report directly. Include as much detail as possible:
- A clear description of the issue and its impact
- Steps to reproduce, ideally a minimal proof of concept
- Affected version, commit SHA, or container digest
- Your name / handle if you'd like to be credited
-If your report contains sensitive details (payloads, tokens, customer data), encrypt it with our PGP key:
-
-```
-PGP Key: 0xCY8L3-A1S0C-2024
-Fingerprint: 3F2E 9C1B 7A5D 4E8F 1029 3847 5612 ABCD EF01 2345
-```
-
-Request the latest key by emailing `[email protected]`.
+If GitHub's reporting flow is not workable for your situation, you can instead reach the maintainers through the [SECURITY contact in the repository profile](https://github.com/beenuar/AiSOC). Please request our PGP key in your first message and we'll respond out-of-band before you send sensitive details (payloads, tokens, customer data).
## What to expect
@@ -59,14 +52,15 @@ Out of scope:
If you operate AiSOC, please review:
-- `docs/runbooks/HARDENING.md` for production hardening steps
-- `infra/helm/aisoc/values.yaml` for the security-related defaults
-- `services/api/app/security/` for our auth, RBAC, and audit primitives
+- [`docs/runbooks/HARDENING.md`](docs/runbooks/HARDENING.md) for production hardening steps
+- [`infra/helm/aisoc/values.yaml`](infra/helm/aisoc/values.yaml) for the security-related defaults
+- [`services/api/app/core/security.py`](services/api/app/core/security.py) and [`services/api/app/auth/`](services/api/app/auth/) for our auth, RBAC, and SSO primitives
+- [`services/api/app/middleware/`](services/api/app/middleware/) for rate limiting, audit logging, and request hardening
## Bounty
-We currently run an **invite-only** bounty program. High-quality reports may be invited automatically. Email `[email protected]` if you'd like an invite.
+AiSOC is an open-source project and does not currently operate a paid bounty program. We deeply appreciate responsible reports and will credit researchers in advisories and the hall of fame.
## Hall of fame
-We publicly thank researchers who report valid issues at <https://cyble.com/security/hall-of-fame> after a fix has shipped.
+We publicly thank researchers who report valid issues. Once a fix has shipped, we credit reporters (with their consent) in the corresponding [GitHub Security Advisory](https://github.com/beenuar/AiSOC/security/advisories) and the relevant `CHANGELOG.md` entry.
diff --git a/apps/docs/docs/api/rest.md b/apps/docs/docs/api/rest.md
index 291df7cb1..302be8863 100644
--- a/apps/docs/docs/api/rest.md
+++ b/apps/docs/docs/api/rest.md
@@ -46,7 +46,7 @@ When running locally, interactive Swagger UI is available at:
- **ReDoc**: [http://localhost:8000/redoc](http://localhost:8000/redoc)
- **OpenAPI JSON**: [http://localhost:8000/openapi.json](http://localhost:8000/openapi.json)
-The full spec is also committed at [`docs/openapi.yaml`](https://github.com/beenuar/aisoc/blob/main/docs/openapi.yaml).
+The full spec is also committed at [`docs/openapi.yaml`](https://github.com/beenuar/AiSOC/blob/main/docs/openapi.yaml).
## Endpoint Groups
@@ -93,6 +93,58 @@ The full spec is also committed at [`docs/openapi.yaml`](https://github.com/been
| `GET` | `/playbooks/{id}/runs` | Execution history |
| `POST` | `/actions/dry-run` | Simulate an action |
+### Investigations & Ledger *(v5.2)*
+
+Every prompt, response, evidence citation, and tool call the AI investigator
+emits is appended to the **Investigation Ledger**. See
+[Cases — Investigation Ledger](../concepts/cases#investigation-ledger) for
+the data model and rationale.
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `GET` | `/cases/{case_id}/investigations` | List ledger entries for a case |
+| `GET` | `/investigations/{id}` | Single ledger entry with full payload |
+| `POST` | `/cases/{case_id}/investigations:replay` | Replay an investigation deterministically |
+| `POST` | `/cases/{case_id}/investigations:start` | Kick off a fresh agent investigation |
+
+### Ambient Copilot *(v5.2)*
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `GET` | `/copilot/context/{resource_type}/{resource_id}` | Context-aware suggestions for an alert / case / rule / playbook |
+| `POST` | `/copilot/actions/{action_id}:run` | Run a suggested action with the right agent tool |
+
+### Marketplace *(v5.2)*
+
+The marketplace surface is backed by the JSON index at
+[`marketplace/index.json`](https://github.com/beenuar/AiSOC/blob/main/marketplace/index.json)
+and re-published to the web app at `/marketplace/index.json`.
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `GET` | `/marketplace/items` | List plugins, detections, and playbooks |
+| `GET` | `/marketplace/items/{slug}` | Item detail with manifest + signature |
+| `POST` | `/marketplace/items/{slug}:install` | Install a plugin / detection / playbook into the tenant |
+
+### Responder PWA *(v5.2)*
+
+These endpoints back the mobile-first `/responder/*` route group.
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `GET/POST` | `/oncall/rotations` | List / create on-call rotations |
+| `GET` | `/oncall/whoison` | Currently on-call responder |
+| `GET/POST` | `/passkeys` | List / register WebAuthn credentials |
+| `DELETE` | `/passkeys/{id}` | Revoke a passkey |
+| `POST` | `/passkeys/challenge` | Begin WebAuthn ceremony |
+| `POST` | `/passkeys/verify` | Complete WebAuthn ceremony |
+| `GET/POST` | `/approvals` | List / create approval requests |
+| `POST` | `/approvals/{id}:approve` | Approve a request |
+| `POST` | `/approvals/{id}:reject` | Reject a request |
+| `GET/POST` | `/push/subscriptions` | List / register Web Push subscriptions |
+| `DELETE` | `/push/subscriptions/{id}` | Revoke a Web Push subscription |
+| `POST` | `/push/test` | Send a test push to the calling user |
+
### Threat Intelligence
| Method | Path | Description |
@@ -169,8 +221,12 @@ Response includes `"next_cursor"` when more pages exist.
## Client SDKs
-| Language | Package |
-|----------|---------|
-| Python | `packages/sdk-py` |
-| TypeScript | `packages/sdk-ts` |
-| Go | `packages/sdk-go` |
+| Language | Package | Notes |
+|----------|---------|-------|
+| Python | [`packages/sdk-py`](https://github.com/beenuar/AiSOC/tree/main/packages/sdk-py) | Async client built on `httpx` |
+| TypeScript | [`packages/sdk-ts`](https://github.com/beenuar/AiSOC/tree/main/packages/sdk-ts) | Browser + Node, fetch-based |
+| Go | [`packages/sdk-go`](https://github.com/beenuar/AiSOC/tree/main/packages/sdk-go) | Typed models + thin client helpers |
+
+In addition, the [Model Context Protocol server](../integrations/mcp)
+(`@aisoc/mcp`) exposes 11 of these endpoints as IDE-side tools for
+Claude / Cursor / Continue / Cody.
diff --git a/apps/docs/docs/api/websocket.md b/apps/docs/docs/api/websocket.md
index fac493584..e16687575 100644
--- a/apps/docs/docs/api/websocket.md
+++ b/apps/docs/docs/api/websocket.md
@@ -4,7 +4,7 @@ sidebar_position: 3
# WebSocket API Reference
-AiSOC streams real-time events over an authenticated WebSocket connection served by the `realtime` service (port 8002).
+AiSOC streams real-time events over an authenticated WebSocket connection served by the `realtime` service (port 8086).
## Connection
@@ -15,7 +15,7 @@ wss://your-domain.com/ws?token=<jwt>
Locally:
```
-ws://localhost:8002/ws?token=<jwt>
+ws://localhost:8086/ws?token=<jwt>
```
Pass a valid JWT in the `token` query parameter. The connection is rejected with `4001 Unauthorized` if the token is missing or expired.
@@ -129,7 +129,7 @@ Available channels: `alerts`, `cases`, `detections`, `investigations`, `ueba`, `
## Example (Browser)
```javascript
-const ws = new WebSocket(`ws://localhost:8002/ws?token=${jwt}`);
+const ws = new WebSocket(`ws://localhost:8086/ws?token=${jwt}`);
ws.onopen = () => {
ws.send(JSON.stringify({ type: "subscribe", channel: "all" }));
diff --git a/apps/docs/docs/concepts/cases.md b/apps/docs/docs/concepts/cases.md
index 69b74b305..ab1138c4b 100644
--- a/apps/docs/docs/concepts/cases.md
+++ b/apps/docs/docs/concepts/cases.md
@@ -22,12 +22,88 @@ or investigation is tracked as a Case.
| `mitre_tactics` | string[] | Associated ATT&CK tactics |
| `indicators` | Indicator[] | IOCs linked to the case |
| `playbook_runs` | PlaybookRun[] | Automation runs |
+| `ledger_entries` | LedgerEntry[] | Replayable agent decisions (see below) |
## AI Investigation
Click **Investigate with AI** to launch the multi-agent investigation pipeline:
-1. **ReconAgent** — collects case context, threat intel
-2. **ForensicAgent** — deep-dives indicators and timeline
-3. **ResponderAgent** — proposes (dry-run) containment steps
-4. **ReportWriterAgent** — generates PDF/Markdown report
+1. **OrchestratorAgent** — plans the investigation graph and routes work
+2. **ReconAgent** — collects case context, threat intel, environmental fit
+3. **ForensicAgent** — deep-dives indicators, timeline, attack-graph paths
+4. **ResponderAgent** — proposes (dry-run by default) containment steps
+5. **ReportWriterAgent** — generates the PDF / Markdown executive report
+
+The full graph lives under
+[`services/agents/app/investigator/`](https://github.com/beenuar/AiSOC/tree/main/services/agents/app/investigator).
+
+## Investigation Ledger
+
+The **Investigation Ledger** is the structural moat that separates AiSOC from
+closed-source AI SOC vendors: every prompt sent to an LLM, every response
+received, every tool invocation, every evidence citation, and every decision
+branch is appended to a tenant-scoped, append-only ledger and rendered as a
+scrubbable timeline on the case workspace.
+
+### What gets logged
+
+For every agent step, the ledger captures:
+
+- `agent_id` — which agent emitted the step (`orchestrator`, `recon`, …)
+- `step_kind` — `prompt`, `response`, `tool_call`, `tool_result`,
+ `decision`, `evidence_citation`, `plan_update`
+- `model` — the model name and provider used for the step
+- `prompt_hash` — SHA-256 of the prompt (so you can prove what was asked
+ without storing every byte twice)
+- `payload` — the structured content of the step (redacted per tenant
+ config)
+- `started_at` / `completed_at` / `latency_ms`
+- `tool_name` and `tool_input_hash` for tool calls
+- `evidence_uris` — links into PostgreSQL / OpenSearch / Neo4j / Qdrant
+ for every cited piece of evidence
+
+### Why it matters
+
+- **Auditability** — every claim the agent makes on a case is backed by
+ a logged tool call and evidence citation, scoped to a tenant.
+- **Replayability** — analysts can scrub the timeline and replay the
+ exact sequence the agent followed, including failed tool calls.
+- **Compliance** — feeds the SOC 2 / ISO 27001 / NIST CSF dashboards
+ with concrete, human-readable evidence of automated decisions.
+- **Debugging** — when an investigation goes wrong, the ledger is the
+ first place to look; you can see the exact prompt, response, and
+ tool input that produced the bad output.
+
+### Where it lives
+
+- Schema:
+ [`services/api/migrations/008_investigation_ledger.sql`](https://github.com/beenuar/AiSOC/blob/main/services/api/migrations/008_investigation_ledger.sql)
+- Model:
+ [`services/api/app/models/investigation.py`](https://github.com/beenuar/AiSOC/blob/main/services/api/app/models/investigation.py)
+- API endpoints:
+ [`services/api/app/api/v1/endpoints/investigations.py`](https://github.com/beenuar/AiSOC/blob/main/services/api/app/api/v1/endpoints/investigations.py)
+- Agent-side writer:
+ [`services/agents/app/investigator/ledger.py`](https://github.com/beenuar/AiSOC/blob/main/services/agents/app/investigator/ledger.py)
+- UI:
+ [`apps/web/src/components/cases/InvestigationLedger.tsx`](https://github.com/beenuar/AiSOC/blob/main/apps/web/src/components/cases/InvestigationLedger.tsx)
+
+### REST surface
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `GET` | `/api/v1/cases/{case_id}/investigations` | List ledger entries for a case |
+| `GET` | `/api/v1/investigations/{id}` | Get a single ledger entry with full payload |
+| `POST` | `/api/v1/cases/{case_id}/investigations:replay` | Replay an investigation deterministically |
+
+The ledger is also surfaced through the [MCP server](../integrations/mcp), so
+analysts can replay agent decisions directly from Claude / Cursor / Continue
+/ Cody.
+
+## Ambient Copilot
+
+The case workspace is **copilot-aware**: the Ambient Copilot panel proposes
+the next concrete action based on the current state of the case (e.g.
+"contain host", "open jira ticket", "add indicator to threat intel feed").
+Each suggestion is one click away from running the right agent tool with
+the right payload, and every accepted suggestion is recorded in the
+ledger.
diff --git a/apps/docs/docs/contributing/guidelines.md b/apps/docs/docs/contributing/guidelines.md
index 134a431df..53a461abf 100644
--- a/apps/docs/docs/contributing/guidelines.md
+++ b/apps/docs/docs/contributing/guidelines.md
@@ -8,7 +8,7 @@ Thank you for contributing to AiSOC! Please read these guidelines before opening
## Code of Conduct
-All contributors must follow our [Code of Conduct](https://github.com/beenuar/aisoc/blob/main/CODE_OF_CONDUCT.md).
+All contributors must follow our [Code of Conduct](https://github.com/beenuar/AiSOC/blob/main/CODE_OF_CONDUCT.md).
## Branching Strategy
@@ -51,4 +51,4 @@ Report security vulnerabilities privately via GitHub Security Advisories.
## License
By contributing, you agree that your contributions will be licensed under the
-[MIT License](https://github.com/beenuar/aisoc/blob/main/LICENSE).
+[MIT License](https://github.com/beenuar/AiSOC/blob/main/LICENSE).
diff --git a/apps/docs/docs/deployment/docker.md b/apps/docs/docs/deployment/docker.md
index 077fdd2c0..f304d01f0 100644
--- a/apps/docs/docs/deployment/docker.md
+++ b/apps/docs/docs/deployment/docker.md
@@ -4,18 +4,49 @@ sidebar_position: 1
# Docker Deployment
+AiSOC ships three Compose flavors. Pick the one that matches what you are doing.
+
+| File | Purpose | When to use |
+|------|---------|-------------|
+| `docker-compose.demo.yml` | Streamlined demo with seeded data | Trying AiSOC for the first time |
+| `docker-compose.yml` | Full developer stack | Active development against real source |
+| `docker-compose.prod.yml` | Production-leaning stack | Self-hosting on a single VM |
+
+## Streamlined demo
+
+The fastest path is the demo orchestrator. It pulls prebuilt images, runs the full stack, seeds an alert, and prints the URL of the resulting case in under five minutes.
+
+```bash
+pnpm aisoc:demo
+```
+
+Behind the scenes this runs `docker compose -f docker-compose.demo.yml up -d` against `ghcr.io/beenuar/aisoc-*` images. Stop it with:
+
+```bash
+pnpm aisoc:demo:down
+```
+
+If GHCR is unreachable on your network the orchestrator transparently falls back to a local build.
+
## Development
```bash
docker compose up -d
```
-This starts:
-- `api` on port 8000
-- `agents` on port 8001
-- `realtime` on port 8002
-- `postgres` on port 5432
-- `redis` on port 6379
+This starts the full developer stack:
+
+- `api` (FastAPI) on port `8000`
+- `agents` (LangGraph runtime) on port `8001`
+- `realtime` (Node + WebSocket + VAPID Web Push) on port `8002`
+- `mcp` (Model Context Protocol server) on port `8003`
+- `ingest` (Go) on port `8010`
+- `enrichment` (Go) on port `8011`
+- `web` (Next.js) on port `3000`
+- `postgres` on port `5432`
+- `nats` on port `4222`
+- `opensearch` on port `9200`
+- `redis` on port `6379`
## Production
@@ -25,13 +56,13 @@ Use the production compose file:
docker compose -f docker-compose.prod.yml up -d
```
-### Environment Variables
+Before going live, walk through the [Hardening Runbook](https://github.com/beenuar/AiSOC/blob/main/docs/runbooks/HARDENING.md) — TLS termination, secret rotation, network policies, and audit log forwarding all need to be in place.
-Copy `.env.example` to `.env` and fill in all required values before starting.
+### Environment variables
-See [Environment Variables](./env-vars) for the full reference.
+Copy `.env.example` to `.env` and fill in every required value before starting. See [Environment Variables](./env-vars) for the full reference.
-## Building Images
+## Building images
```bash
# Build all service images
@@ -41,16 +72,33 @@ docker compose build
docker compose build agents
```
-## Health Checks
+For releases, prebuilt and signed images are published to GHCR:
+
+```
+ghcr.io/beenuar/aisoc-api:v5.2.0
+ghcr.io/beenuar/aisoc-agents:v5.2.0
+ghcr.io/beenuar/aisoc-realtime:v5.2.0
+ghcr.io/beenuar/aisoc-mcp:v5.2.0
+ghcr.io/beenuar/aisoc-ingest:v5.2.0
+ghcr.io/beenuar/aisoc-enrichment:v5.2.0
+ghcr.io/beenuar/aisoc-web:v5.2.0
+```
+
+Each image is signed with Cosign — verify with `cosign verify --certificate-identity-regexp '^https://github.com/beenuar/AiSOC' --certificate-oidc-issuer https://token.actions.githubusercontent.com <image>`.
+
+## Health checks
```bash
curl http://localhost:8000/healthz
-# {"status": "ok", "version": "4.0.0"}
+# {"status": "ok", "version": "5.2.0"}
```
+Each service exposes the same shape on its own port (`8001`, `8002`, `8003`, `8010`, `8011`).
+
## Logs
```bash
docker compose logs -f agents
docker compose logs -f api
+docker compose logs -f mcp
```
diff --git a/apps/docs/docs/deployment/env-vars.md b/apps/docs/docs/deployment/env-vars.md
index 42a95a77e..489cf347e 100644
--- a/apps/docs/docs/deployment/env-vars.md
+++ b/apps/docs/docs/deployment/env-vars.md
@@ -4,131 +4,334 @@ sidebar_position: 3
# Environment Variables
-## Core (Required)
+This page is the source of truth for every environment variable AiSOC reads at runtime. Each section maps to a single service, mirroring the layout of [`services/`](https://github.com/beenuar/AiSOC/tree/main/services) in the repo.
-| Variable | Description |
-|----------|-------------|
-| `DATABASE_URL` | PostgreSQL async connection string (`postgresql+asyncpg://...`) |
-| `JWT_SECRET` | Random hex secret for JWT signing — `openssl rand -hex 32` |
-| `OPENAI_API_KEY` or `ANTHROPIC_API_KEY` | At least one LLM provider key is required |
+If you spot drift between this page and the code, please open a PR — the matching config files are linked at the top of every section.
-## Core (Optional)
+---
+
+## API service (`services/api`)
+
+Source: [`services/api/app/core/config.py`](https://github.com/beenuar/AiSOC/blob/main/services/api/app/core/config.py)
+
+The API uses bare environment variable names (no prefix). Booleans accept `true` / `false`; lists accept comma-separated strings.
+
+### Application
| Variable | Default | Description |
|----------|---------|-------------|
-| `REDIS_URL` | `redis://localhost:6379` | Redis connection string |
-| `KAFKA_BOOTSTRAP_SERVERS` | `localhost:9092` | Kafka broker list |
-| `API_HOST` | `http://localhost:8000` | Internal API URL |
-| `AGENTS_HOST` | `http://localhost:8001` | Internal agents URL |
-| `REALTIME_HOST` | `ws://localhost:8002` | WebSocket server URL |
+| `APP_NAME` | `AiSOC API` | Display name in OpenAPI docs |
+| `APP_VERSION` | `0.1.0` | Reported in `/healthz` |
+| `ENV` / `ENVIRONMENT` | `development` | One of `development`, `staging`, `production` |
+| `DEBUG` | `false` | Enables verbose error responses — never enable in production |
+| `API_PREFIX` | `/api/v1` | Mount point for the versioned API |
| `LOG_LEVEL` | `INFO` | `DEBUG`, `INFO`, `WARNING`, `ERROR` |
-| `DRY_RUN` | `true` | Global dry-run flag for all actions |
-| `MAX_CONCURRENT_INVESTIGATIONS` | `5` | Max parallel investigations |
-| `ENVIRONMENT` | `production` | `development`, `staging`, `production` |
-## LLM Configuration
+### Security and tokens
| Variable | Default | Description |
|----------|---------|-------------|
-| `LLM_PROVIDER` | `openai` | `openai` or `anthropic` |
-| `LLM_MODEL` | `gpt-4o` | Model identifier |
-| `LLM_TEMPERATURE` | `0.1` | Temperature (0–1) |
-| `LLM_MAX_TOKENS` | `4096` | Max tokens per LLM call |
+| `SECRET_KEY` | `change-me-in-production-at-least-32-chars` | **Required in production.** Signs primary access/refresh JWTs. Generate with `openssl rand -hex 32`. |
+| `ACCESS_TOKEN_EXPIRE_MINUTES` | `30` | Lifetime of an access token |
+| `REFRESH_TOKEN_EXPIRE_DAYS` | `7` | Lifetime of a refresh token |
+| `ALGORITHM` | `HS256` | JWT signing algorithm |
-## Threat Intelligence
+### Passkeys (WebAuthn)
| Variable | Default | Description |
|----------|---------|-------------|
-| `MISP_URL` | — | MISP instance base URL |
-| `MISP_API_KEY` | — | MISP automation key |
-| `OTX_API_KEY` | — | AlienVault OTX API key |
-| `VIRUSTOTAL_API_KEY` | — | VirusTotal API v3 key |
-| `SHODAN_API_KEY` | — | Shodan API key |
-| `TAXII_SERVER_URL` | — | TAXII 2.1 collection URL |
-| `TAXII_API_KEY` | — | TAXII authentication key |
+| `PASSKEY_RP_ID` | `localhost` | Relying-party ID — must match the eTLD+1 of the PWA origin (no scheme, no port) |
+| `PASSKEY_RP_NAME` | `AiSOC` | Display name shown in the OS passkey prompt |
+| `PASSKEY_RP_ORIGINS` | `http://localhost:3000,http://localhost:3001` | Comma-separated list of allowed origins |
+| `PASSKEY_CHALLENGE_TTL_SECONDS` | `300` | Lifetime of a single ceremony challenge |
-## SSO (SAML 2.0 / OIDC)
+### SSO — OIDC
+
+Source: [`services/api/app/auth/oidc.py`](https://github.com/beenuar/AiSOC/blob/main/services/api/app/auth/oidc.py)
| Variable | Default | Description |
|----------|---------|-------------|
-| `SAML_IDP_METADATA_URL` | — | IdP SAML metadata XML endpoint |
+| `OIDC_ISSUER` | — | OIDC issuer URL (used for `.well-known/openid-configuration` discovery) |
+| `OIDC_CLIENT_ID` | — | OAuth client ID |
+| `OIDC_CLIENT_SECRET` | — | OAuth client secret (omit if PKCE-only) |
+| `OIDC_REDIRECT_URI` | — | Redirect URI registered with the IdP |
+| `OIDC_SCOPES` | `openid profile email` | Space-separated scope list |
+| `OIDC_PKCE` | `true` | Enable PKCE for the authorization code flow |
+| `JWT_SECRET` | `changeme-insecure-default` | **Required in production.** Signs SSO-issued session JWTs. |
+| `JWT_ALGORITHM` | `HS256` | SSO JWT signing algorithm |
+| `JWT_EXPIRE_MINUTES` | `480` | SSO JWT lifetime |
+
+### SSO — SAML 2.0
+
+Source: [`services/api/app/auth/saml.py`](https://github.com/beenuar/AiSOC/blob/main/services/api/app/auth/saml.py)
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SAML_SP_ACS_URL` | `http://localhost:8000/auth/saml/acs` | SP Assertion Consumer Service URL |
| `SAML_SP_ENTITY_ID` | — | Service provider entity ID |
-| `SAML_ACS_URL` | — | Assertion Consumer Service URL |
-| `OIDC_DISCOVERY_URL` | — | OIDC `/.well-known/openid-configuration` |
-| `OIDC_CLIENT_ID` | — | OIDC client ID |
-| `OIDC_CLIENT_SECRET` | — | OIDC client secret |
-| `SSO_GROUP_ROLE_MAPPING` | `{}` | JSON: `{"admins": "admin", "soc": "analyst"}` |
+| `SAML_SP_PRIVATE_KEY` | — | PEM-encoded SP signing key |
+| `SAML_SP_CERT` | — | PEM-encoded SP certificate |
+| `SAML_IDP_ENTITY_ID` | — | IdP entity ID |
+| `SAML_IDP_SSO_URL` | — | IdP single sign-on URL |
+| `SAML_IDP_SLO_URL` | — | IdP single logout URL |
+| `SAML_IDP_CERT` | — | PEM-encoded IdP certificate |
+| `SAML_DEBUG` | `false` | Verbose SAML logging — disable in production |
+
+### Database, cache, queue
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DATABASE_URL` | `postgresql+asyncpg://aisoc:aisoc@localhost:5432/aisoc` | Async Postgres DSN |
+| `DATABASE_POOL_SIZE` | `20` | SQLAlchemy pool size |
+| `DATABASE_MAX_OVERFLOW` | `10` | SQLAlchemy max overflow |
+| `REDIS_URL` | `redis://localhost:6379/0` | Redis DSN |
+| `REDIS_POOL_SIZE` | `20` | Redis connection pool size |
+| `KAFKA_BROKERS` | `localhost:9092` | Comma-separated broker list |
+| `KAFKA_TOPIC_EVENTS` | `aisoc.normalized_events` | Topic for normalized events |
+| `KAFKA_TOPIC_ALERTS` | `aisoc.alerts` | Topic for emitted alerts |
+
+### Search and graph
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OPENSEARCH_URL` | `http://localhost:9200` | OpenSearch base URL |
+| `NEO4J_URI` | `bolt://localhost:7687` | Neo4j Bolt URI |
+| `NEO4J_USER` | `neo4j` | Neo4j user |
+| `NEO4J_PASSWORD` | — | Neo4j password |
+| `QDRANT_URL` | `http://localhost:6333` | Qdrant base URL |
+| `CLICKHOUSE_HOST` / `CLICKHOUSE_PORT` / `CLICKHOUSE_DATABASE` / `CLICKHOUSE_USER` / `CLICKHOUSE_PASSWORD` | `localhost` / `9000` / `aisoc` / `default` / — | ClickHouse connection details |
+
+### Realtime, demo, and feature toggles
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `REALTIME_BASE_URL` | `http://realtime:8086` | Internal URL the API uses to fan out push events |
+| `REALTIME_INTERNAL_TOKEN` | — | Shared secret with the realtime service for internal RPC |
+| `CORS_ORIGINS` | `http://localhost:3000,http://localhost:3001` | Comma-separated allow-list |
+| `OTEL_ENDPOINT` | — | OTLP collector endpoint |
+| `MAX_TENANTS` | `1000` | Hard cap for multi-tenant deployments |
+| `DEFAULT_TENANT_PLAN` | `starter` | Default plan for newly provisioned tenants |
+| `AISOC_PLUGINS_DIR` | `/opt/aisoc/plugins` | Filesystem path the plugin loader scans |
+| `AISOC_DEMO_MODE` | `false` | When `true`, mutating requests outside the demo tenant return 403 |
+| `AISOC_DEMO_TENANT` | `demo` | Tenant slug allowed to write in demo mode |
+| `AISOC_DEMO_BANNER` | `Demo data resets daily at 00:00 UTC. All write actions are disabled.` | Banner text rendered by the web app |
+| `AISOC_DISABLE_KAFKA` / `AISOC_DISABLE_CLICKHOUSE` / `AISOC_DISABLE_OPENSEARCH` / `AISOC_DISABLE_NEO4J` / `AISOC_DISABLE_QDRANT` | `false` | Skip the corresponding subsystem at boot — endpoints that need it return 503 |
+
+---
+
+## Agents service (`services/agents`)
+
+Source: [`services/agents/app/`](https://github.com/beenuar/AiSOC/tree/main/services/agents/app)
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OPENAI_API_KEY` | — | **Required.** OpenAI key used by the investigator and copilot agents |
+| `OPENAI_MODEL` | `gpt-4o` | LLM identifier — set per agent if you need different models |
+| `DATABASE_URL` | `postgresql+asyncpg://aisoc:aisoc@localhost:5432/aisoc` | Postgres DSN for the Investigation Ledger |
+| `QDRANT_URL` | `http://localhost:6333` | Vector store for case memory and RAG |
+| `ENRICHMENT_SERVICE_URL` | `http://enrichment:8011` | URL of the enrichment service (Go) |
+| `API_SERVICE_URL` / `API_URL` | `http://api:8000` | URL of the FastAPI service |
+| `REALTIME_URL` | `http://realtime:8086` | Realtime service URL for streaming agent traces |
+| `REALTIME_INTERNAL_TOKEN` / `INTERNAL_TOKEN` | — | Shared secret matching the API/realtime services |
+| `PLAYBOOK_STORE_DIR` | `/data/playbooks` | Filesystem path for executable playbook DSL files |
+| `PLAYBOOK_PACK_ROOT` | `/data/playbook-packs` | Root directory for community playbook packs |
+| `ATTCK_DATA_PATH` | — | Path to a local MITRE ATT&CK STIX bundle (falls back to the bundled snapshot) |
+| `OTEL_SERVICE_NAME` | `aisoc-agents` | Service name in OTel traces |
+| `AISOC_VERSION` | `0.1.0` | Reported in OTel resource attributes |
+| `JAEGER_HOST` / `JAEGER_PORT` | `localhost` / `6831` | Jaeger agent endpoint (used when `OTEL_EXPORTER=jaeger`) |
+| `OTEL_EXPORTER_OTLP_ENDPOINT` | — | OTLP collector endpoint |
+| `OTEL_EXPORTER` | `otlp` | One of `otlp`, `jaeger`, `console` |
+
+---
+
+## Realtime service (`services/realtime`)
+
+Source: [`services/realtime/src/index.ts`](https://github.com/beenuar/AiSOC/blob/main/services/realtime/src/index.ts)
-## UEBA Service
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PORT` | `8086` | TCP port for the WebSocket and push endpoints |
+| `LOG_LEVEL` | `info` | Pino log level (`trace`, `debug`, `info`, `warn`, `error`) |
+| `REDIS_URL` | `redis://localhost:6379/4` | Redis connection used for the push subscription store |
+| `KAFKA_BOOTSTRAP_SERVERS` | `localhost:9092` | Kafka brokers — the realtime service consumes the fused-alerts topic to push to clients |
+| `KAFKA_TOPIC_FUSED` | `aisoc.alerts.fused` | Topic with fused alerts that should reach connected SOC clients |
+| `VAPID_PUBLIC_KEY` | — | VAPID public key for Web Push — generate with `npx web-push generate-vapid-keys` |
+| `VAPID_PRIVATE_KEY` | — | VAPID private key — keep in a secret manager |
+| `VAPID_SUBJECT` | `mailto:[email protected]` | Contact email or URL surfaced to push services |
+| `INTERNAL_TOKEN` | — | Must match the API's `REALTIME_INTERNAL_TOKEN` (used by the API to fan out push events) |
+
+---
+
+## MCP server (`services/mcp`)
+
+Source: [`services/mcp/src/config.ts`](https://github.com/beenuar/AiSOC/blob/main/services/mcp/src/config.ts)
+
+The MCP server runs as a sidecar that exposes Investigation Ledger tools to LLM clients (Claude Desktop, Cursor, Copilot, …) via the Model Context Protocol.
| Variable | Default | Description |
|----------|---------|-------------|
-| `UEBA_DATABASE_URL` | Same as `DATABASE_URL` | Dedicated DB URL for UEBA |
-| `UEBA_KAFKA_TOPIC_INPUT` | `security.events` | Kafka topic for raw security events |
-| `UEBA_KAFKA_TOPIC_ANOMALIES` | `security.anomalies` | Kafka topic for published anomalies |
-| `UEBA_ZSCORE_THRESHOLD` | `3.0` | Z-score threshold for anomaly flagging |
-| `UEBA_MIN_SAMPLES` | `30` | Minimum events before scoring begins |
+| `AISOC_URL` | `http://localhost:8081` | Base URL of the AiSOC API |
+| `AISOC_API_URL` | falls back to `AISOC_URL` | Override the API URL independently if the API and web app live on separate hosts |
+| `AISOC_API_KEY` | — | Long-lived API key (preferred for server-to-server use) |
+| `AISOC_TOKEN` | — | Short-lived JWT (alternative to `AISOC_API_KEY`) |
+| `AISOC_TIMEOUT_MS` | `20000` | HTTP timeout for outbound calls to the AiSOC API |
+| `AISOC_MCP_VERBOSE` | `0` | Set to `1` to log every tool invocation to stderr |
+
+---
+
+## Ingest service (`services/ingest`)
+
+Source: [`services/ingest/internal/config/config.go`](https://github.com/beenuar/AiSOC/blob/main/services/ingest/internal/config/config.go)
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `HTTP_PORT` | `8080` | HTTP listener port |
+| `KAFKA_BROKERS` | `localhost:9092` | Comma-separated broker list |
+| `KAFKA_TOPIC` | `security.events` | Topic for normalized events |
+| `REDIS_ADDR` | `localhost:6379` | Redis address (for dedup and rate limiting) |
+| `DATABASE_DSN` | `postgres://aisoc:aisoc@localhost:5432/aisoc?sslmode=disable` | Postgres DSN |
+| `ATTCK_DATA_PATH` | — | Path to MITRE ATT&CK STIX bundle for technique tagging |
+| `NORMALIZER_MODE` | `auto` | `auto`, `strict`, or `passthrough` |
+| `MAX_BATCH_SIZE` | `1000` | Max events flushed per batch |
+| `WORKER_COUNT` | `4` | Number of normalization workers |
+| `TENANT_HEADER_KEY` | `X-AiSOC-Tenant` | HTTP header that carries the tenant slug |
+| `JWT_SECRET` | — | **Required outside `ENV=development`.** HMAC secret used to verify ingest tokens. |
+| `METRICS_PORT` | `9090` | Prometheus exporter port |
+| `SHODAN_API_KEY` | — | Optional — enables Shodan enrichment when paired with `SHODAN_ENRICH_ENABLED=true` |
+| `SHODAN_ENRICH_ENABLED` | `false` | Toggle Shodan IP enrichment |
+| `SHODAN_CACHE_EXPIRY_SECS` | `86400` | Cache TTL for Shodan lookups |
+| `VULN_CORREL_ENABLED` | `false` | Toggle CVE correlation against ingested events |
+| `VULN_KAFKA_TOPIC` | `security.vulnerabilities` | Topic for emitted vulnerability findings |
+| `NVD_API_KEY` | — | NVD API key (raises NVD rate limits when set) |
+
+---
+
+## UEBA service (`services/ueba`)
-## Honeytokens Service
+Source: [`services/ueba/app/core/config.py`](https://github.com/beenuar/AiSOC/blob/main/services/ueba/app/core/config.py)
+
+All variables use the `UEBA_` prefix.
| Variable | Default | Description |
|----------|---------|-------------|
-| `HONEYTOKENS_DATABASE_URL` | Same as `DATABASE_URL` | Dedicated DB URL |
-| `HONEYTOKENS_SECRET_KEY` | Derived from `JWT_SECRET` | HMAC-SHA256 signing key |
-| `HONEYTOKENS_BASE_URL` | `https://your-domain.com` | Public base URL for URL tokens |
-| `HONEYTOKENS_WEBHOOK_TIMEOUT` | `10` | Webhook delivery timeout (seconds) |
+| `UEBA_DATABASE_URL` | `postgresql+asyncpg://aisoc:aisoc@localhost:5432/aisoc` | Postgres DSN for baselines and anomalies |
+| `UEBA_KAFKA_BOOTSTRAP_SERVERS` | `localhost:9092` | Kafka brokers |
+| `UEBA_KAFKA_INPUT_TOPIC` | `security.events` | Topic the scorer consumes |
+| `UEBA_KAFKA_OUTPUT_TOPIC` | `ueba.anomalies` | Topic the scorer emits to |
+| `UEBA_KAFKA_CONSUMER_GROUP` | `ueba-service` | Kafka consumer group ID |
+| `UEBA_BASELINE_WINDOW_DAYS` | `30` | History window used to compute behavioural baselines |
+| `UEBA_ANOMALY_THRESHOLD` | `3.0` | Z-score threshold for flagging an event as anomalous |
+| `UEBA_PEER_GROUP_MIN_SIZE` | `3` | Minimum peers required for peer-group analysis |
+| `UEBA_SCORING_BATCH_SIZE` | `100` | Events processed per scoring batch |
+| `UEBA_OTEL_ENDPOINT` | `http://localhost:4317` | OTLP gRPC endpoint |
+| `UEBA_SERVICE_NAME` | `aisoc-ueba` | OTel service name |
+| `UEBA_HOST` | `0.0.0.0` | HTTP listener interface |
+| `UEBA_PORT` | `8004` | HTTP listener port |
+
+---
+
+## Honeytokens service (`services/honeytokens`)
+
+Source: [`services/honeytokens/app/core/config.py`](https://github.com/beenuar/AiSOC/blob/main/services/honeytokens/app/core/config.py)
-## Purple Team Service
+All variables use the `HONEYTOKEN_` prefix.
| Variable | Default | Description |
|----------|---------|-------------|
-| `PURPLE_TEAM_DATABASE_URL` | Same as `DATABASE_URL` | Dedicated DB URL |
-| `CALDERA_URL` | `http://localhost:8888` | Caldera server URL |
-| `CALDERA_API_KEY` | — | Caldera REST API key |
-| `ATOMIC_RED_TEAM_PATH` | `/data/atomic-red-team` | Mounted ART repository path |
+| `HONEYTOKEN_DATABASE_URL` | `postgresql+asyncpg://aisoc:aisoc@localhost:5432/aisoc` | Postgres DSN for token metadata and triggers |
+| `HONEYTOKEN_ALERT_WEBHOOK_URL` | — | Webhook called when a token is triggered |
+| `HONEYTOKEN_ALERT_WEBHOOK_SECRET` | `changeme` | **Rotate before going live.** HMAC-SHA256 secret for webhook signing |
+| `HONEYTOKEN_TOKEN_TTL_DAYS` | `365` | Default token expiry |
+| `HONEYTOKEN_OTEL_ENDPOINT` | `http://localhost:4317` | OTLP collector endpoint |
+| `HONEYTOKEN_SERVICE_NAME` | `aisoc-honeytokens` | OTel service name |
+| `HONEYTOKEN_HOST` | `0.0.0.0` | HTTP listener interface |
+| `HONEYTOKEN_PORT` | `8005` | HTTP listener port |
+
+---
+
+## Purple Team service (`services/purple-team`)
+
+Source: [`services/purple-team/app/core/config.py`](https://github.com/beenuar/AiSOC/blob/main/services/purple-team/app/core/config.py)
-## Observability (OpenTelemetry)
+All variables use the `PURPLE_TEAM_` prefix.
| Variable | Default | Description |
|----------|---------|-------------|
-| `OTEL_EXPORTER_OTLP_ENDPOINT` | — | OTLP gRPC endpoint (e.g. `http://localhost:4317`) |
-| `OTEL_SERVICE_NAME` | `aisoc-api` | Service name in traces |
-| `OTEL_TRACES_SAMPLER_ARG` | `1.0` | Sampling rate (0–1) |
+| `PURPLE_TEAM_DATABASE_URL` | `postgresql+asyncpg://aisoc:aisoc@localhost:5432/aisoc` | Postgres DSN for emulation runs and findings |
+| `PURPLE_TEAM_CALDERA_URL` | `http://localhost:8888` | Caldera server URL |
+| `PURPLE_TEAM_CALDERA_API_KEY` | `ADMIN123` | **Rotate before going live.** Caldera REST API key |
+| `PURPLE_TEAM_ART_REPO_PATH` | `/opt/atomic-red-team` | Filesystem path to the Atomic Red Team checkout |
+| `PURPLE_TEAM_ART_ATOMICS_PATH` | `/opt/atomic-red-team/atomics` | Path to the `atomics/` directory inside ART |
+| `PURPLE_TEAM_ATTACK_STIX_URL` | `https://raw.githubusercontent.com/mitre/cti/master/enterprise-attack/enterprise-attack.json` | URL to the MITRE ATT&CK STIX bundle |
+| `PURPLE_TEAM_OTEL_ENDPOINT` | `http://localhost:4317` | OTLP collector endpoint |
+| `PURPLE_TEAM_SERVICE_NAME` | `aisoc-purple-team` | OTel service name |
+| `PURPLE_TEAM_HOST` | `0.0.0.0` | HTTP listener interface |
+| `PURPLE_TEAM_PORT` | `8006` | HTTP listener port |
-## Backup & Encryption
+---
+
+## Web app (`apps/web`)
+
+The Next.js frontend reads only public, build-time variables. Anything sensitive belongs in the API layer.
| Variable | Default | Description |
|----------|---------|-------------|
-| `BACKUP_ENCRYPTION_KEY` | — | AES-256-GCM key for encrypted backups |
-| `BACKUP_S3_BUCKET` | — | S3/R2 bucket for off-site backup upload |
-| `BACKUP_S3_PREFIX` | `aisoc-backups/` | Object key prefix |
+| `NEXT_PUBLIC_API_URL` | `http://localhost:8000` | Base URL the browser uses to reach the API |
+| `NEXT_PUBLIC_REALTIME_URL` | `http://localhost:8086` | HTTP base of the realtime service (used for VAPID subscription registration) |
+| `NEXT_PUBLIC_WS_URL` | `ws://localhost:8086` | WebSocket URL for the realtime feed |
+| `NEXT_PUBLIC_VAPID_PUBLIC_KEY` | — | Must match the realtime service's `VAPID_PUBLIC_KEY` |
+
+---
-## Example `.env`
+## Example `.env` (full stack)
```bash
-# Core
+# --- API ---
+SECRET_KEY=$(openssl rand -hex 32)
+ACCESS_TOKEN_EXPIRE_MINUTES=30
DATABASE_URL=postgresql+asyncpg://aisoc:changeme@localhost:5432/aisoc
-JWT_SECRET=<run: openssl rand -hex 32>
+REDIS_URL=redis://localhost:6379/0
+KAFKA_BROKERS=localhost:9092
+OPENSEARCH_URL=http://localhost:9200
+QDRANT_URL=http://localhost:6333
+CORS_ORIGINS=http://localhost:3000
+
+# --- API: SSO (set both blocks if you actually use SSO) ---
+JWT_SECRET=$(openssl rand -hex 32)
+
+# --- Agents ---
OPENAI_API_KEY=sk-...
+OPENAI_MODEL=gpt-4o
+ENRICHMENT_SERVICE_URL=http://enrichment:8011
-# Services
-REDIS_URL=redis://localhost:6379
-KAFKA_BOOTSTRAP_SERVERS=localhost:9092
-LOG_LEVEL=INFO
-DRY_RUN=true
+# --- Realtime ---
+VAPID_PUBLIC_KEY=...
+VAPID_PRIVATE_KEY=...
+VAPID_SUBJECT=mailto:[email protected]
+INTERNAL_TOKEN=$(openssl rand -hex 32)
+REALTIME_INTERNAL_TOKEN=${INTERNAL_TOKEN}
-# LLM
-LLM_MODEL=gpt-4o
-LLM_TEMPERATURE=0.1
+# --- MCP ---
+AISOC_URL=http://localhost:8000
+AISOC_API_KEY=...
-# Honeytokens
-HONEYTOKENS_BASE_URL=https://aisoc.example.com
-HONEYTOKENS_SECRET_KEY=<run: openssl rand -hex 32>
+# --- Ingest ---
+HTTP_PORT=8080
+KAFKA_TOPIC=security.events
+DATABASE_DSN=postgres://aisoc:changeme@localhost:5432/aisoc?sslmode=disable
+JWT_SECRET=${JWT_SECRET}
-# Purple Team
-CALDERA_URL=http://caldera:8888
-CALDERA_API_KEY=your-caldera-key
+# --- UEBA / Honeytokens / Purple Team ---
+UEBA_DATABASE_URL=${DATABASE_URL}
+HONEYTOKEN_DATABASE_URL=${DATABASE_URL}
+HONEYTOKEN_ALERT_WEBHOOK_SECRET=$(openssl rand -hex 32)
+PURPLE_TEAM_DATABASE_URL=${DATABASE_URL}
+PURPLE_TEAM_CALDERA_API_KEY=...
-# Observability
-OTEL_EXPORTER_OTLP_ENDPOINT=http://tempo:4317
+# --- Web ---
+NEXT_PUBLIC_API_URL=http://localhost:8000
+NEXT_PUBLIC_REALTIME_URL=ws://localhost:8086
+NEXT_PUBLIC_VAPID_PUBLIC_KEY=${VAPID_PUBLIC_KEY}
```
+
+Before going to production, run through the [Hardening Runbook](https://github.com/beenuar/AiSOC/blob/main/docs/runbooks/HARDENING.md) to make sure every secret has been rotated away from the example values above.
diff --git a/apps/docs/docs/deployment/kubernetes.md b/apps/docs/docs/deployment/kubernetes.md
index 47b090245..bb13ac615 100644
--- a/apps/docs/docs/deployment/kubernetes.md
+++ b/apps/docs/docs/deployment/kubernetes.md
@@ -4,49 +4,90 @@ sidebar_position: 2
# Kubernetes Deployment
-## Helm Chart
+The supported way to run AiSOC on Kubernetes is the Helm chart shipped at [`infra/helm/aisoc/`](https://github.com/beenuar/AiSOC/tree/main/infra/helm/aisoc) in the repo. It deploys every service (api, agents, realtime, mcp, ingest, enrichment, web) plus optional bundled Postgres, Redis, NATS, and OpenSearch via subcharts.
+
+## Helm chart (in-repo)
```bash
-helm repo add aisoc https://beenuar.github.io/aisoc/charts
-helm install aisoc aisoc/aisoc \
- --set openai.apiKey=sk-... \
- --set postgres.password=secret \
- --namespace aisoc --create-namespace
+git clone https://github.com/beenuar/AiSOC.git
+cd AiSOC
+
+helm dependency update infra/helm/aisoc
+
+helm install aisoc infra/helm/aisoc \
+ --namespace aisoc --create-namespace \
+ --set api.image.tag=v5.2.0 \
+ --set agents.image.tag=v5.2.0 \
+ --set realtime.image.tag=v5.2.0 \
+ --set mcp.image.tag=v5.2.0 \
+ --set web.image.tag=v5.2.0 \
+ --set secrets.openai.apiKey=sk-... \
+ --set postgresql.auth.password=changeme
```
-## Manual Manifests
+Override any of the defaults in [`infra/helm/aisoc/values.yaml`](https://github.com/beenuar/AiSOC/blob/main/infra/helm/aisoc/values.yaml). For production deployments, walk through the [Hardening Runbook](https://github.com/beenuar/AiSOC/blob/main/docs/runbooks/HARDENING.md) before exposing the platform on the public internet.
-Kubernetes manifests are available in `deploy/k8s/`:
+## Container images
+
+All images are published to GHCR and Cosign-signed:
```
-deploy/k8s/
-├── namespace.yaml
-├── configmap.yaml
-├── secrets.yaml
-├── postgres/
-├── redis/
-├── api/
-├── agents/
-├── realtime/
-└── web/
+ghcr.io/beenuar/aisoc-api:v5.2.0
+ghcr.io/beenuar/aisoc-agents:v5.2.0
+ghcr.io/beenuar/aisoc-realtime:v5.2.0
+ghcr.io/beenuar/aisoc-mcp:v5.2.0
+ghcr.io/beenuar/aisoc-ingest:v5.2.0
+ghcr.io/beenuar/aisoc-enrichment:v5.2.0
+ghcr.io/beenuar/aisoc-web:v5.2.0
```
-Apply:
+Verify a signature before deploying:
```bash
-kubectl apply -f deploy/k8s/ -n aisoc
+cosign verify \
+ --certificate-identity-regexp '^https://github.com/beenuar/AiSOC' \
+ --certificate-oidc-issuer https://token.actions.githubusercontent.com \
+ ghcr.io/beenuar/aisoc-api:v5.2.0
```
## Scaling
```bash
-# Scale the agents service
kubectl scale deployment aisoc-agents --replicas=3 -n aisoc
+kubectl scale deployment aisoc-api --replicas=2 -n aisoc
+kubectl scale deployment aisoc-mcp --replicas=2 -n aisoc
```
+Horizontal Pod Autoscaler manifests are included in the chart — enable them with `--set api.autoscaling.enabled=true` (and similarly for `agents`, `realtime`, `mcp`).
+
## Ingress
-Configure an Ingress controller to route:
-- `aisoc.example.com` → `web` service (port 3000)
-- `api.aisoc.example.com` → `api` service (port 8000)
-- `ws.aisoc.example.com` → `realtime` service (port 8002)
+The chart ships an Ingress template. Configure your hostnames via values:
+
+```yaml
+ingress:
+ enabled: true
+ className: nginx
+ annotations:
+ cert-manager.io/cluster-issuer: letsencrypt-prod
+ hosts:
+ - host: aisoc.example.com # web (Next.js, port 3000)
+ paths: [ "/" ]
+ - host: api.aisoc.example.com # api (FastAPI, port 8000)
+ paths: [ "/api", "/healthz" ]
+ - host: ws.aisoc.example.com # realtime (WebSocket + push, port 8002)
+ paths: [ "/ws" ]
+ - host: mcp.aisoc.example.com # MCP server (port 8003) — optional
+ paths: [ "/mcp" ]
+ tls:
+ - secretName: aisoc-tls
+ hosts:
+ - aisoc.example.com
+ - api.aisoc.example.com
+ - ws.aisoc.example.com
+ - mcp.aisoc.example.com
+```
+
+## Network policies
+
+The chart includes opinionated `NetworkPolicy` resources that restrict each service to only the dependencies it needs (for example, `agents` can reach Postgres, NATS, and OpenSearch but not the public internet). Enable them with `--set networkPolicies.enabled=true`. They are off by default to keep first-time installs frictionless, and on for any environment that holds real telemetry.
diff --git a/apps/docs/docs/integrations/mcp.md b/apps/docs/docs/integrations/mcp.md
index f8cb34cab..3712419ed 100644
--- a/apps/docs/docs/integrations/mcp.md
+++ b/apps/docs/docs/integrations/mcp.md
@@ -110,7 +110,7 @@ All flags can be set via env vars; the CLI flag wins if both are present.
| `--aisoc-url` | `AISOC_URL` | `http://localhost:8081` | Base URL of the AiSOC API. |
| `--api-key` | `AISOC_API_KEY` | _(none)_ | API key (`aisoc_pat_…`) or JWT. Required for non-public endpoints. |
| `--timeout` | `AISOC_TIMEOUT_MS` | `20000` | Per-request timeout in ms. |
-| `--verbose` | `AISOC_VERBOSE=1` | off | Lifecycle logs to stderr (stdout stays JSON-RPC clean). |
+| `--verbose` | `AISOC_MCP_VERBOSE=1` | off | Lifecycle logs to stderr (stdout stays JSON-RPC clean). |
## Manual (no-installer) setup
diff --git a/apps/docs/docs/plugins/publishing.md b/apps/docs/docs/plugins/publishing.md
index 051364bb6..a56b72d1e 100644
--- a/apps/docs/docs/plugins/publishing.md
+++ b/apps/docs/docs/plugins/publishing.md
@@ -33,6 +33,6 @@ Share your plugin with the AiSOC community via the marketplace.
- Include a `README.md` with installation and configuration instructions
- Write tests with ≥ 80% coverage
-- Follow the AiSOC [Code of Conduct](https://github.com/beenuar/aisoc/blob/main/CODE_OF_CONDUCT.md)
+- Follow the AiSOC [Code of Conduct](https://github.com/beenuar/AiSOC/blob/main/CODE_OF_CONDUCT.md)
- Pin dependency versions for reproducibility
- Never log or store credentials in plain text
diff --git a/apps/docs/docusaurus.config.ts b/apps/docs/docusaurus.config.ts
index e9b7bd5f5..323c8da7f 100644
--- a/apps/docs/docusaurus.config.ts
+++ b/apps/docs/docusaurus.config.ts
@@ -9,10 +9,10 @@ const config: Config = {
favicon: "img/favicon.ico",
url: "https://beenuar.github.io",
- baseUrl: "/aisoc/",
+ baseUrl: "/AiSOC/",
organizationName: "beenuar",
- projectName: "aisoc",
+ projectName: "AiSOC",
onBrokenLinks: "throw",
onBrokenMarkdownLinks: "warn",
@@ -28,11 +28,11 @@ const config: Config = {
{
docs: {
sidebarPath: "./sidebars.ts",
- editUrl: "https://github.com/beenuar/aisoc/tree/main/apps/docs/",
+ editUrl: "https://github.com/beenuar/AiSOC/tree/main/apps/docs/",
},
blog: {
showReadingTime: true,
- editUrl: "https://github.com/beenuar/aisoc/tree/main/apps/docs/",
+ editUrl: "https://github.com/beenuar/AiSOC/tree/main/apps/docs/",
},
theme: {
customCss: "./src/css/custom.css",
@@ -58,7 +58,7 @@ const config: Config = {
},
{ to: "/blog", label: "Blog", position: "left" },
{
- href: "https://github.com/beenuar/aisoc",
+ href: "https://github.com/beenuar/AiSOC",
label: "GitHub",
position: "right",
},
@@ -80,11 +80,11 @@ const config: Config = {
items: [
{
label: "GitHub Discussions",
- href: "https://github.com/beenuar/aisoc/discussions",
+ href: "https://github.com/beenuar/AiSOC/discussions",
},
{
label: "Issues",
- href: "https://github.com/beenuar/aisoc/issues",
+ href: "https://github.com/beenuar/AiSOC/issues",
},
],
},
@@ -94,7 +94,7 @@ const config: Config = {
{ label: "Blog", to: "/blog" },
{
label: "GitHub",
- href: "https://github.com/beenuar/aisoc",
+ href: "https://github.com/beenuar/AiSOC",
},
],
},
diff --git a/apps/web/public/logo.svg b/apps/web/public/logo.svg
index 528b18efc..d0051e795 100644
--- a/apps/web/public/logo.svg
+++ b/apps/web/public/logo.svg
@@ -42,6 +42,6 @@
</g>
<g font-family="Inter, system-ui, sans-serif" font-weight="700" letter-spacing="-0.5">
<text x="74" y="42" font-size="30" fill="url(#aisocLogoText)">AiSOC</text>
- <text x="184" y="42" font-size="14" font-weight="500" fill="rgba(148,163,184,0.85)" letter-spacing="0.4">by Cyble</text>
+ <text x="184" y="42" font-size="14" font-weight="500" fill="rgba(148,163,184,0.85)" letter-spacing="0.4">open-source</text>
</g>
</svg>
diff --git a/apps/web/public/marketplace/index.json b/apps/web/public/marketplace/index.json
index 3b29e296d..f717aefb7 100644
--- a/apps/web/public/marketplace/index.json
+++ b/apps/web/public/marketplace/index.json
@@ -1,7 +1,7 @@
{
"$schema": "https://aisoc.dev/schemas/marketplace/v1.json",
"version": "1.0.0",
- "generated": "2026-05-04T08:01:43Z",
+ "generated": "2026-05-04T14:49:29Z",
"categories": [
{
"id": "playbooks",
@@ -5548,7 +5548,7 @@
],
"plugin_type": "action",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/cloudflare-waf",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/cloudflare-waf",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5575,7 +5575,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/datadog-incidents",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/datadog-incidents",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5602,7 +5602,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/github-audit",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/github-audit",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5629,7 +5629,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/gitlab-audit",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/gitlab-audit",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5656,7 +5656,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/jamf-mdm",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/jamf-mdm",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5683,7 +5683,7 @@
],
"plugin_type": "widget",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/mttr-widget",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/mttr-widget",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5710,7 +5710,7 @@
],
"plugin_type": "action",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/notion-incidents",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/notion-incidents",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5736,7 +5736,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/okta-connector",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/okta-connector",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5763,7 +5763,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/onepassword-events",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/onepassword-events",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5790,7 +5790,7 @@
],
"plugin_type": "action",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/pagerduty-paging",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/pagerduty-paging",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5816,7 +5816,7 @@
],
"plugin_type": "responder",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/slack-quarantine",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/slack-quarantine",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5844,7 +5844,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/snowflake-events",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/snowflake-events",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5871,7 +5871,7 @@
],
"plugin_type": "action",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/tailscale-acl",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/tailscale-acl",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5898,7 +5898,7 @@
],
"plugin_type": "action",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/twilio-sms",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/twilio-sms",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5924,7 +5924,7 @@
],
"plugin_type": "enricher",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/yara-enricher",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/yara-enricher",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
diff --git a/apps/web/src/app/layout.tsx b/apps/web/src/app/layout.tsx
index 4d40fc75e..df427e39f 100644
--- a/apps/web/src/app/layout.tsx
+++ b/apps/web/src/app/layout.tsx
@@ -22,7 +22,7 @@ export const metadata: Metadata = {
template: '%s | AiSOC',
},
description:
- 'Open-source AI-powered Security Operations Center by Cyble. Real-time threat detection, autonomous investigation, MITRE ATT&CK-aware response — under MIT.',
+ 'Open-source AI-powered Security Operations Center. Real-time threat detection, autonomous investigation, MITRE ATT&CK-aware response — under MIT.',
keywords: [
'AiSOC',
'SOC',
@@ -34,10 +34,9 @@ export const metadata: Metadata = {
'open source',
'SOAR',
'XDR',
- 'Cyble',
],
- authors: [{ name: 'Cyble', url: 'https://cyble.com' }],
- creator: 'Cyble',
+ authors: [{ name: 'AiSOC contributors', url: 'https://github.com/beenuar/AiSOC' }],
+ creator: 'AiSOC contributors',
metadataBase: new URL('https://aisoc.dev'),
openGraph: {
title: 'AiSOC — AI Security Operations Center',
diff --git a/apps/web/src/app/page.tsx b/apps/web/src/app/page.tsx
index 050dd640e..7af4a0bdd 100644
--- a/apps/web/src/app/page.tsx
+++ b/apps/web/src/app/page.tsx
@@ -8,14 +8,14 @@ import { OpenSource } from '@/components/landing/OpenSource';
import { Footer } from '@/components/landing/Footer';
export const metadata: Metadata = {
- title: 'AiSOC — Open-source AI Security Operations Center by Cyble',
+ title: 'AiSOC — Open-source AI Security Operations Center',
description:
'Real-time detection, autonomous triage, and MITRE ATT&CK-aware investigation in one MIT-licensed platform. Self-hosted, extensible, free forever.',
alternates: { canonical: '/' },
openGraph: {
title: 'AiSOC — Open-source AI Security Operations Center',
description:
- 'Real-time detection, autonomous triage, and MITRE ATT&CK-aware investigation. MIT licensed. By Cyble.',
+ 'Real-time detection, autonomous triage, and MITRE ATT&CK-aware investigation. MIT licensed. Community-built.',
images: ['/og-image.svg'],
type: 'website',
},
diff --git a/apps/web/src/components/alerts/AlertDetailView.tsx b/apps/web/src/components/alerts/AlertDetailView.tsx
index fb3a10415..78625d43d 100644
--- a/apps/web/src/components/alerts/AlertDetailView.tsx
+++ b/apps/web/src/components/alerts/AlertDetailView.tsx
@@ -48,7 +48,7 @@ const MOCK_ALERT: Alert = {
{ type: 'hash', value: 'a1b2c3d4e5f6789012345678901234567890abcd', malicious: true },
],
tags: ['powershell', 'c2-beacon', 'high-priority'],
- assignee: '[email protected]',
+ assignee: '[email protected]',
createdAt: new Date(Date.now() - 3600000).toISOString(),
updatedAt: new Date(Date.now() - 1800000).toISOString(),
};
diff --git a/apps/web/src/components/alerts/AlertsView.tsx b/apps/web/src/components/alerts/AlertsView.tsx
index c5b61e676..0608d72f7 100644
--- a/apps/web/src/components/alerts/AlertsView.tsx
+++ b/apps/web/src/components/alerts/AlertsView.tsx
@@ -52,7 +52,7 @@ const MOCK_ALERTS: Alert[] = Array.from({ length: 25 }, (_, i): Alert => {
createdAt: new Date(Date.now() - i * 1800000).toISOString(),
updatedAt: new Date(Date.now() - i * 900000).toISOString(),
tenantId: 'default',
- assignee: i % 3 === 0 ? '[email protected]' : undefined,
+ assignee: i % 3 === 0 ? '[email protected]' : undefined,
tags: i % 2 === 0 ? ['mitre:T1059', 'endpoint'] : ['network'],
iocs: [],
mitreAttack: i % 3 === 0 ? [{ tactic: 'Execution', technique: 'PowerShell', techniqueId: 'T1059.001' }] : [],
diff --git a/apps/web/src/components/cases/CaseWorkspace.tsx b/apps/web/src/components/cases/CaseWorkspace.tsx
index 6140e9ce3..5e9a75e5b 100644
--- a/apps/web/src/components/cases/CaseWorkspace.tsx
+++ b/apps/web/src/components/cases/CaseWorkspace.tsx
@@ -57,7 +57,7 @@ function buildDemoCase(id: string): Case {
"Behavior consistent with T1021.002 (SMB/Windows Admin Shares).",
status: 'in_progress',
severity: 'critical',
- assignee: '[email protected]',
+ assignee: '[email protected]',
alertIds: ['alert-9012', 'alert-9013', 'alert-9019', 'alert-9024'],
alertCount: 4,
tags: ['lateral-movement', 'credential-access', 'finance-subnet'],
diff --git a/apps/web/src/components/copilot/CopilotView.tsx b/apps/web/src/components/copilot/CopilotView.tsx
index 2b7a7683a..6f86360fe 100644
--- a/apps/web/src/components/copilot/CopilotView.tsx
+++ b/apps/web/src/components/copilot/CopilotView.tsx
@@ -136,7 +136,7 @@ function buildDemoReply(prompt: string): CopilotMessage {
'',
'- Risk score **92** (top 1% of fleet).',
'- 3 open alerts: privilege escalation, suspicious PowerShell, outbound to rare ASN.',
- '- Most likely user: `[email protected]` — 4 logon events in last 2h, all from a new device.',
+ '- Most likely user: `[email protected]` — 4 logon events in last 2h, all from a new device.',
'- Observed ATT&CK techniques: T1078.002, T1059.001, T1071.001.',
'',
'**Recommended next steps**',
diff --git a/apps/web/src/components/demo/DemoBanner.tsx b/apps/web/src/components/demo/DemoBanner.tsx
index ead3b2d4f..1345fd62a 100644
--- a/apps/web/src/components/demo/DemoBanner.tsx
+++ b/apps/web/src/components/demo/DemoBanner.tsx
@@ -40,7 +40,7 @@ export function DemoBanner() {
|
</span>
<a
- href="https://github.com/cyble/AiSOC#quickstart"
+ href="https://github.com/beenuar/AiSOC#quickstart"
target="_blank"
rel="noopener noreferrer"
className="underline underline-offset-2 hover:text-amber-100 transition-colors"
diff --git a/apps/web/src/components/landing/Footer.tsx b/apps/web/src/components/landing/Footer.tsx
index ad44958fc..a1442fe78 100644
--- a/apps/web/src/components/landing/Footer.tsx
+++ b/apps/web/src/components/landing/Footer.tsx
@@ -32,11 +32,11 @@ const COLUMNS = [
],
},
{
- label: 'Cyble',
+ label: 'Project',
links: [
- { label: 'About Cyble', href: 'https://cyble.com' },
{ label: 'Security policy', href: 'https://github.com/beenuar/AiSOC/blob/main/SECURITY.md' },
{ label: 'License (MIT)', href: 'https://github.com/beenuar/AiSOC/blob/main/LICENSE' },
+ { label: 'Releases', href: 'https://github.com/beenuar/AiSOC/releases' },
],
},
];
@@ -49,8 +49,8 @@ export function Footer() {
<div className="col-span-2">
<Logo size={36} withWordmark />
<p className="mt-4 max-w-sm text-sm leading-relaxed text-gray-400">
- The open-source AI Security Operations Center. Maintained by Cyble. MIT licensed,
- forever.
+ The open-source AI Security Operations Center. Maintained by the AiSOC community.
+ MIT licensed, forever.
</p>
<div className="mt-5 flex gap-3">
<a
@@ -64,15 +64,6 @@ export function Footer() {
<path d="M12 .5C5.65.5.5 5.65.5 12c0 5.08 3.29 9.39 7.86 10.91.58.11.79-.25.79-.56 0-.28-.01-1.02-.02-2-3.2.69-3.88-1.54-3.88-1.54-.52-1.32-1.27-1.67-1.27-1.67-1.04-.71.08-.69.08-.69 1.15.08 1.76 1.18 1.76 1.18 1.02 1.75 2.68 1.24 3.34.95.1-.74.4-1.24.73-1.53-2.55-.29-5.24-1.28-5.24-5.69 0-1.26.45-2.29 1.18-3.1-.12-.29-.51-1.46.11-3.05 0 0 .96-.31 3.15 1.18a10.9 10.9 0 015.74 0c2.19-1.49 3.15-1.18 3.15-1.18.62 1.59.23 2.76.11 3.05.74.81 1.18 1.84 1.18 3.1 0 4.42-2.7 5.39-5.27 5.68.41.36.78 1.06.78 2.14 0 1.55-.01 2.79-.01 3.17 0 .31.21.68.8.56C20.21 21.39 23.5 17.08 23.5 12 23.5 5.65 18.35.5 12 .5z" />
</svg>
</a>
- <a
- href="https://cyble.com"
- target="_blank"
- rel="noreferrer"
- aria-label="Cyble"
- className="inline-flex h-9 items-center gap-1.5 rounded-md border border-white/10 bg-white/[0.03] px-3 text-xs font-semibold text-gray-300 transition hover:border-white/20 hover:text-white"
- >
- cyble.com
- </a>
</div>
</div>
@@ -113,8 +104,8 @@ export function Footer() {
<div className="mt-12 flex flex-col items-start justify-between gap-3 border-t border-white/5 pt-6 text-xs text-gray-500 sm:flex-row sm:items-center">
<div>
- © {new Date().getFullYear()} Cyble Inc. AiSOC is open-source software released under
- the MIT License.
+ © {new Date().getFullYear()} AiSOC contributors. AiSOC is open-source software
+ released under the MIT License.
</div>
<div className="flex items-center gap-4">
<span className="inline-flex items-center gap-1.5">
@@ -127,7 +118,7 @@ export function Footer() {
rel="noreferrer"
className="font-mono hover:text-white"
>
- v0.3.0
+ v5.2.0
</a>
</div>
</div>
diff --git a/apps/web/src/components/landing/Logo.tsx b/apps/web/src/components/landing/Logo.tsx
index b326b3fa6..83d5a8a89 100644
--- a/apps/web/src/components/landing/Logo.tsx
+++ b/apps/web/src/components/landing/Logo.tsx
@@ -64,7 +64,7 @@ export function Logo({ size = 36, withWordmark = false, className }: LogoProps)
{withWordmark && (
<span className="flex items-baseline gap-2 leading-none">
<span className="text-xl font-bold tracking-tight text-white">AiSOC</span>
- <span className="text-xs font-medium text-gray-500">by Cyble</span>
+ <span className="text-xs font-medium text-gray-500">open-source</span>
</span>
)}
</span>
diff --git a/apps/web/src/components/landing/OpenSource.tsx b/apps/web/src/components/landing/OpenSource.tsx
index 1891f7c23..8b90a65c9 100644
--- a/apps/web/src/components/landing/OpenSource.tsx
+++ b/apps/web/src/components/landing/OpenSource.tsx
@@ -17,8 +17,8 @@ const PILLARS = [
body: 'Every detection, every copilot decision, every connector action is logged with inputs, prompts, and rationale.',
},
{
- title: 'Backed by Cyble',
- body: 'Maintained by the threat intelligence team at Cyble. Security disclosures get a fast, real, human response.',
+ title: 'Community-driven',
+ body: 'Maintained by SOC analysts, detection engineers, and threat hunters in the open. Security disclosures get a fast, real, human response.',
},
];
diff --git a/apps/web/src/components/layout/Sidebar.tsx b/apps/web/src/components/layout/Sidebar.tsx
index cf03be0af..20d29b64e 100644
--- a/apps/web/src/components/layout/Sidebar.tsx
+++ b/apps/web/src/components/layout/Sidebar.tsx
@@ -247,7 +247,7 @@ export function Sidebar() {
<div>
<span className="text-white font-bold text-base tracking-tight">Ai</span>
<span className="text-blue-400 font-bold text-base tracking-tight">SOC</span>
- <p className="text-xs text-gray-500 -mt-0.5">by Cyble</p>
+ <p className="text-xs text-gray-500 -mt-0.5">open-source</p>
</div>
{/* Live indicator */}
<div className="ml-auto flex items-center gap-1">
diff --git a/apps/web/src/components/marketplace/MarketplaceView.tsx b/apps/web/src/components/marketplace/MarketplaceView.tsx
index 49156a46e..c701d0af7 100644
--- a/apps/web/src/components/marketplace/MarketplaceView.tsx
+++ b/apps/web/src/components/marketplace/MarketplaceView.tsx
@@ -811,7 +811,7 @@ export function MarketplaceView() {
</select>
<a
- href="https://github.com/beenuar/aisoc/blob/main/CONTRIBUTING.md#community-marketplace"
+ href="https://github.com/beenuar/AiSOC/blob/main/CONTRIBUTING.md#community-marketplace"
target="_blank"
rel="noopener noreferrer"
className="ml-auto rounded-lg border border-blue-700/60 bg-blue-900/20 px-3 py-1.5 text-xs font-medium text-blue-300 hover:bg-blue-900/40"
diff --git a/apps/web/src/components/settings/SettingsView.tsx b/apps/web/src/components/settings/SettingsView.tsx
index b05cfe45e..11199844c 100644
--- a/apps/web/src/components/settings/SettingsView.tsx
+++ b/apps/web/src/components/settings/SettingsView.tsx
@@ -92,7 +92,7 @@ interface ProfileData {
const DEFAULT_PROFILE: ProfileData = {
displayName: 'Sasha Lin',
- email: '[email protected]',
+ email: '[email protected]',
title: 'Senior SOC Analyst',
timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC',
};
@@ -192,14 +192,14 @@ const DEMO_API_KEYS: ApiKey[] = [
const DEMO_AUDIT: AuditEntry[] = [
{
id: 'a-1',
- actor: '[email protected]',
+ actor: '[email protected]',
action: 'enabled',
target: 'Detection rule “Impossible Travel — Same User”',
at: ago(12),
},
{
id: 'a-2',
- actor: '[email protected]',
+ actor: '[email protected]',
action: 'rotated',
target: 'API key “CI / Detection-as-Code Pipeline”',
at: ago(60 * 6),
@@ -213,14 +213,14 @@ const DEMO_AUDIT: AuditEntry[] = [
},
{
id: 'a-4',
- actor: '[email protected]',
+ actor: '[email protected]',
action: 'invited',
- target: '[email protected] (analyst)',
+ target: '[email protected] (analyst)',
at: ago(60 * 24 * 1),
},
{
id: 'a-5',
- actor: '[email protected]',
+ actor: '[email protected]',
action: 'changed',
target: 'Workspace timezone to America/Los_Angeles',
at: ago(60 * 24 * 5),
@@ -628,7 +628,7 @@ function WorkspacePanel() {
description="Tenant identity and locale settings. Available to workspace administrators."
/>
<div className="grid gap-5 px-6 py-5 sm:grid-cols-2">
- <InfoTile label="Workspace name" value="Cyble — AiSOC Demo" />
+ <InfoTile label="Workspace name" value="AiSOC Demo" />
<InfoTile label="Tenant ID" value="tenant_demo_01H0XE4T2WJ9N6" mono />
<InfoTile label="Plan" value="Open-source (MIT)" />
<InfoTile label="Region" value="us-east-1 / Multi-AZ" />
@@ -645,11 +645,11 @@ function WorkspacePanel() {
</p>
<ul className="mt-3 divide-y divide-gray-800 rounded-lg border border-gray-800 bg-gray-950/40">
{[
- { name: 'Sasha Lin', email: '[email protected]', role: 'Admin' },
- { name: 'Avi Sharma', email: '[email protected]', role: 'Analyst' },
- { name: 'Diego Vega', email: '[email protected]', role: 'Analyst' },
- { name: 'Mia Ocampo', email: '[email protected]', role: 'Hunter' },
- { name: 'CI Service', email: '[email protected]', role: 'Service' },
+ { name: 'Sasha Lin', email: '[email protected]', role: 'Admin' },
+ { name: 'Avi Sharma', email: '[email protected]', role: 'Analyst' },
+ { name: 'Diego Vega', email: '[email protected]', role: 'Analyst' },
+ { name: 'Mia Ocampo', email: '[email protected]', role: 'Hunter' },
+ { name: 'CI Service', email: '[email protected]', role: 'Service' },
].map((m) => (
<li
key={m.email}
@@ -1322,32 +1322,32 @@ function AboutPanel() {
<div>
<PanelHeader
title="About AiSOC"
- description="Open-source SOC platform — by Cyble, MIT licensed."
+ description="Open-source SOC platform — community-built, MIT licensed."
/>
<div className="grid gap-4 px-6 py-5 sm:grid-cols-2">
- <InfoTile label="Version" value="v3.0.0-rc.1" />
+ <InfoTile label="Version" value="v5.2.0" />
<InfoTile label="Build" value="local • dev" />
<InfoTile label="License" value="MIT" />
- <InfoTile label="Source" value="github.com/cybeio/aisoc" mono />
+ <InfoTile label="Source" value="github.com/beenuar/AiSOC" mono />
</div>
<div className="border-t border-gray-800 px-6 py-5 text-sm text-gray-400">
<p>
AiSOC is community-driven. Issues, ideas, and PRs welcome on GitHub.
- For commercial deployment support, see{' '}
+ See the{' '}
<a
className="text-blue-400 hover:text-blue-300"
- href="https://cyble.com"
+ href="https://github.com/beenuar/AiSOC/blob/main/CONTRIBUTING.md"
target="_blank"
rel="noreferrer"
>
- cyble.com
- </a>
- .
+ contributing guide
+ </a>{' '}
+ to get started.
</p>
<div className="mt-4 flex flex-wrap gap-2">
<a
className="rounded-lg border border-gray-700 bg-gray-900 px-3 py-1.5 text-xs text-gray-200 hover:bg-gray-800"
- href="https://github.com/cybeio/aisoc"
+ href="https://github.com/beenuar/AiSOC"
target="_blank"
rel="noreferrer"
>
@@ -1355,7 +1355,7 @@ function AboutPanel() {
</a>
<a
className="rounded-lg border border-gray-700 bg-gray-900 px-3 py-1.5 text-xs text-gray-200 hover:bg-gray-800"
- href="https://github.com/cybeio/aisoc/blob/main/CHANGELOG.md"
+ href="https://github.com/beenuar/AiSOC/blob/main/CHANGELOG.md"
target="_blank"
rel="noreferrer"
>
@@ -1363,7 +1363,7 @@ function AboutPanel() {
</a>
<a
className="rounded-lg border border-gray-700 bg-gray-900 px-3 py-1.5 text-xs text-gray-200 hover:bg-gray-800"
- href="https://github.com/cybeio/aisoc/blob/main/SECURITY.md"
+ href="https://github.com/beenuar/AiSOC/blob/main/SECURITY.md"
target="_blank"
rel="noreferrer"
>
diff --git a/docker-compose.yml b/docker-compose.yml
index 3e60d72aa..368f94ad0 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,7 +1,7 @@
###############################################################################
# AiSOC - AI Security Operations Center
# Docker Compose - Full Development Stack
-# Open-source by Cyble under MIT License
+# AiSOC — open-source under MIT License
###############################################################################
version: '3.8'
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 1158ea0f1..7d951f9a1 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -2,11 +2,13 @@ openapi: 3.1.0
info:
title: AiSOC Platform API
description: |
- Open-source AI Security Operations Center by Cyble (v5.1.0).
+ Open-source AI Security Operations Center (v5.2.0).
Autonomous threat detection, investigation, and response — with UEBA behavioral
analytics, honeytoken deception, purple-team adversary emulation, enterprise RBAC,
- immutable audit logging, and SOC 2 / ISO 27001 / NIST CSF compliance dashboards.
+ immutable audit logging, the v5.2 Investigation Ledger (signed agent actions),
+ Ambient Copilot, Responder PWA, public evaluation harness, MCP server, and
+ SOC 2 / ISO 27001 / NIST CSF compliance dashboards.
## Authentication
Most endpoints require a JWT Bearer token obtained from `POST /api/v1/auth/login`.
@@ -19,11 +21,10 @@ info:
## Rate limiting
Default: 1000 req/min per API key; 100 req/min per user token.
Limits are surfaced via `X-RateLimit-*` response headers.
- version: 5.1.0
+ version: 5.2.0
contact:
name: AiSOC Community
- url: https://github.com/beenuar/AiSOC
+ url: https://github.com/beenuar/AiSOC/security/advisories/new
license:
name: MIT
url: https://opensource.org/licenses/MIT
diff --git a/infra/helm/aisoc/Chart.yaml b/infra/helm/aisoc/Chart.yaml
index 8400d1f92..edaceb7a8 100644
--- a/infra/helm/aisoc/Chart.yaml
+++ b/infra/helm/aisoc/Chart.yaml
@@ -1,9 +1,9 @@
apiVersion: v2
name: aisoc
-description: AiSOC - AI Security Operations Center by Cyble
+description: AiSOC - the open-source, AI-native Security Operations Center
type: application
-version: 1.0.0
-appVersion: "1.0.0"
+version: 5.2.0
+appVersion: "5.2.0"
keywords:
- security
@@ -11,14 +11,16 @@ keywords:
- ai
- siem
- soar
+ - xdr
+ - mitre-attack
home: https://github.com/beenuar/AiSOC
sources:
- https://github.com/beenuar/AiSOC
maintainers:
- - name: Cyble
+ - name: AiSOC Maintainers
+ url: https://github.com/beenuar/AiSOC
dependencies:
- name: postgresql
diff --git a/infra/terraform/main.tf b/infra/terraform/main.tf
index 5109240ce..9411cebce 100644
--- a/infra/terraform/main.tf
+++ b/infra/terraform/main.tf
@@ -1,7 +1,7 @@
/**
* AiSOC - AI Security Operations Center
* Terraform Infrastructure - Main Configuration
- * Open-source by Cyble under MIT License
+ * AiSOC — open-source under MIT License
*/
terraform {
@@ -43,7 +43,7 @@ provider "aws" {
Project = "AiSOC"
Environment = var.environment
ManagedBy = "Terraform"
- Owner = "Cyble"
+ Owner = "AiSOC"
}
}
}
diff --git a/marketplace/index.json b/marketplace/index.json
index 3b29e296d..f717aefb7 100644
--- a/marketplace/index.json
+++ b/marketplace/index.json
@@ -1,7 +1,7 @@
{
"$schema": "https://aisoc.dev/schemas/marketplace/v1.json",
"version": "1.0.0",
- "generated": "2026-05-04T08:01:43Z",
+ "generated": "2026-05-04T14:49:29Z",
"categories": [
{
"id": "playbooks",
@@ -5548,7 +5548,7 @@
],
"plugin_type": "action",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/cloudflare-waf",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/cloudflare-waf",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5575,7 +5575,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/datadog-incidents",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/datadog-incidents",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5602,7 +5602,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/github-audit",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/github-audit",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5629,7 +5629,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/gitlab-audit",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/gitlab-audit",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5656,7 +5656,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/jamf-mdm",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/jamf-mdm",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5683,7 +5683,7 @@
],
"plugin_type": "widget",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/mttr-widget",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/mttr-widget",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5710,7 +5710,7 @@
],
"plugin_type": "action",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/notion-incidents",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/notion-incidents",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5736,7 +5736,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/okta-connector",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/okta-connector",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5763,7 +5763,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/onepassword-events",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/onepassword-events",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5790,7 +5790,7 @@
],
"plugin_type": "action",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/pagerduty-paging",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/pagerduty-paging",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5816,7 +5816,7 @@
],
"plugin_type": "responder",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/slack-quarantine",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/slack-quarantine",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5844,7 +5844,7 @@
],
"plugin_type": "connector",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/snowflake-events",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/snowflake-events",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5871,7 +5871,7 @@
],
"plugin_type": "action",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/tailscale-acl",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/tailscale-acl",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5898,7 +5898,7 @@
],
"plugin_type": "action",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/twilio-sms",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/twilio-sms",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
@@ -5924,7 +5924,7 @@
],
"plugin_type": "enricher",
"license": "MIT",
- "homepage": "https://github.com/beenuar/aisoc/tree/main/plugins/yara-enricher",
+ "homepage": "https://github.com/beenuar/AiSOC/tree/main/plugins/yara-enricher",
"min_aisoc_version": "4.0.0",
"sdks": [
"python",
diff --git a/package.json b/package.json
index a76c84b98..e831e7dca 100644
--- a/package.json
+++ b/package.json
@@ -2,9 +2,9 @@
"name": "aisoc",
"version": "1.0.0",
"private": true,
- "description": "AiSOC - AI-powered Security Operations Center by Cyble",
+ "description": "AiSOC — Open-source AI-powered Security Operations Center",
"license": "MIT",
- "author": "Cyble Inc.",
+ "author": "AiSOC contributors",
"workspaces": [
"apps/*",
"packages/*"
diff --git a/packages/sdk-go/go.mod b/packages/sdk-go/go.mod
index fa1a6b56c..0bcce3b06 100644
--- a/packages/sdk-go/go.mod
+++ b/packages/sdk-go/go.mod
@@ -1,4 +1,4 @@
-module github.com/aisoc-os/aisoc/sdk-go
+module github.com/beenuar/aisoc/sdk-go
go 1.22
diff --git a/packages/sdk-py/README.md b/packages/sdk-py/README.md
index c0392b04d..db4e5c619 100644
--- a/packages/sdk-py/README.md
+++ b/packages/sdk-py/README.md
@@ -3,7 +3,7 @@
[![PyPI version](https://img.shields.io/pypi/v/aisoc-sdk)](https://pypi.org/project/aisoc-sdk/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
-Async Python client SDK for [AiSOC](https://github.com/aisoc-os/aisoc).
+Async Python client SDK for [AiSOC](https://github.com/beenuar/AiSOC).
## Installation
diff --git a/packages/sdk-py/pyproject.toml b/packages/sdk-py/pyproject.toml
index 6dedd496c..581354673 100644
--- a/packages/sdk-py/pyproject.toml
+++ b/packages/sdk-py/pyproject.toml
@@ -26,10 +26,10 @@ dev = [
]
[project.urls]
-Homepage = "https://github.com/aisoc-os/aisoc"
-Documentation = "https://aisoc-os.github.io/aisoc"
-Repository = "https://github.com/aisoc-os/aisoc"
-Issues = "https://github.com/aisoc-os/aisoc/issues"
+Homepage = "https://github.com/beenuar/AiSOC"
+Documentation = "https://beenuar.github.io/AiSOC"
+Repository = "https://github.com/beenuar/AiSOC"
+Issues = "https://github.com/beenuar/AiSOC/issues"
[tool.hatch.build.targets.wheel]
packages = ["src/aisoc_sdk"]
diff --git a/packages/sdk-ts/README.md b/packages/sdk-ts/README.md
index b41196554..e0ffb4a15 100644
--- a/packages/sdk-ts/README.md
+++ b/packages/sdk-ts/README.md
@@ -3,7 +3,7 @@
[![npm version](https://img.shields.io/npm/v/@aisoc/sdk)](https://www.npmjs.com/package/@aisoc/sdk)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
-TypeScript client SDK for [AiSOC](https://github.com/aisoc-os/aisoc) — auto-generated types from `docs/openapi.yaml`, hand-crafted ergonomic API.
+TypeScript client SDK for [AiSOC](https://github.com/beenuar/AiSOC) — auto-generated types from `docs/openapi.yaml`, hand-crafted ergonomic API.
## Installation
diff --git a/packages/types/src/index.ts b/packages/types/src/index.ts
index 33f64f3a3..62bee1aeb 100644
--- a/packages/types/src/index.ts
+++ b/packages/types/src/index.ts
@@ -1,7 +1,7 @@
/**
* AiSOC Shared Types - Main Entry Point
*
- * Open-source AI Security Operations Center platform by Cyble
+ * AiSOC — open-source AI Security Operations Center platform
* MIT License
*/
diff --git a/packages/ui/src/index.ts b/packages/ui/src/index.ts
index d10c67245..4093395dd 100644
--- a/packages/ui/src/index.ts
+++ b/packages/ui/src/index.ts
@@ -1,6 +1,6 @@
/**
* @aisoc/ui - AiSOC React UI Component Library
- * Open-source AI Security Operations Center by Cyble
+ * AiSOC — open-source AI Security Operations Center
* MIT License
*/
diff --git a/plugins/cloudflare-waf/plugin.yaml b/plugins/cloudflare-waf/plugin.yaml
index 54d24d885..4c18978f2 100644
--- a/plugins/cloudflare-waf/plugin.yaml
+++ b/plugins/cloudflare-waf/plugin.yaml
@@ -9,7 +9,7 @@ description: >
stuffing, and bot-attack playbooks.
author: AiSOC Core Team
tags: [network, cloudflare, waf, response, ddos]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/cloudflare-waf
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/cloudflare-waf
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/datadog-incidents/plugin.yaml b/plugins/datadog-incidents/plugin.yaml
index a2c8d4bcf..138c4e1d3 100644
--- a/plugins/datadog-incidents/plugin.yaml
+++ b/plugins/datadog-incidents/plugin.yaml
@@ -8,7 +8,7 @@ description: >
API so AiSOC can mirror infra alerts and security findings side-by-side.
author: AiSOC Core Team
tags: [observability, datadog, incidents, signals, connector]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/datadog-incidents
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/datadog-incidents
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/github-audit/plugin.yaml b/plugins/github-audit/plugin.yaml
index 5c9a4fec2..87136d179 100644
--- a/plugins/github-audit/plugin.yaml
+++ b/plugins/github-audit/plugin.yaml
@@ -8,7 +8,7 @@ description: >
investigations. Backed by the GitHub Audit Log API.
author: AiSOC Core Team
tags: [vcs, github, audit, identity, supply-chain]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/github-audit
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/github-audit
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/gitlab-audit/plugin.yaml b/plugins/gitlab-audit/plugin.yaml
index 24859c81c..d9af34ca6 100644
--- a/plugins/gitlab-audit/plugin.yaml
+++ b/plugins/gitlab-audit/plugin.yaml
@@ -9,7 +9,7 @@ description: >
GitHub and GitLab from a single SOC.
author: AiSOC Core Team
tags: [identity, gitlab, audit, devsecops, connector]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/gitlab-audit
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/gitlab-audit
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/jamf-mdm/plugin.yaml b/plugins/jamf-mdm/plugin.yaml
index 786047153..60e284341 100644
--- a/plugins/jamf-mdm/plugin.yaml
+++ b/plugins/jamf-mdm/plugin.yaml
@@ -9,7 +9,7 @@ description: >
Jamf Pro Classic and Pro REST APIs.
author: AiSOC Core Team
tags: [mdm, jamf, endpoint, apple, identity]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/jamf-mdm
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/jamf-mdm
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/mttr-widget/plugin.yaml b/plugins/mttr-widget/plugin.yaml
index 1d9b2077d..45a1d318d 100644
--- a/plugins/mttr-widget/plugin.yaml
+++ b/plugins/mttr-widget/plugin.yaml
@@ -8,7 +8,7 @@ description: >
structured data ready for the AiSOC dashboard widget renderer.
author: AiSOC Core Team
tags: [metrics, mttr, mttd, dashboard, widget]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/mttr-widget
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/mttr-widget
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/notion-incidents/plugin.yaml b/plugins/notion-incidents/plugin.yaml
index 0d8a7807a..0ba6fd025 100644
--- a/plugins/notion-incidents/plugin.yaml
+++ b/plugins/notion-incidents/plugin.yaml
@@ -8,7 +8,7 @@ description: >
back to the AiSOC case. Useful for runbook archives and post-mortems.
author: AiSOC Core Team
tags: [collaboration, notion, incidents, postmortem, action]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/notion-incidents
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/notion-incidents
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/okta-connector/plugin.yaml b/plugins/okta-connector/plugin.yaml
index 02fbdde20..1228ef709 100644
--- a/plugins/okta-connector/plugin.yaml
+++ b/plugins/okta-connector/plugin.yaml
@@ -8,7 +8,7 @@ description: >
active sessions for a given user — all via the Okta Management API.
author: AiSOC Core Team
tags: [identity, okta, iam, sso]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/okta-connector
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/okta-connector
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/onepassword-events/plugin.yaml b/plugins/onepassword-events/plugin.yaml
index 559f7bf95..fde10c180 100644
--- a/plugins/onepassword-events/plugin.yaml
+++ b/plugins/onepassword-events/plugin.yaml
@@ -8,7 +8,7 @@ description: >
theft, anomalous access patterns, and insider misuse of privileged secrets.
author: AiSOC Core Team
tags: [identity, secrets, 1password, events, connector]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/onepassword-events
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/onepassword-events
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/pagerduty-paging/plugin.yaml b/plugins/pagerduty-paging/plugin.yaml
index 3eac04ccc..bd1310e15 100644
--- a/plugins/pagerduty-paging/plugin.yaml
+++ b/plugins/pagerduty-paging/plugin.yaml
@@ -8,7 +8,7 @@ description: >
service/escalation lookups.
author: AiSOC Core Team
tags: [paging, pagerduty, oncall, incidents, action]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/pagerduty-paging
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/pagerduty-paging
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/slack-quarantine/plugin.yaml b/plugins/slack-quarantine/plugin.yaml
index f3f26d1f8..cb2526b38 100644
--- a/plugins/slack-quarantine/plugin.yaml
+++ b/plugins/slack-quarantine/plugin.yaml
@@ -9,7 +9,7 @@ description: >
thread-based updates as the incident evolves.
author: AiSOC Core Team
tags: [slack, notification, quarantine, response]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/slack-quarantine
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/slack-quarantine
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/snowflake-events/plugin.yaml b/plugins/snowflake-events/plugin.yaml
index 6f912a4f4..bd21c8a29 100644
--- a/plugins/snowflake-events/plugin.yaml
+++ b/plugins/snowflake-events/plugin.yaml
@@ -8,7 +8,7 @@ description: >
access from unexpected regions or service accounts.
author: AiSOC Core Team
tags: [data, snowflake, warehouse, events, connector, exfil]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/snowflake-events
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/snowflake-events
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/tailscale-acl/plugin.yaml b/plugins/tailscale-acl/plugin.yaml
index e382b8a13..d977d6f65 100644
--- a/plugins/tailscale-acl/plugin.yaml
+++ b/plugins/tailscale-acl/plugin.yaml
@@ -9,7 +9,7 @@ description: >
playbooks.
author: AiSOC Core Team
tags: [network, tailscale, zerotrust, response, isolation]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/tailscale-acl
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/tailscale-acl
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/twilio-sms/plugin.yaml b/plugins/twilio-sms/plugin.yaml
index 76edd025e..04e32672d 100644
--- a/plugins/twilio-sms/plugin.yaml
+++ b/plugins/twilio-sms/plugin.yaml
@@ -8,7 +8,7 @@ description: >
or chat are unavailable.
author: AiSOC Core Team
tags: [notification, sms, twilio, paging, action]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/twilio-sms
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/twilio-sms
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/plugins/yara-enricher/plugin.yaml b/plugins/yara-enricher/plugin.yaml
index 2e230b382..1662c5f05 100644
--- a/plugins/yara-enricher/plugin.yaml
+++ b/plugins/yara-enricher/plugin.yaml
@@ -8,7 +8,7 @@ description: >
so analysts can quickly triage malware indicators.
author: AiSOC Core Team
tags: [malware, yara, file-analysis, enrichment]
-homepage: https://github.com/beenuar/aisoc/tree/main/plugins/yara-enricher
+homepage: https://github.com/beenuar/AiSOC/tree/main/plugins/yara-enricher
license: MIT
min_aisoc_version: "4.0.0"
config_schema:
diff --git a/schemas/playbook.schema.json b/schemas/playbook.schema.json
index b0e652f89..8ccfed06e 100644
--- a/schemas/playbook.schema.json
+++ b/schemas/playbook.schema.json
@@ -1,6 +1,6 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
- "$id": "https://github.com/cyble-dev/aisoc/schemas/playbook.schema.json",
+ "$id": "https://github.com/beenuar/AiSOC/schemas/playbook.schema.json",
"title": "AiSOC Playbook",
"description": "Schema for AiSOC v4 Pillar-2 playbook definitions.",
"type": "object",
diff --git a/scripts/export_openapi.py b/scripts/export_openapi.py
index a5c7f6375..92d8dc347 100755
--- a/scripts/export_openapi.py
+++ b/scripts/export_openapi.py
@@ -12,7 +12,7 @@ Usage
The script imports the FastAPI application directly (no running server needed)
and calls ``app.openapi()`` to get the schema, then serialises it to YAML.
-MIT License — Cyble Open-Source AiSOC
+MIT License — AiSOC (open-source AI Security Operations Center)
"""
from __future__ import annotations
diff --git a/services/actions/pyproject.toml b/services/actions/pyproject.toml
index bc72c0c02..46cd832d8 100644
--- a/services/actions/pyproject.toml
+++ b/services/actions/pyproject.toml
@@ -2,7 +2,7 @@
name = "aisoc-actions"
version = "0.1.0"
description = "AiSOC Action Execution Service - blast-radius gated response actions with rollback"
-authors = ["Cyble <[email protected]>"]
+authors = ["AiSOC contributors <[email protected]>"]
license = "MIT"
[tool.poetry.dependencies]
diff --git a/services/agents/app/tools/mitre_full.py b/services/agents/app/tools/mitre_full.py
index 67061a9b9..81f82ca15 100644
--- a/services/agents/app/tools/mitre_full.py
+++ b/services/agents/app/tools/mitre_full.py
@@ -10,7 +10,7 @@ On startup, this module:
3. Builds in-memory indexes for O(1) lookups.
4. Optionally embeds technique descriptions into Qdrant for semantic RAG.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/agents/pyproject.toml b/services/agents/pyproject.toml
index 05e3f52d7..a1149aae9 100644
--- a/services/agents/pyproject.toml
+++ b/services/agents/pyproject.toml
@@ -2,7 +2,7 @@
name = "aisoc-agents"
version = "0.1.0"
description = "AiSOC AI Agent Orchestrator - LangGraph-based autonomous investigation and response"
-authors = ["Cyble <[email protected]>"]
+authors = ["AiSOC contributors <[email protected]>"]
license = "MIT"
[tool.poetry.dependencies]
diff --git a/services/api/app/api/v1/endpoints/api_keys.py b/services/api/app/api/v1/endpoints/api_keys.py
index e5166e3fa..05bdecff7 100644
--- a/services/api/app/api/v1/endpoints/api_keys.py
+++ b/services/api/app/api/v1/endpoints/api_keys.py
@@ -19,7 +19,7 @@ VALID SCOPES
reports:read reports:write
* (all permissions — admin only)
-MIT License — Cyble Open-Source AiSOC
+MIT License — AiSOC (open-source AI Security Operations Center)
"""
from __future__ import annotations
diff --git a/services/api/app/api/v1/endpoints/graph.py b/services/api/app/api/v1/endpoints/graph.py
index c9dd3c5ea..d54c59af6 100644
--- a/services/api/app/api/v1/endpoints/graph.py
+++ b/services/api/app/api/v1/endpoints/graph.py
@@ -1,6 +1,6 @@
"""
Graph API endpoints: attack paths, blast radius, entity neighbors, MITRE coverage.
-Cyble Open-Source AI Security Operations Center - MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/api/app/api/v1/endpoints/plugins.py b/services/api/app/api/v1/endpoints/plugins.py
index 026c19dcf..b4f2115db 100644
--- a/services/api/app/api/v1/endpoints/plugins.py
+++ b/services/api/app/api/v1/endpoints/plugins.py
@@ -10,7 +10,7 @@ DELETE /plugins/{plugin_id} – unload (does not delete from disk)
POST /plugins/{plugin_id}/run – invoke plugin directly (enricher/action)
POST /plugins/discover – re-scan AISOC_PLUGINS_DIR
-MIT License — Cyble Open-Source AiSOC
+MIT License — AiSOC (open-source AI Security Operations Center)
"""
from __future__ import annotations
diff --git a/services/api/app/core/config.py b/services/api/app/core/config.py
index 9a5239454..3b5fa9bbb 100644
--- a/services/api/app/core/config.py
+++ b/services/api/app/core/config.py
@@ -1,6 +1,6 @@
"""
AiSOC API Configuration
-Cyble Open-Source AI Security Operations Center
+AiSOC — open-source AI Security Operations Center
MIT License
"""
from functools import lru_cache
diff --git a/services/api/app/db/neo4j.py b/services/api/app/db/neo4j.py
index 733ebae3c..55afd0f3e 100644
--- a/services/api/app/db/neo4j.py
+++ b/services/api/app/db/neo4j.py
@@ -1,6 +1,6 @@
"""
Neo4j driver singleton for AiSOC graph layer.
-Cyble Open-Source AI Security Operations Center - MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/api/app/main.py b/services/api/app/main.py
index a3d4b467f..c860088fc 100644
--- a/services/api/app/main.py
+++ b/services/api/app/main.py
@@ -80,7 +80,7 @@ def create_application() -> FastAPI:
app = FastAPI(
title="AiSOC Platform API",
description=(
- "Open-source AI Security Operations Center by Cyble. "
+ "AiSOC — open-source AI Security Operations Center. "
"Autonomous threat detection, investigation, and response."
),
version=settings.VERSION,
diff --git a/services/api/app/middleware/demo_mode.py b/services/api/app/middleware/demo_mode.py
index 11e001560..4bd87fb25 100644
--- a/services/api/app/middleware/demo_mode.py
+++ b/services/api/app/middleware/demo_mode.py
@@ -101,9 +101,9 @@ class DemoModeMiddleware(BaseHTTPMiddleware):
"This is the public AiSOC demo at demo.aisoc.dev. "
"Write actions are disabled here so every visitor sees "
"the same dataset. To run AiSOC for real, self-host it "
- "in 5 minutes — see https://github.com/cyble/AiSOC."
+ "in 5 minutes — see https://github.com/beenuar/AiSOC."
),
- "self_host_url": "https://github.com/cyble/AiSOC#quickstart",
+ "self_host_url": "https://github.com/beenuar/AiSOC#quickstart",
"blocked_path": path,
"blocked_method": method,
},
diff --git a/services/api/app/services/graph_service.py b/services/api/app/services/graph_service.py
index 2d7049c24..7c701f80c 100644
--- a/services/api/app/services/graph_service.py
+++ b/services/api/app/services/graph_service.py
@@ -1,6 +1,6 @@
"""
Graph service: entity node management, attack-path queries, blast-radius traversal.
-Cyble Open-Source AI Security Operations Center - MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/api/app/services/plugin_manager.py b/services/api/app/services/plugin_manager.py
index 35c598ccf..6c606d6ad 100644
--- a/services/api/app/services/plugin_manager.py
+++ b/services/api/app/services/plugin_manager.py
@@ -17,7 +17,7 @@ OCI image support (oras pull):
Pass an OCI reference to install_from_oci() — the manager pulls the image
layer via the ORAS CLI (must be installed) and extracts it into PLUGINS_DIR.
-MIT License — Cyble Open-Source AiSOC
+MIT License — AiSOC (open-source AI Security Operations Center)
"""
from __future__ import annotations
diff --git a/services/api/app/services/rule_engine.py b/services/api/app/services/rule_engine.py
index 0c4bfbba3..d2363d83f 100644
--- a/services/api/app/services/rule_engine.py
+++ b/services/api/app/services/rule_engine.py
@@ -1,7 +1,7 @@
"""
Detection rule execution engine.
Supports: Sigma (pySigma), YARA, KQL (simulated), EQL (simulated).
-Cyble Open-Source AI Security Operations Center - MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/api/pyproject.toml b/services/api/pyproject.toml
index 2707a2c76..b63f32b7d 100644
--- a/services/api/pyproject.toml
+++ b/services/api/pyproject.toml
@@ -1,8 +1,8 @@
[tool.poetry]
name = "aisoc-api"
version = "0.1.0"
-description = "AiSOC Core API Service - Open-source AI Security Operations Center by Cyble"
-authors = ["Cyble <[email protected]>"]
+description = "AiSOC Core API Service — Open-source AI Security Operations Center"
+authors = ["AiSOC contributors <[email protected]>"]
license = "MIT"
readme = "README.md"
diff --git a/services/api/tests/test_plugin_manager.py b/services/api/tests/test_plugin_manager.py
index d7df01a73..5553c07dc 100644
--- a/services/api/tests/test_plugin_manager.py
+++ b/services/api/tests/test_plugin_manager.py
@@ -4,7 +4,7 @@ Unit tests for app.services.plugin_manager
These tests run without any external services; they exercise the
PluginManager against temporary on-disk plugin fixtures.
-MIT License — Cyble Open-Source AiSOC
+MIT License — AiSOC (open-source AI Security Operations Center)
"""
from __future__ import annotations
diff --git a/services/connectors/pyproject.toml b/services/connectors/pyproject.toml
index 51d758018..659c27749 100644
--- a/services/connectors/pyproject.toml
+++ b/services/connectors/pyproject.toml
@@ -2,7 +2,7 @@
name = "aisoc-connectors"
version = "0.1.0"
description = "AiSOC Security Source Connectors"
-authors = ["Cyble <[email protected]>"]
+authors = ["AiSOC contributors <[email protected]>"]
license = "MIT"
[tool.poetry.dependencies]
diff --git a/services/demo-producer/main.go b/services/demo-producer/main.go
index 55e85ecc0..71670fceb 100644
--- a/services/demo-producer/main.go
+++ b/services/demo-producer/main.go
@@ -14,7 +14,7 @@
//
// `--rate` is events per second per connector. `--duration 0` runs forever.
//
-// Part of the Cyble AiSOC platform (MIT License).
+// Part of the AiSOC platform (MIT License).
package main
import (
diff --git a/services/fusion/app/services/ml_scorer.py b/services/fusion/app/services/ml_scorer.py
index d074c0e2d..ecf05bb96 100644
--- a/services/fusion/app/services/ml_scorer.py
+++ b/services/fusion/app/services/ml_scorer.py
@@ -11,7 +11,7 @@ Priority score — LightGBM ranker trained on analyst feedback signals
Both models are held in memory and retrained on demand when enough
feedback accumulates. They fall back to heuristics if not yet trained.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/fusion/pyproject.toml b/services/fusion/pyproject.toml
index 9747b2f00..5f58b0cea 100644
--- a/services/fusion/pyproject.toml
+++ b/services/fusion/pyproject.toml
@@ -2,7 +2,7 @@
name = "aisoc-fusion"
version = "0.1.0"
description = "AiSOC Alert Fusion Service - deduplication, correlation and incident grouping"
-authors = ["Cyble <[email protected]>"]
+authors = ["AiSOC contributors <[email protected]>"]
license = "MIT"
readme = "README.md"
diff --git a/services/ingest/internal/enrichment/shodan.go b/services/ingest/internal/enrichment/shodan.go
index b9576c2ec..4cb3b1f17 100644
--- a/services/ingest/internal/enrichment/shodan.go
+++ b/services/ingest/internal/enrichment/shodan.go
@@ -4,7 +4,7 @@
// caches results in an in-process TTL cache (Redis can be wired later),
// and augments OCSF events with exposure metadata (open ports, CVEs, ASN).
//
-// Cyble Open-Source AI Security Operations Center — MIT License
+// AiSOC — open-source AI Security Operations Center (MIT License)
package enrichment
import (
diff --git a/services/ingest/internal/enrichment/vuln.go b/services/ingest/internal/enrichment/vuln.go
index 45340c522..dcf3a6eeb 100644
--- a/services/ingest/internal/enrichment/vuln.go
+++ b/services/ingest/internal/enrichment/vuln.go
@@ -4,7 +4,7 @@
// the CISA Known Exploited Vulnerabilities catalogue and emits structured
// VulnMatch objects for each hit.
//
-// Cyble Open-Source AI Security Operations Center — MIT License
+// AiSOC — open-source AI Security Operations Center (MIT License)
package enrichment
import (
diff --git a/services/ingest/main.go b/services/ingest/main.go
index 6d364f370..e37eb56d7 100644
--- a/services/ingest/main.go
+++ b/services/ingest/main.go
@@ -1,6 +1,6 @@
// AiSOC Ingest Service
// Handles raw event ingestion, OCSF normalization, ATT&CK mapping, and Kafka publishing
-// Part of the Cyble AiSOC platform (MIT License)
+// Part of the AiSOC platform (MIT License)
package main
import (
diff --git a/services/mcp/package.json b/services/mcp/package.json
index 7fd021aba..74dd66cef 100644
--- a/services/mcp/package.json
+++ b/services/mcp/package.json
@@ -14,7 +14,7 @@
"siem"
],
"license": "MIT",
- "author": "Cyble Inc.",
+ "author": "AiSOC contributors",
"homepage": "https://github.com/beenuar/AiSOC/tree/main/services/mcp",
"repository": {
"type": "git",
diff --git a/services/threatintel/app/clients/cisa_kev.py b/services/threatintel/app/clients/cisa_kev.py
index 8f3ed32ad..6c95c2bab 100644
--- a/services/threatintel/app/clients/cisa_kev.py
+++ b/services/threatintel/app/clients/cisa_kev.py
@@ -1,7 +1,7 @@
"""
CISA Known Exploited Vulnerabilities (KEV) catalog client.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/clients/misp.py b/services/threatintel/app/clients/misp.py
index e99a6bd76..b310a3c0f 100644
--- a/services/threatintel/app/clients/misp.py
+++ b/services/threatintel/app/clients/misp.py
@@ -1,7 +1,7 @@
"""
MISP client for fetching threat intelligence events and attributes.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/clients/otx.py b/services/threatintel/app/clients/otx.py
index 774e1f87f..d4786e528 100644
--- a/services/threatintel/app/clients/otx.py
+++ b/services/threatintel/app/clients/otx.py
@@ -1,7 +1,7 @@
"""
AlienVault OTX (Open Threat Exchange) client.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/clients/taxii.py b/services/threatintel/app/clients/taxii.py
index 0cf57fdaa..fccb88f79 100644
--- a/services/threatintel/app/clients/taxii.py
+++ b/services/threatintel/app/clients/taxii.py
@@ -1,7 +1,7 @@
"""
TAXII 2.1 client for fetching STIX bundles from threat intelligence feeds.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/feeds/handlers.py b/services/threatintel/app/feeds/handlers.py
index 769382cf9..a59be2c7e 100644
--- a/services/threatintel/app/feeds/handlers.py
+++ b/services/threatintel/app/feeds/handlers.py
@@ -5,7 +5,7 @@ Each handler is registered with the FeedScheduler and invoked on
its configured polling interval. Handlers fetch from their source,
parse/normalize the data, and hand off to ThreatIntelPipeline.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/feeds/pipeline.py b/services/threatintel/app/feeds/pipeline.py
index d9fcf7389..93502c0b0 100644
--- a/services/threatintel/app/feeds/pipeline.py
+++ b/services/threatintel/app/feeds/pipeline.py
@@ -8,7 +8,7 @@ Handles the full lifecycle for each normalized IOC/actor batch:
4. Neo4j graph merge
5. Kafka event emission (optional)
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/feeds/scheduler.py b/services/threatintel/app/feeds/scheduler.py
index 5edf5f73d..936c9cfc2 100644
--- a/services/threatintel/app/feeds/scheduler.py
+++ b/services/threatintel/app/feeds/scheduler.py
@@ -4,7 +4,7 @@ APScheduler-based feed polling orchestrator.
Coordinates TAXII, MISP, OTX, and CISA KEV polling intervals and
pipes normalized IOCs through the deduplication + storage pipeline.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/main.py b/services/threatintel/app/main.py
index 6665af536..1627b0000 100644
--- a/services/threatintel/app/main.py
+++ b/services/threatintel/app/main.py
@@ -5,7 +5,7 @@ Polls multiple threat intelligence feeds on configurable intervals,
deduplicates via Redis Bloom filter, and writes normalized IOCs/actors
into OpenSearch, Qdrant, and Neo4j.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/parsers/stix.py b/services/threatintel/app/parsers/stix.py
index 4d4056d78..898c0f3d8 100644
--- a/services/threatintel/app/parsers/stix.py
+++ b/services/threatintel/app/parsers/stix.py
@@ -1,7 +1,7 @@
"""
STIX 2.1 object parser — converts STIX objects to normalized IOC/actor dicts.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/storage/bloom.py b/services/threatintel/app/storage/bloom.py
index 8c66097f1..5d4277fb3 100644
--- a/services/threatintel/app/storage/bloom.py
+++ b/services/threatintel/app/storage/bloom.py
@@ -5,7 +5,7 @@ Uses a counting Bloom filter approach with multiple hash functions to
minimize false positives while allowing existence checks before
expensive storage writes.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/storage/neo4j.py b/services/threatintel/app/storage/neo4j.py
index 2bf7bb24b..b7d5065ac 100644
--- a/services/threatintel/app/storage/neo4j.py
+++ b/services/threatintel/app/storage/neo4j.py
@@ -4,7 +4,7 @@ Neo4j storage layer for threat intelligence relationships.
Writes IOC nodes, actor nodes, and their relationships into the
knowledge graph for attack path and blast-radius queries.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/storage/opensearch.py b/services/threatintel/app/storage/opensearch.py
index 7d7716ca8..07890e4cd 100644
--- a/services/threatintel/app/storage/opensearch.py
+++ b/services/threatintel/app/storage/opensearch.py
@@ -1,7 +1,7 @@
"""
OpenSearch storage layer for threat intelligence IOCs and actors.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/app/storage/qdrant.py b/services/threatintel/app/storage/qdrant.py
index 163ee9f51..e488c98dd 100644
--- a/services/threatintel/app/storage/qdrant.py
+++ b/services/threatintel/app/storage/qdrant.py
@@ -1,7 +1,7 @@
"""
Qdrant vector storage for semantic threat intelligence search.
-Cyble Open-Source AI Security Operations Center — MIT License
+AiSOC — open-source AI Security Operations Center (MIT License)
"""
from __future__ import annotations
diff --git a/services/threatintel/pyproject.toml b/services/threatintel/pyproject.toml
index ca22103e5..18bb3a310 100644
--- a/services/threatintel/pyproject.toml
+++ b/services/threatintel/pyproject.toml
@@ -2,7 +2,7 @@
name = "aisoc-threatintel"
version = "0.1.0"
description = "AiSOC Threat Intelligence Feed Service — TAXII/STIX/MISP/OTX ingestion"
-authors = ["Cyble <[email protected]>"]
+authors = ["AiSOC contributors <[email protected]>"]
license = "MIT"
[tool.poetry.dependencies]