# aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws architecture

> Architecture diagram of the GitHub repository aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws
- Repository: https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws

## Overview

##### Project type and purpose
- This is a full-stack, serverless-first + containerized demo that:
- Uses AWS CDK (TypeScript) to deploy nested CloudFormation stacks
- Host a React/TypeScript webapp via AWS Amplify (or S3+CloudFront)
- Exposes C2PA CLI workloads packaged in Docker containers via two options:
– AWS Fargate service
– AWS Lambda function
- Provides a GraphQL API (AppSync) with Cognito authentication

##### File structure
- packages/infra
- NestedStacks/Amplify → front-end hosting
- NestedStacks/AppSync (+ uiLambdaMiddleware) → GraphQL API & Lambda resolvers
- NestedStacks/Authentication → Cognito UserPool & IdentityPool
- NestedStacks/C2pa/Fargate → ECS Fargate service running C2PA CLI
- NestedStacks/C2pa/Lambda → Lambda container function running C2PA CLI
- NestedStacks/C2pa/SecretsManager → X.509 certs & keys storage
- NestedStacks/Network & Storage → VPC, subnets, S3 buckets
- packages/webapp
- React/Vite SPA, GraphQL queries/mutations, Amplify config
- Auth and API wrapper code under src/api
- Pages for media & fMP4 asset management using C2PA
- Root
- pnpm workspace config, GitHub Actions workflows, CDK bootstrap/deploy scripts

##### Extract key insights from the README
- Two C2PA processing pipelines (Fargate vs. Lambda) wrap the CLI in Docker and expose REST endpoints
- Webapp uses Cognito to log in, then calls AppSync GraphQL to orchestrate uploads & processing
- SecretsManager stores the digital certificate & private key used by the C2PA tool
- AWS CDK synthesizes and deploys the entire infra; outputs are used by the webapp

a. Local Developer / CI/CD
- GitHub Actions / local pnpm & CDK CLI
b. Frontend Hosting
- AWS Amplify (or S3 + CloudFront)
- React SPA in users’ browsers
c. Authentication & API
- AWS Cognito (User Pool & Identity Pool)
- AWS AppSync (GraphQL endpoint)
- Lambda “uiLambdaMiddleware” for custom resolver logic
d. C2PA Processing
- AWS Fargate service running Docker-packaged C2PA CLI
- AWS Lambda function (container image) running the same tool
e. Data & Secrets
- S3 buckets for asset uploads & manifest storage
- AWS SecretsManager for C2PA cert & key
f. Networking
- VPC, subnets, ALB (for Fargate)
g. IaC Layer
- AWS CDK Nested Stacks grouping all resources

##### Relationships and interactions
1. User’s browser → Amplify/CloudFront → React SPA
2. SPA → Cognito (auth flows)
3. SPA → AppSync GraphQL API (queries, mutations)
4. AppSync resolvers → Lambda “uiLambdaMiddleware”
5. Middleware → either Fargate API or Lambda function to run C2PA CLI
6. Processing container/function:
- Retrieves cert/key from SecretsManager
- Reads/writes media & sidecar files in S3
- Returns signed manifest
7. SPA displays results & may call additional AppSync operations

##### Architectural patterns & design principles
- Serverless-first: Cognito, AppSync, Lambda
- Containerized microservice: C2PA CLI on Fargate & in Lambda
- IaC modularity: CDK nested stacks for clear separation
- Monorepo with pnpm workspace for infra and webapp

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Local Dev & CI/CD
    subgraph "Local Dev & CI/CD"
        GH["GitHub Actions"]:::iac
        DEVCLI["pnpm & CDK CLI"]:::iac
        InfraBin["packages/infra/bin/infra.ts\n(CDK bootstrap/deploy)"]:::iac
        GH --> DEVCLI
        DEVCLI --> InfraBin
    end

    %% IaC / CloudFormation
    subgraph "IaC / CloudFormation"
        C2PAStack["packages/infra/lib/c2pa-stack.ts\n(CDK Entry Point)"]:::iac
        InfraBin --> C2PAStack
    end

    %% AWS Cloud
    subgraph "AWS Cloud"
        %% Frontend Hosting
        subgraph "Frontend Hosting"
            Amplify["AWS Amplify / S3+CloudFront"]:::hosting
            subgraph "Webapp Code"
                Entry["main.tsx & index.html"]:::client
                AwsConfig["aws-config.ts"]:::client
                ApiWrapper["api.tsx, atoms.ts, utils.ts"]:::client
                GraphQLCode["queries.ts & mutations.ts"]:::client
                CommonUI["common UI components"]:::client
                PagesMedia["MediaManager pages"]:::client
                PagesFMP4["Fmp4Manager pages"]:::client
                BuildSpec["buildspec.yml"]:::iac
            end
            Amplify --> Entry
        end

        %% Auth & API
        subgraph "Authentication & API"
            Cognito["Cognito UserPool & IdentityPool"]:::api
            AppSync["AppSync GraphQL API"]:::api
            Middleware["uiLambdaMiddleware\nLambda Resolver"]:::compute
            C2PAStack --> Cognito
            C2PAStack --> AppSync
        end

        %% C2PA Processing Pipelines
        subgraph "C2PA Processing Pipelines"
            subgraph "Fargate Pipeline"
                ALB["ALB"]:::network
                Fargate["Fargate Service"]:::compute
                DFargate["Docker Code\n(main.py, utils.py, requirements.txt)"]:::compute
                C2PAStack --> Fargate
                Fargate --> DFargate
                ALB --> Fargate
            end
            subgraph "Lambda Pipeline"
                Lambda["Lambda Container Function"]:::compute
                DLambda["Lambda Code\n(index.py, utils.py, c2patool-v0.9.12-linux.tar.gz, requirements.txt)"]:::compute
                C2PAStack --> Lambda
                Lambda --> DLambda
            end
        end

        %% Data & Secrets
        subgraph "Data & Secrets"
            S3["S3 Buckets\n(Assets & Manifests)"]:::storage
            Secrets["SecretsManager\n(Certs & Keys)"]:::storage
            C2PAStack --> S3
            C2PAStack --> Secrets
        end

        %% Networking
        subgraph "Networking"
            VPC["VPC & Subnets"]:::network
            C2PAStack --> VPC
        end
    end

    %% Client interactions
    Entry -->|loads SPA| Amplify
    Amplify -->|serves SPA| Entry
    Entry -->|auth flows| Cognito
    Entry -->|GraphQL operations| AppSync
    AppSync -->|resolver request| Middleware
    Middleware -->|REST call| ALB
    Middleware -->|invoke| Lambda
    Fargate -->|retrieves cert| Secrets
    Lambda -->|retrieves cert| Secrets
    Fargate -->|read/write| S3
    Lambda -->|read/write| S3

    %% CDK deploy to AWS
    C2PAStack -->|deploys infra| Amplify
    C2PAStack -->|deploys infra| Cognito
    C2PAStack -->|deploys infra| AppSync
    C2PAStack -->|deploys infra| Fargate
    C2PAStack -->|deploys infra| Lambda
    C2PAStack -->|deploys infra| S3
    C2PAStack -->|deploys infra| Secrets
    C2PAStack -->|deploys infra| VPC

    %% Click Events
    click InfraBin "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/bin/infra.ts"
    click C2PAStack "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/lib/c2pa-stack.ts"
    click Amplify "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/lib/NestedStacks/Amplify/Amplify.ts"
    click AppSync "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/lib/NestedStacks/AppSync/AppSync.ts"
    click Middleware "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/lib/NestedStacks/AppSync/uiLambdaMiddleware/index.ts"
    click Cognito "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/lib/NestedStacks/Authentication/Authentication.ts"
    click Fargate "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/lib/NestedStacks/C2pa/Fargate/Fargate.ts"
    click DFargate "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/tree/main/packages/infra/lib/NestedStacks/C2pa/Fargate/code/Dockerfile"
    click Lambda "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/lib/NestedStacks/C2pa/Lambda/Lambda.ts"
    click DLambda "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/tree/main/packages/infra/lib/NestedStacks/C2pa/Lambda/code/Dockerfile"
    click Secrets "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/lib/NestedStacks/C2pa/SecretsManager/SecretsManager.ts"
    click VPC "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/lib/NestedStacks/Network/Network.ts"
    click S3 "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/infra/lib/NestedStacks/Storage/Storage.ts"
    click Entry "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/webapp/src/main.tsx"
    click AwsConfig "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/webapp/src/aws-config.ts"
    click ApiWrapper "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/webapp/src/api/api.tsx"
    click GraphQLCode "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/webapp/src/graphql/queries.ts"
    click CommonUI "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/tree/main/packages/webapp/src/common"
    click PagesMedia "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/tree/main/packages/webapp/src/pages/MediaManager"
    click PagesFMP4 "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/tree/main/packages/webapp/src/pages/Fmp4Manager"
    click GH "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/.github/workflows/maintainer_workflows.yml"
    click BuildSpec "https://github.com/aws-solutions-library-samples/guidance-for-media-provenance-with-c2pa-on-aws/blob/main/packages/webapp/buildspec.yml"

    %% Styles
    classDef client fill:#cce5ff,stroke:#3399ff,color:#000;
    classDef hosting fill:#e6ffe6,stroke:#33cc33,color:#000;
    classDef api fill:#fff4e6,stroke:#ff9933,color:#000;
    classDef compute fill:#f2e6ff,stroke:#9933ff,color:#000;
    classDef storage fill:#ffffcc,stroke:#cccc33,color:#000;
    classDef network fill:#ffe6cc,stroke:#ff6633,color:#000;
    classDef iac fill:#e0e0e0,stroke:#888888,color:#000;
```
