# infisical/infisical architecture

> Architecture diagram of the GitHub repository infisical/infisical, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/infisical/infisical
- Repository: https://github.com/infisical/infisical

## Overview

Infisical is a security infrastructure platform for managing secrets, certificates, keys, privileged access, and AI-agent access. A user-facing request enters the backend API, where authentication and project permissions govern access to platform capabilities and their state. The tree and README support the major product areas, but most domain implementations and their wiring were not sampled; those subsystem links are therefore shown as unverified rather than asserted calls. The sampled code does confirm alert dispatch, certificate enrollment dependencies, and PAM recording backend selection.

Main entry points: [`backend/src/server/routes/v1`](https://github.com/infisical/infisical/tree/main/backend/src/server/routes/v1) (HTTP API), [`backend/src/domains/agent-vault`](https://github.com/infisical/infisical/tree/main/backend/src/domains/agent-vault) (AI agent access), [`backend/src/domains/pam`](https://github.com/infisical/infisical/tree/main/backend/src/domains/pam) (Privileged access), [`backend/src/ee/services/pam-session-recording/pam-recording-storage-factory.ts`](https://github.com/infisical/infisical/blob/main/backend/src/ee/services/pam-session-recording/pam-recording-storage-factory.ts) (Session recording)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Request entry"]
  node_api["HTTP API"]
  node_goapi["Go platform API<br/>[platform_routes.go]"]
end

subgraph group_security["Secrets and access"]
  node_login["Authentication"]
  node_identity["Workload identity"]
  node_secrets["Secrets management"]
  node_agentvault["AI agent access"]
  node_pam["Privileged access"]
  node_recording["Session recording"]
  node_kms["Key management"]
end

subgraph group_pki["Certificate management"]
  node_ca["Certificate authorities"]
  node_enrollment["Certificate enrollment"]
  node_certmanager["Certificate lifecycle<br/>[service.ts]"]
end

subgraph group_operations["Platform services"]
  node_alerts["Alert dispatch<br/>[alert-engine.ts]"]
  node_appconnections["App connections"]
  node_objectstorage["Object storage"]
end

subgraph group_foundation["Internal foundation"]
  node_database[("Application data")]
  node_queue["Background jobs<br/>[jobs.ts]"]
end

node_user(("Platform user"))

node_user -.->|"sends requests"| node_api
node_api -.->|"authenticates"| node_login
node_api -.->|"manages secrets"| node_secrets
node_api -.->|"manages agent access"| node_agentvault
node_api -.->|"manages privileged access"| node_pam
node_pam -.->|"records sessions"| node_recording
node_api -.->|"manages keys"| node_kms
node_api -.->|"manages authorities"| node_ca
node_api -.->|"enrolls certificates"| node_enrollment
node_enrollment -->|"resolves CA type"| node_ca
node_api -.->|"manages lifecycle"| node_certmanager
node_api -.->|"configures alerts"| node_alerts
node_alerts -.->|"resolves recipients"| node_appconnections
node_api -.->|"configures integrations"| node_appconnections
node_agentvault -->|"checks default storage"| node_objectstorage
node_recording -.->|"stores recordings"| node_objectstorage
node_api -.->|"persists state"| node_database
node_api -.->|"schedules work"| node_queue
node_user -.->|"sends requests"| node_goapi

click node_api "https://github.com/infisical/infisical/tree/main/backend/src/server/routes/v1"
click node_login "https://github.com/infisical/infisical/blob/main/backend/src/services/auth/auth-login-service.ts"
click node_identity "https://github.com/infisical/infisical/blob/main/backend/src/services/identity-kubernetes-auth/identity-kubernetes-auth-service.ts"
click node_secrets "https://github.com/infisical/infisical/tree/main/backend/src/domains"
click node_agentvault "https://github.com/infisical/infisical/tree/main/backend/src/domains/agent-vault"
click node_pam "https://github.com/infisical/infisical/tree/main/backend/src/domains/pam"
click node_recording "https://github.com/infisical/infisical/blob/main/backend/src/ee/services/pam-session-recording/pam-recording-storage-factory.ts"
click node_kms "https://github.com/infisical/infisical/tree/main/backend/src/services/kms"
click node_ca "https://github.com/infisical/infisical/blob/main/backend/src/services/certificate-authority/certificate-authority-service.ts"
click node_enrollment "https://github.com/infisical/infisical/blob/main/backend/src/services/pki-application/pki-application-enrollment-service.ts"
click node_certmanager "https://github.com/infisical/infisical/blob/main/backend/src/domains/certificates/cert-manager/ce/services/cert-manager/service.ts"
click node_alerts "https://github.com/infisical/infisical/blob/main/backend/src/services/alert/alert-engine.ts"
click node_appconnections "https://github.com/infisical/infisical/tree/main/backend/src/services/app-connection"
click node_objectstorage "https://github.com/infisical/infisical/blob/main/backend/src/services/object-storage/object-storage-service.ts"
click node_database "https://github.com/infisical/infisical/tree/main/backend/src/db"
click node_queue "https://github.com/infisical/infisical/blob/main/backend/src/domains/lib/jobs/jobs.ts"
click node_goapi "https://github.com/infisical/infisical/blob/main/backend-go/internal/server/api/platform_routes.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api,node_goapi,node_user toneBlue
class node_login,node_identity,node_secrets,node_agentvault,node_pam,node_recording,node_kms toneAmber
class node_ca,node_enrollment,node_certmanager toneMint
class node_alerts,node_appconnections,node_objectstorage toneRose
class node_database,node_queue toneIndigo
```

## Components

### Request entry

- [HTTP API](https://github.com/infisical/infisical/tree/main/backend/src/server/routes/v1): `backend/src/server/routes/v1`
- [Go platform API](https://github.com/infisical/infisical/blob/main/backend-go/internal/server/api/platform_routes.go): `backend-go/internal/server/api/platform_routes.go`

### Secrets and access

- [Authentication](https://github.com/infisical/infisical/blob/main/backend/src/services/auth/auth-login-service.ts): `backend/src/services/auth/auth-login-service.ts`
- [Workload identity](https://github.com/infisical/infisical/blob/main/backend/src/services/identity-kubernetes-auth/identity-kubernetes-auth-service.ts): `backend/src/services/identity-kubernetes-auth/identity-kubernetes-auth-service.ts`
- [Secrets management](https://github.com/infisical/infisical/tree/main/backend/src/domains): `backend/src/domains`
- [AI agent access](https://github.com/infisical/infisical/tree/main/backend/src/domains/agent-vault): `backend/src/domains/agent-vault`
- [Privileged access](https://github.com/infisical/infisical/tree/main/backend/src/domains/pam): `backend/src/domains/pam`
- [Session recording](https://github.com/infisical/infisical/blob/main/backend/src/ee/services/pam-session-recording/pam-recording-storage-factory.ts): `backend/src/ee/services/pam-session-recording/pam-recording-storage-factory.ts`
- [Key management](https://github.com/infisical/infisical/tree/main/backend/src/services/kms): `backend/src/services/kms`

### Certificate management

- [Certificate authorities](https://github.com/infisical/infisical/blob/main/backend/src/services/certificate-authority/certificate-authority-service.ts): `backend/src/services/certificate-authority/certificate-authority-service.ts`
- [Certificate enrollment](https://github.com/infisical/infisical/blob/main/backend/src/services/pki-application/pki-application-enrollment-service.ts): `backend/src/services/pki-application/pki-application-enrollment-service.ts`
- [Certificate lifecycle](https://github.com/infisical/infisical/blob/main/backend/src/domains/certificates/cert-manager/ce/services/cert-manager/service.ts): `backend/src/domains/certificates/cert-manager/ce/services/cert-manager/service.ts`

### Platform services

- [Alert dispatch](https://github.com/infisical/infisical/blob/main/backend/src/services/alert/alert-engine.ts): `backend/src/services/alert/alert-engine.ts`
- [App connections](https://github.com/infisical/infisical/tree/main/backend/src/services/app-connection): `backend/src/services/app-connection`
- [Object storage](https://github.com/infisical/infisical/blob/main/backend/src/services/object-storage/object-storage-service.ts): `backend/src/services/object-storage/object-storage-service.ts`

### Internal foundation

- [Application data](https://github.com/infisical/infisical/tree/main/backend/src/db): `backend/src/db`
- [Background jobs](https://github.com/infisical/infisical/blob/main/backend/src/domains/lib/jobs/jobs.ts): `backend/src/domains/lib/jobs/jobs.ts`

### Other components

- **Platform user**

## Connections

- Platform user → HTTP API: sends requests
- HTTP API → Authentication: authenticates
- HTTP API → Secrets management: manages secrets (evidence: `README.md`)
- HTTP API → AI agent access: manages agent access (evidence: `README.md`)
- HTTP API → Privileged access: manages privileged access (evidence: `README.md`)
- Privileged access → Session recording: records sessions
- HTTP API → Key management: manages keys (evidence: `README.md`)
- HTTP API → Certificate authorities: manages authorities (evidence: `README.md`)
- HTTP API → Certificate enrollment: enrolls certificates (evidence: `README.md`)
- Certificate enrollment → Certificate authorities: resolves CA type (evidence: `backend/src/services/pki-application/pki-application-enrollment-service.ts`)
- HTTP API → Certificate lifecycle: manages lifecycle (evidence: `README.md`)
- HTTP API → Alert dispatch: configures alerts (evidence: `README.md`)
- Alert dispatch → App connections: resolves recipients
- HTTP API → App connections: configures integrations (evidence: `README.md`)
- AI agent access → Object storage: checks default storage
- Session recording → Object storage: stores recordings
- HTTP API → Application data: persists state
- HTTP API → Background jobs: schedules work
- Platform user → Go platform API: sends requests
