How apple/security-pcc works
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: PrivateInformationRetrievalClient.swift PIR Client · CloudAttestationProvider.swift Attestation Provider · ShadowTunnelCloudController.swift Shadow Controller · CloudAttestationWorkerValidation.swift Worker Validation
Components 21
Request Processing
- PIR Client
CloudBoard/Sources/CloudBoardJob Framework/CloudBoardJobCore/PrivateInformationRetrievalClient.swift - Pipeline Payload
CloudBoard/Sources/CloudBoardJobHelperCore/Request Handling/PipelinePayload.swift - Worker Query
CloudBoard/Sources/CloudBoardDomain/FindWorkerQuery.swift - Session Storage
CloudBoard/Sources/CloudBoardDCore/SessionStorage.swift
Attestation Security
- Attestation API
CloudBoard/Sources/CloudBoardAttestationDAPI/CloudBoardAttestation.swift - Attestation Provider
CloudBoard/Sources/CloudBoardAttestationDCore/CloudAttestationProvider.swift - Worker Validation
CloudBoard/Sources/CloudBoardAttestationDCore/WorkerValidation/CloudAttestationWorkerValidation.swift - Policy Evaluation
CloudAttestation/CloudAttestation/Policy/PolicyBuilder.swift - Attestation Cache
CloudBoard/Sources/CloudBoardAttestationDCore/AttestationBundleCache.swift - Secure Configuration
CloudAttestation/CloudAttestation/SecureConfig.swift
Platform Operations
- Lifecycle Manager
CloudBoard/Sources/CloudBoardPlatformUtilities/LifecycleManager.swift - Cryptex Manager
darwinOSBits/DarwinInit/Models/CryptexManager.swift - Shadow Controller
CloudBoard/Sources/ShadowTunnelCloudController/ShadowTunnelCloudController.swift
Event Monitoring
- Event Pipeline
EventHorizon/EventHorizon/Sources/EventHorizon/EHPipeline.swift - Alert Engine
EventHorizon/EventHorizon/Sources/EventHorizon/Transforms/Classifiers/AlertEngine.swift - PCC Alert Rules
EventHorizon/EventHorizon/Sources/EventHorizon/Transforms/Classifiers/Rules/AlertEngineLibrary+PCC.swift
System Integration
- Mesh Framework
AppleCIOMesh/MeshNetFramework/MeshNetFramework.swift - Ensemble Service
AppleComputeEnsembler/ensembled/EnsemblerService.swift
Other components
- PCC Client
- PCC Worker
- Cloud Controller
Connections 15
- 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