Autentificering

API'en understøtter tre autentificeringsmetoder afhængigt af dit anvendelsestilfælde.

API-nøgle

Til server-side integrationer. Generer en nøgle fra din API-nøgleside og send den via X-Api-Key-headeren:

X-Api-Key: bws_a1b2c3d4e5f6...

API-nøgler har fuld adgang til alle API-endpoints — upload, slet, list filer, administrer indstillinger. Eksponer dem aldrig i klientkode.

TIP

API-nøgler udløber ikke. Du kan oprette flere nøgler og tilbagekalde dem individuelt.

JWT Bearer Token

Til webdashboardet og Cognito-autentificerede sessioner. Send tokenet via Authorization-headeren:

Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

JWT-tokens udstedes af AWS Cognito, når en bruger logger ind via IPFS Ninja-dashboardet. De udløber automatisk og er ikke beregnet til direkte API-integrationer — brug API-nøgler i stedet.

Signeret upload-token

Til klientside-uploads uden at eksponere din API-nøgle. Send tokenet via Authorization-headeren:

Authorization: Signed sup_a1b2c3d4e5f6...

Signerede tokens er tidsbegrænsede og begrænset til uploadoperationer. De er sikre at indlejre i browser- eller mobilapplikationer. Generer dem fra din server med POST /upload/signed-url og send dem til klienten.

Se Signerede tokens for detaljer om oprettelse, listning og tilbagekaldelse af signerede upload-tokens.