# apple/security-pcc architecture

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

- Interactive diagram: https://gitdiagram.com/apple/security-pcc
- Repository: https://github.com/apple/security-pcc

## Overview

Private Cloud Compute (PCC) implements privacy-preserving cloud workloads with worker discovery, private information retrieval, attestation, policy enforcement, and operational controls. The principal flow is a client request entering the job/PIR layer, reaching a worker, and producing a response after worker and platform security checks. The tree also exposes event alerting, cryptex handling, lifecycle management, and shadow-tunnel control. Several links remain intentionally omitted because sampled excerpts are partial and do not establish their runtime wiring.

Main entry points: [`CloudBoard/Sources/CloudBoardJob Framework/CloudBoardJobCore/PrivateInformationRetrievalClient.swift`](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardJob%20Framework/CloudBoardJobCore/PrivateInformationRetrievalClient.swift) (PIR Client), [`CloudBoard/Sources/CloudBoardAttestationDCore/CloudAttestationProvider.swift`](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardAttestationDCore/CloudAttestationProvider.swift) (Attestation Provider), [`CloudBoard/Sources/ShadowTunnelCloudController/ShadowTunnelCloudController.swift`](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/ShadowTunnelCloudController/ShadowTunnelCloudController.swift) (Shadow Controller), [`CloudBoard/Sources/CloudBoardAttestationDCore/WorkerValidation/CloudAttestationWorkerValidation.swift`](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardAttestationDCore/WorkerValidation/CloudAttestationWorkerValidation.swift) (Worker Validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_request["Request Processing"]
  node_pir["PIR Client"]
  node_pipeline_payload["Pipeline Payload"]
  node_worker_query["Worker Query"]
  node_session_storage[("Session Storage")]
end

subgraph group_security["Attestation Security"]
  node_attestation_api["Attestation API"]
  node_attestation_provider["Attestation Provider"]
  node_worker_validation["Worker Validation"]
  node_policy_builder["Policy Evaluation"]
  node_attestation_cache[("Attestation Cache")]
  node_secure_config["Secure Configuration<br/>[SecureConfig.swift]"]
end

subgraph group_operations["Platform Operations"]
  node_lifecycle["Lifecycle Manager"]
  node_cryptex["Cryptex Manager"]
  node_shadow_controller["Shadow Controller"]
end

subgraph group_monitoring["Event Monitoring"]
  node_event_pipeline["Event Pipeline<br/>[EHPipeline.swift]"]
  node_alert_engine["Alert Engine<br/>[AlertEngine.swift]"]
  node_pcc_rules["PCC Alert Rules"]
end

subgraph group_integration["System Integration"]
  node_mesh_framework["Mesh Framework"]
  node_ensemble_service["Ensemble Service"]
end

node_client(("PCC Client"))
node_worker(("PCC Worker"))
node_cloud_controller(("Cloud Controller"))

node_client -->|"submits request"| node_pir
node_pir -->|"builds payload"| node_pipeline_payload
node_pir -->|"finds worker"| node_worker_query
node_pir -->|"requests PIR"| node_worker
node_pir -->|"stores session"| node_session_storage
node_attestation_api -->|"requests attestation"| node_attestation_provider
node_attestation_provider -->|"validates worker"| node_worker_validation
node_worker_validation -->|"applies policies"| node_policy_builder
node_attestation_provider -->|"reads cache"| node_attestation_cache
node_shadow_controller -.->|"controls tunnel"| node_cloud_controller
node_shadow_controller -->|"uses configuration"| node_secure_config
node_event_pipeline -->|"runs transform"| node_alert_engine
node_alert_engine -->|"loads rules"| node_pcc_rules
node_lifecycle -->|"manages service"| node_event_pipeline
node_ensemble_service -.->|"uses mesh"| node_mesh_framework

click node_pir "https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardJob%20Framework/CloudBoardJobCore/PrivateInformationRetrievalClient.swift"
click node_pipeline_payload "https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardJobHelperCore/Request%20Handling/PipelinePayload.swift"
click node_worker_query "https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardDomain/FindWorkerQuery.swift"
click node_session_storage "https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardDCore/SessionStorage.swift"
click node_attestation_api "https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardAttestationDAPI/CloudBoardAttestation.swift"
click node_attestation_provider "https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardAttestationDCore/CloudAttestationProvider.swift"
click node_worker_validation "https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardAttestationDCore/WorkerValidation/CloudAttestationWorkerValidation.swift"
click node_policy_builder "https://github.com/apple/security-pcc/blob/main/CloudAttestation/CloudAttestation/Policy/PolicyBuilder.swift"
click node_attestation_cache "https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardAttestationDCore/AttestationBundleCache.swift"
click node_secure_config "https://github.com/apple/security-pcc/blob/main/CloudAttestation/CloudAttestation/SecureConfig.swift"
click node_lifecycle "https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardPlatformUtilities/LifecycleManager.swift"
click node_cryptex "https://github.com/apple/security-pcc/blob/main/darwinOSBits/DarwinInit/Models/CryptexManager.swift"
click node_shadow_controller "https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/ShadowTunnelCloudController/ShadowTunnelCloudController.swift"
click node_event_pipeline "https://github.com/apple/security-pcc/blob/main/EventHorizon/EventHorizon/Sources/EventHorizon/EHPipeline.swift"
click node_alert_engine "https://github.com/apple/security-pcc/blob/main/EventHorizon/EventHorizon/Sources/EventHorizon/Transforms/Classifiers/AlertEngine.swift"
click node_pcc_rules "https://github.com/apple/security-pcc/blob/main/EventHorizon/EventHorizon/Sources/EventHorizon/Transforms/Classifiers/Rules/AlertEngineLibrary%2BPCC.swift"
click node_mesh_framework "https://github.com/apple/security-pcc/blob/main/AppleCIOMesh/MeshNetFramework/MeshNetFramework.swift"
click node_ensemble_service "https://github.com/apple/security-pcc/blob/main/AppleComputeEnsembler/ensembled/EnsemblerService.swift"

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_pir,node_pipeline_payload,node_worker_query,node_session_storage,node_client toneBlue
class node_attestation_api,node_attestation_provider,node_worker_validation,node_policy_builder,node_attestation_cache,node_secure_config toneAmber
class node_lifecycle,node_cryptex,node_shadow_controller toneMint
class node_event_pipeline,node_alert_engine,node_pcc_rules,node_worker toneRose
class node_mesh_framework,node_ensemble_service,node_cloud_controller toneIndigo
```

## Components

### Request Processing

- [PIR Client](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardJob%20Framework/CloudBoardJobCore/PrivateInformationRetrievalClient.swift): `CloudBoard/Sources/CloudBoardJob Framework/CloudBoardJobCore/PrivateInformationRetrievalClient.swift`
- [Pipeline Payload](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardJobHelperCore/Request%20Handling/PipelinePayload.swift): `CloudBoard/Sources/CloudBoardJobHelperCore/Request Handling/PipelinePayload.swift`
- [Worker Query](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardDomain/FindWorkerQuery.swift): `CloudBoard/Sources/CloudBoardDomain/FindWorkerQuery.swift`
- [Session Storage](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardDCore/SessionStorage.swift): `CloudBoard/Sources/CloudBoardDCore/SessionStorage.swift`

### Attestation Security

- [Attestation API](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardAttestationDAPI/CloudBoardAttestation.swift): `CloudBoard/Sources/CloudBoardAttestationDAPI/CloudBoardAttestation.swift`
- [Attestation Provider](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardAttestationDCore/CloudAttestationProvider.swift): `CloudBoard/Sources/CloudBoardAttestationDCore/CloudAttestationProvider.swift`
- [Worker Validation](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardAttestationDCore/WorkerValidation/CloudAttestationWorkerValidation.swift): `CloudBoard/Sources/CloudBoardAttestationDCore/WorkerValidation/CloudAttestationWorkerValidation.swift`
- [Policy Evaluation](https://github.com/apple/security-pcc/blob/main/CloudAttestation/CloudAttestation/Policy/PolicyBuilder.swift): `CloudAttestation/CloudAttestation/Policy/PolicyBuilder.swift`
- [Attestation Cache](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardAttestationDCore/AttestationBundleCache.swift): `CloudBoard/Sources/CloudBoardAttestationDCore/AttestationBundleCache.swift`
- [Secure Configuration](https://github.com/apple/security-pcc/blob/main/CloudAttestation/CloudAttestation/SecureConfig.swift): `CloudAttestation/CloudAttestation/SecureConfig.swift`

### Platform Operations

- [Lifecycle Manager](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/CloudBoardPlatformUtilities/LifecycleManager.swift): `CloudBoard/Sources/CloudBoardPlatformUtilities/LifecycleManager.swift`
- [Cryptex Manager](https://github.com/apple/security-pcc/blob/main/darwinOSBits/DarwinInit/Models/CryptexManager.swift): `darwinOSBits/DarwinInit/Models/CryptexManager.swift`
- [Shadow Controller](https://github.com/apple/security-pcc/blob/main/CloudBoard/Sources/ShadowTunnelCloudController/ShadowTunnelCloudController.swift): `CloudBoard/Sources/ShadowTunnelCloudController/ShadowTunnelCloudController.swift`

### Event Monitoring

- [Event Pipeline](https://github.com/apple/security-pcc/blob/main/EventHorizon/EventHorizon/Sources/EventHorizon/EHPipeline.swift): `EventHorizon/EventHorizon/Sources/EventHorizon/EHPipeline.swift`
- [Alert Engine](https://github.com/apple/security-pcc/blob/main/EventHorizon/EventHorizon/Sources/EventHorizon/Transforms/Classifiers/AlertEngine.swift): `EventHorizon/EventHorizon/Sources/EventHorizon/Transforms/Classifiers/AlertEngine.swift`
- [PCC Alert Rules](https://github.com/apple/security-pcc/blob/main/EventHorizon/EventHorizon/Sources/EventHorizon/Transforms/Classifiers/Rules/AlertEngineLibrary%2BPCC.swift): `EventHorizon/EventHorizon/Sources/EventHorizon/Transforms/Classifiers/Rules/AlertEngineLibrary+PCC.swift`

### System Integration

- [Mesh Framework](https://github.com/apple/security-pcc/blob/main/AppleCIOMesh/MeshNetFramework/MeshNetFramework.swift): `AppleCIOMesh/MeshNetFramework/MeshNetFramework.swift`
- [Ensemble Service](https://github.com/apple/security-pcc/blob/main/AppleComputeEnsembler/ensembled/EnsemblerService.swift): `AppleComputeEnsembler/ensembled/EnsemblerService.swift`

### Other components

- **PCC Client**
- **PCC Worker**
- **Cloud Controller**

## Connections

- PCC Client → PIR Client: submits request
- PIR Client → Pipeline Payload: builds payload
- PIR Client → Worker Query: finds worker
- PIR Client → PCC Worker: requests PIR
- PIR Client → Session Storage: stores session
- Attestation API → Attestation Provider: requests attestation
- Attestation Provider → Worker Validation: validates worker
- Worker Validation → Policy Evaluation: applies policies
- Attestation Provider → Attestation Cache: reads cache
- Shadow Controller → Cloud Controller: controls tunnel
- Shadow Controller → Secure Configuration: uses configuration
- Event Pipeline → Alert Engine: runs transform
- Alert Engine → PCC Alert Rules: loads rules
- Lifecycle Manager → Event Pipeline: manages service
- Ensemble Service → Mesh Framework: uses mesh
