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:
- Log ind. Gå til login.ssl.com og log ind med din SSL.com-konto.
- Åbn Administrer programmer. Vælg Administrer applikationer menuen ved at klikke på persona-ikonet øverst til højre.
- Opret applikationen. Klik Opret applikation.
- 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.
- 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.
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) |
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.