SSL Provenance API

Introduktion

Fokuser på din kerneforslag. Vi håndterer C2PA og CAWG. SSL Provenance API er et fuldt administreret REST API fra SSL. Det opretter, underskriver og redigerer C2PA manifester (indholdsoplysninger) for dine billeder, video og lyd i et enkelt API-kald. Det kan også vedhæfte en CAWG identitetsbekræftelse og dine egne brugerdefinerede bekræftelser. Underskrift bruger dine SSL.com eSigner-legitimationsoplysninger. Private nøgler forbliver sikre i SSL's HSM'er, og hver underskrift er tidsstemplet af SSL's kompatible C2PA Timestamp Authority.

Quick Start

Signer en JPEG og gem resultatet:
curl -X POST https://mss.ssl.com/v1/c2pa/sign \ -H "Godkendelse: Bærer " \ -H "C2PA-Certifikat-Id: 983da863-ce7f-42b5-b227-c9076c7b34af" \ -H "Indholdstype: billede/jpeg" \ --data-binær @foto.jpg \ --output signed_photo.jpg
signed_photo.jpg er dit originale billede med et signeret C2PA-manifest indlejret.

Basis-URL

https://mss.ssl.com
Alle slutpunkter er versioneret under /v1/c2pa/.

Godkendelse

Hver underskriftsanmodning kræver to værdier fra din SSL.com eSigner-konto:
Værdi Header Beskrivelse
Adgangstoken Authorization: Bearer <access_token> Din eSigner API-adgangstoken. Den giver API'en tilladelse til at bruge dine underskriftsoplysninger på dine vegne.
Legitimations-id C2PA-Certificate-Id: <credential_id> ID'et for den eSigner-legitimationsoplysninger (certifikat og nøgle), der blev brugt til at underskrive C2PA-kravet.
Signeringsalgoritmen kommer fra legitimationsoplysningernes nøgle. Understøttede algoritmer er ES256, ES384, ES512 (ECDSA) og PS256, PS384, PS512 (RSA-PSS).

Registrering af en ansøgning om et eSigner-adgangstoken

Adgangstokens udstedes til en applikation, du registrerer med SSL.com's eSigner CSC API. Registreringen tager cirka 15 minutter:
  1. Log ind. Gå til login.ssl.com og log ind med din SSL.com-konto.
  2. Åbn Administrer programmer. Vælg Administrer applikationer menuen ved at klikke på persona-ikonet øverst til højre.
  3. Opret applikationen. Klik Opret applikation.
  4. Udfyld formularen, og klik derefter på Indsend detaljer:
    • Ansøgning navn: et unikt navn til din applikation.
    • Omdirigerings-URI'er: Applikationer, der integrerer med eSigner på nettet, skal bruge en gyldig omdirigerings-URI tilbage til din server. Denne URI vil ikke blive brugt til Provenance API'en, men den er påkrævet. Du er velkommen til at tilføje, hvad du vil.
    • Fortrolig: Markér dette felt, hvis din applikation kører på en server og kan gemme hemmeligheden sikkert. Lad det være umarkeret for klientsideapplikationer, f.eks. native mobil- eller browserapps.
    • Scopes: indtaste service.
  5. Gem dine legitimationsoplysninger. Du har nu en Ansøgnings-id og en AnsøgningshemmelighedBrug dem til at anmode om adgangstokens fra eSigner CSC API'en.
For skærmbilleder og flere detaljer, se Registrer en ansøgning med eSigners CSC API.
Hold din applikation hemmelig. Integrer den aldrig i klientsidekode, og lad den aldrig blive committet til kildekodekontrol.

Hvad API'en tilføjer til dit aktiv

Hver vellykket signeringsanmodning tilføjer et nyt, signeret manifest til aktivet. Manifestet indeholder:
  • Kravgenerator: SSL Provenance API medmindre du anmoder om dit eget C2PA-kravsigneringscertifikat (kræver C2PA-overholdelse, kontakt os for yderligere information).
  • A c2pa.opened handling: registrerer, at aktivet blev åbnet og signeret af SSL Provenance API'en.
  • En moderingrediens: refererer til aktivet, som det blev modtaget, inklusive dets hash, så det signerede output kan spores tilbage til inputtet.
  • Et miniaturebillede af aktivet, for formater hvor en kan genereres.
  • Et pålideligt tidsstempel (RFC 3161) på kravsignaturen fra SSL.com's C2PA Timestamp Authority.
  • Valgfrit: a CAWG-identitetspåstand og op til 16 brugerdefinerede påstande.
Alle disse er registreret som oprettet påstande, hvilket betyder, at underskriveren tager ansvar for dem.

Aktiver, der allerede har indholdslegitimationsoplysninger

Hvis det uploadede aktiv allerede har et C2PA-manifest, beholder API'en sin eksisterende oprindelse. Det nye manifest tilføjes til det eksisterende manifestlager, og det tidligere manifest linkes ind som den overordnede ingrediens. Aktivets fulde historik forbliver intakt og verificerbar. Eksisterende signaturer kontrolleres mod den officielle. C2PA-tillidsliste, så validatorer kan rapportere, om den tidligere underskriver var betroet.

Understøttede indholdstyper

Send en af ​​følgende MIME-typer til /v1/c2pa/signBrug anmodningens Content-Type overskrift til en rå kropEller asset del Content-Type en flerdelt anmodning.
Kategori Content-Type dannet
Billeder image/jpeg JPEG
image/png PNG
image/gif GIF
image/tiff TIFF
image/webp WebP
image/avif AVIF
image/heic HEIC
image/heif HEIF
image/jxl JPEG XL (se noter)
image/svg+xml SVG
image/dng DNG
image/x-adobe-dng Adobe DNG
Video video/mp4 MP4
video/quicktime QuickTime (MOV)
video/x-m4v M4V
video/avi AVI
video/msvideo AVI (MS)
video/x-msvideo AVI (x-ms)
Audio audio/mpeg MP3
audio/mp4 M4A
audio/flac FLAC
audio/wav WAV
audio/wave WAV
audio/x-wav WAV
audio/vnd.wave WAV
Parametre på MIME-typen, såsom ; charset=utf-8, ignoreres.

Endpoints

Sundhedstjek

GET /v1/c2pa/sundhed
Returnerer servicestatus. Ingen godkendelse kræves. Respons
Status Content-Type Fylde
200 OK application/json {"status":"ok"}
Eksempel
krøller https://mss.ssl.com/v1/c2pa/health

Signer aktiv

POST /v1/c2pa/sign
Signerer aktivet og returnerer det med et integreret C2PA-manifest. Dette slutpunkt accepterer to anmodningsformater, valgt af anmodningens Content-Type:
dannet Anmod om Content-Type Brug det når
Rå krop Aktivets egen MIME-type, f.eks. image/jpeg Du behøver kun standardsignering, med eller uden en CAWG-identitetspåstand.
Flerdelt formular multipart/form-data Du vil også gerne indlejre brugerdefinerede påstande.
Begge formater understøtter alle funktioner undtagen brugerdefinerede assertions, som kræver flerdelte. Anmod om overskrifter
Header påkrævet Beskrivelse
Authorization Ja Bearer <access_token>din eSigner-adgangstoken
C2PA-Certificate-Id Ja eSigner-legitimations-ID, der bruges til at underskrive C2PA-kravet. Hvis du bruger SSL Provenance API-certifikatet, er legitimations-ID'et: 983da863-ce7f-42b5-b227-c9076c7b34af
Content-Type Ja Rå brødtekst: aktivets MIME-type (se Understøttede indholdstyper). Flerdelt: multipart/form-data; boundary=..., som de fleste HTTP-klienter sætter for dig.
CAWG-Certificate-Id Ingen eSigner-legitimations-ID, der bruges til at underskrive en CAWG-identitetspåstandHvis den er til stede, tilføjes identitetsbekræftelsen. Kan være den samme som C2PA-Certificate-Id.
CAWG-Role Ingen En eller flere navngivne skuespillerroller, Såsom cawg.creator, for identitetsbekræftelsen. Kræver CAWG-Certificate-IdFor at sende flere roller skal du gentage overskriften, adskille værdier med kommaer eller begge dele.

Mulighed A: Rå krop

Anmodningsteksten er aktivets bytes, op til 50 MB. Det Content-Type header angiver aktivets MIME-type.

Mulighed B: Flerdelte formulardata

Anmodningsteksten er multipart/form-data med disse dele, op til 50 MB i alt:
Del påkrævet Delindholdstype Beskrivelse
asset Ja Aktivets MIME-type, f.eks. image/jpeg Aktivets bytes. Denne dels Content-Type bestemmer, hvordan aktivet signeres, så den skal være indstillet. curl's -F "asset=@photo.jpg" udleder det fra filtypen. Mange andre klienter gør det ikke, så indstil det selv, for eksempel -F "asset=@photo.jpg;type=image/jpeg".
manifest_options Ingen application/json Et JSON-dokument, der tilpasser manifestet. Se Brugerdefinerede påstande.
manifest_options skema:
{ "custom_assertions": [ { "label": "com.example.my-assertion", "data": { "any": "json-objekt" } } ] }
Felt Type Beskrivelse
custom_assertions matrix Op til 16 brugerdefinerede påstande kan integreres. Send et array med ét element for at tilføje én påstand.
custom_assertions[].label streng Påkrævet. En unik etiket i omvendt domæne-notation. Se etiketregler.
custom_assertions[].data objekt Påkrævet. Ethvert JSON-objekt, op til 8 KB ved serialisering. Det integreres præcis som sendt.
Respons
Status Betingelse Content-Type Fylde
200 OK Succes Samme som aktivets Content-Type Det signerede aktiv med C2PA-manifestet integreret
4xx / 5xx Fejl application/json {"error":"<description>"}. Se fejl.

Eksempler

Signer et JPEG-billede med SSL Provenance API-kravsigneringscertifikatet:
curl -X POST https://mss.ssl.com/v1/c2pa/sign \ -H "Godkendelse: Bærer " \ -H "C2PA-Certifikat-Id: 983da863-ce7f-42b5-b227-c9076c7b34af" \ -H "Indholdstype: billede/jpeg" \ --data-binær @foto.jpg \ --output signed_photo.jpg
Signer en MP4-video:
curl -X POST https://mss.ssl.com/v1/c2pa/sign \ -H "Godkendelse: Bærer " \ -H "C2PA-Certifikat-ID: 983da863-ce7f-42b5-b227-c9076c7b34af" \ -H "Indholdstype: video/mp4" \ --data-binær @video.mp4 \ --output signed_video.mp4
Signer et JPEG XL-billede:
curl -X POST https://mss.ssl.com/v1/c2pa/sign \ -H "Godkendelse: Bærer " \ -H "C2PA-Certifikat-Id: 983da863-ce7f-42b5-b227-c9076c7b34af" \ -H "Indholdstype: image/jxl" \ --data-binary @image.jxl \ --output signed_image.jxl
Underskriv en JPEG og tilføj en CAWG-identitetspåstand, der navngiver skaberen:
curl -X POST https://mss.ssl.com/v1/c2pa/sign \ -H "Godkendelse: Bærer " \ -H "C2PA-Certifikat-Id: 983da863-ce7f-42b5-b227-c9076c7b34af" \ -H "CAWG-Certifikat-Id: " \ -H "CAWG-Rolle: cawg.creator" \ -H "Indholdstype: billede/jpeg" \ --data-binær @photo.jpg \ --output signed_photo.jpg
Signer en JPEG og integrer en brugerdefineret assertion (flerdelt):
curl -X POST https://mss.ssl.com/v1/c2pa/sign \ -H "Godkendelse: Bærer " \ -H "C2PA-Certifikat-Id: 983da863-ce7f-42b5-b227-c9076c7b34af" \ -F "asset=@photo.jpg;type=billede/jpeg" \ -F 'manifest_options={"custom_assertions":[{"label":"com.example.tracking","data":{"internal_id":"ACME-2026-004421"}}]};type=applikation/json' \ --output signed_photo.jpg
Kombiner dem alle: en CAWG-identitet med to roller plus to brugerdefinerede assertions:
curl -X POST https://mss.ssl.com/v1/c2pa/sign \ -H "Godkendelse: Bærer " \ -H "C2PA-Certifikat-Id: 983da863-ce7f-42b5-b227-c9076c7b34af" \ -H "CAWG-Certifikat-Id: " \ -H "CAWG-Rolle: cawg.creator,cawg.editor" \ -F "asset=@photo.jpg;type=billede/jpeg" \ -F 'manifest_options={"custom_assertions":[ {"label":"com.example.tracking","data":{"internal_id":"ACME-2026-004421"}}, {"label":"com.example.billing","data":{"account_ref":"AR-9001"}} ]};type=application/json' \ --output signed_photo.jpg

CAWG-identitetspåstande

A CAWG-identitetspåstand (cawg.identity) lader en navngiven aktør, såsom fotografen eller forfatteren, underskrive en erklæring, der binder deres identitet til aktivet. Dette er adskilt fra C2PA-kravsignaturen, som identificerer den organisation eller det værktøj, der producerede manifestet. For at tilføje et, skal du først tilføje dit eget CAWG-certifikat, kontakte os for at købe og klargøre et. Send derefter CAWG-Certificate-Id header med eSigner-legitimationsoplysningerne til dit CAWG-certifikat.
  • Samme eller separat legitimationsoplysninger. Brug en anden legitimationsoplysninger end C2PA-Certificate-Id når skaberens identitetscertifikat ikke er udgiverens kravsigneringscertifikat. Brug den samme værdi til at signere begge med én legitimationsoplysninger.
  • Signaturformat. Identitetsbekræftelsen er signeret med et X.509-certifikat (cawg.x509.cose). Den dækker manifestets hårde binding til aktivet og bærer sit eget betroede tidsstempel.
  • Oprettet påstand. Identitetsbekræftelsen er altid registreret i manifestet created_assertionsSom CAWG-identitetsspecifikation kræver.
  • Koste. Hver anmodning, der tilføjer en CAWG-identitetspåstand, foretager én signeringshandling mere og én tidsstempelanmodning mere. Manifestet vokser med omkring 20 KB.

Navngivne skuespillerroller

Brug CAWG-Role overskrift til at beskrive skuespillerens rolle, For eksempel cawg.creator or cawg.editorFor at sende mere end én rolle kan du:
  • kommaadskille dem: CAWG-Role: cawg.creator,cawg.editor
  • gentag overskriften: -H "CAWG-Role: cawg.creator" -H "CAWG-Role: cawg.editor"
  • eller gør begge dele.
Rolleværdier integreres præcis som sendt. Roller defineret af CAWG-specifikationen og dine egne brugerdefinerede rolleidentifikatorer accepteres begge. CAWG-Role Kræver CAWG-Certificate-IdUden den returneres anmodningen 400 Bad Request.

Brugerdefinerede påstande

Med brugerdefinerede assertions kan du integrere dine egne strukturerede data i det signerede manifest, f.eks. et internt aktiv-ID, en workflowreference eller licensmetadata. Hver enkelt er et JSON-objekt under en etiket, du vælger. Det er dækket af manifestsignaturen, så enhver ændring af det registreres. Brugerdefinerede assertions kræver flerdelt anmodningsformat, sendt i manifest_options en del.
Brugerdefinerede påstande er ikke fortrolige. Som alle C2PA-assertioner er de signerede, så ændringer kan registreres, men de er ikke krypterede. Enhver, der læser manifestet, kan læse dem. Hvis en værdi skal forblive privat, skal du kryptere den, før du sender den.

Etiketregler

Hver custom_assertions adgang kræver en label at:
  • er til stede, fordi der ikke er nogen standardetiket.
  • bruger omvendt domænenotation under et domæne, du kontrollerer, for eksempel com.example.my-assertion or io.acme.tracking-idDet betyder mindst to punktulseparerede segmenter. Hvert segment starter med et bogstav eller ciffer og indeholder kun bogstaver, cifre, - or _.
  • er 256 tegn eller færre.
  • er uden for de reserverede navnerum. Etiketter der starter med c2pa. or cawg. (enhver brug af store bogstaver) er reserveret til standardpåstande.
  • er unik inden for anmodningen.
Hvis en post bryder nogen af ​​disse regler, returneres anmodningen 400 Bad Request med en besked, der navngiver reglen.

Begrænsninger

Begrænsning Begræns
Brugerdefinerede påstande pr. anmodning 16
Størrelsen på hver post data (serialiseret JSON) 8 KB
Type data JSON-objekt (ikke et array, en streng eller et tal)

Formatspecifik adfærd

jpeg xl

En JPEG XL-fil kan være en ren kodestrøm eller en ISOBMFF-container. Et C2PA-manifest kan kun indlejres i containerformen, så API'en håndterer hver enkelt sådan her:
  • Containerinput er underskrevet som den er.
  • Bare codestream-input er pakket ind i en minimal JPEG XL-container før signering. Billeddataene kopieres uændret og kodes ikke igen.
Det signerede output er altid en JPEG XL-container, og standard JPEG XL-dekodere læser den.

M4A-lyd

audio/mp4 (M4A)-filer håndteres som MP4-containere. Svaret bevarer audio/mp4 indholdstype.

fejl

Alle fejl returnerer en JSON-brødtekst:
{ "fejl": " "}
Status Årsag Eksempelbesked
400 Bad Request C2PA-Certificate-Id mangler eller er tom credential ID not present in request
400 Bad Request CAWG-Role sendt uden CAWG-Certificate-Id CAWG-Role requires CAWG-Certificate-Id: cawg.creator
400 Bad Request Flerdelt: den asset del har ingen Content-Type asset part must declare a Content-Type
400 Bad Request Flerdelt: manifest_options er ikke gyldig JSON, har mere end 16 poster, har en post med en manglende eller ugyldig labelHar en data værdi, der ikke er et objekt, eller som er over 8 KB, eller som gentager en etiket Invalid manifest_options: <reason>
400 Bad Request Flerdelt: flerdelt brødtekst er misdannet eller overstiger størrelsesgrænsen multipart error: <reason>
413 Payload Too Large Den rå kropsstørrelse er over 50 MB
415 Unsupported Media Type Aktivets MIME-type er ikke understøttes Unsupported media type: image/bmp
500 Internal Server Error Legitimationsoplysningerne kunne ikke indlæses: Adgangstokenet er ugyldigt eller udløbet, eller legitimations-ID'et er forkert eller ikke tilgængeligt for dette token. No credential info: <reason>
500 Internal Server Error Signering, tidsstempling eller manifestgenerering mislykkedes, for eksempel fordi aktivet er beskadiget eller ikke matcher den deklarerede type. <reason>
Fejlfindingstip
  • Sørg Content-Type matcher filens faktiske format. En PNG sendt som image/jpeg mislykkes under signering.

Grænser

Vare Begræns
Anmod om størrelse (rå brødtekst eller hel brødtekst med flere dele) 50 MB
Brugerdefinerede påstande pr. anmodning 16
Brugerdefineret påstand data størrelse 8 KB hver
Brugerdefineret påstand label længde 256 tegn

Bekræftelse af et signeret aktiv

Du kan inspicere og validere indholdslegitimationsoplysningerne på ethvert signeret aktiv med standard C2PA-værktøjer: Outputtet viser SSL Provenance API kravgeneratoren, c2pa.opened handling, den overordnede ingrediens, enhver CAWG-identitetspåstand og brugerdefinerede påstande samt signeringscertifikatet og tidsstemplet.
Twitter
Facebook
LinkedIn
Reddit
E-mail

Hold dig informeret og sikker

SSL.com er en global leder inden for cybersikkerhed, PKI og digitale certifikater. Tilmeld dig for at modtage de seneste industrinyheder, tips og produktmeddelelser fra SSL.com.

SSL.com

Vi vil meget gerne have din feedback

Tag vores undersøgelse og fortæl os dine tanker om dit seneste køb.

Beskyttelse af personlige oplysninger
SSL.com

Dette websted bruger cookies, så vi kan give dig den bedst mulige brugeroplevelse. Cookieoplysninger gemmes i din browser og udfører funktioner som at genkende dig, når du vender tilbage til vores websted og hjælpe vores team med at forstå, hvilke sektioner på webstedet du finder mest interessante og nyttige.

For mere information, se vores Cookie- og fortrolighedserklæring.

3. parts cookies

Denne hjemmeside bruger Google Analytics & Stattæller at indsamle anonyme oplysninger såsom antallet af besøgende på webstedet og de mest populære sider.

At holde disse cookies aktiveret hjælper os med at forbedre vores websted.

Vis detaljer