Autentifikácia

API podporuje tri metódy autentifikácie v závislosti od vášho prípadu použitia.

API kľúč

Pre serverové integrácie. Vygenerujte kľúč zo stránky API kľúče a predajte ho cez hlavičku X-Api-Key:

X-Api-Key: bws_a1b2c3d4e5f6...

API kľúče majú plný prístup ku všetkým API endpointom — nahrávanie, mazanie, zoznam súborov, správa nastavení. Nikdy ich nevystavujte v kóde na strane klienta.

TIP

API kľúče nemajú expiráciu. Môžete vytvoriť viacero kľúčov a jednotlivo ich odvolať.

JWT Bearer Token

Pre webový ovládací panel a relácie autentifikované cez Cognito. Predajte token cez hlavičku Authorization:

Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

JWT tokeny sú vydávané AWS Cognito, keď sa používateľ prihlási cez ovládací panel IPFS Ninja. Automaticky expirujú a nie sú určené pre priame API integrácie — namiesto nich použite API kľúče.

Podpísaný token na nahrávanie

Pre nahrávanie na strane klienta bez odhalenia vášho API kľúča. Predajte token cez hlavičku Authorization:

Authorization: Signed sup_a1b2c3d4e5f6...

Podpísané tokeny sú časovo obmedzené a obmedzené iba na operácie nahrávania. Je bezpečné ich vkladať do prehliadačových alebo mobilných aplikácií. Generujte ich zo svojho servera pomocou POST /upload/signed-url a predajte ich klientovi.

Podrobnosti o vytváraní, zobrazovaní a odvolávaní podpísaných tokenov na nahrávanie nájdete v časti Podpísané tokeny.