API-kulcs létrehozása és biztonságos kezelése: olvasás, írás, visszavonás

Mi az az API-kulcs

Az API-kulcs egy hosszú, véletlenszerű karaktersor, amellyel egy program igazolja magát egy szolgáltatásnál. Aki ismeri, mindent megtehet, amit a kulcs engedélyez. Ezért az API-kulcsot ugyanúgy biztonságosan kell őrizni, mint egy jelszót. A Same-QR-nél a sameqr parancssorhoz, a REST API-t használó saját szkriptekhez és a programozó ágensekhez, például a Claude Code-hoz, a Cursorhoz és a Codexhez van rá szükséged. A ChatGPT-nek és a Claude.ai-nak nincs rá szüksége, ők OAuth-tal jelentkeznek be.

1. lépés: A megfelelő hely megkeresése

Jelentkezz be az irányítópultra, és nyisd meg a Fiókot. Ott találod a „Hozzáférés CLI-hez, szkriptekhez és ágensekhez” szakaszt. Kulcsot csak itt lehet létrehozni, böngészős bejelentkezéssel. Egy kulcs nem tud további kulcsokat létrehozni, így egy ellopott kulcs nem szaporodik.

2. lépés: Jogosultságok kiválasztása

Három szint van. Mindig a legkisebbet válaszd, amely elég a feladathoz.

• Beolvasási jelentések, kiértékelések, olyan asszisztens, amely csak kérdésekre válaszol: csak olvasás.
• Szkriptek, amelyek QR-kódokat és oldalakat hoznak létre, neveket és szövegeket módosítanak, közzétesznek, étlapokat olvasnak be: olvasás + írás.
• Folyamatok, amelyek meglévő QR-kódok céljait módosítják, oldalakat offline állapotba tesznek vagy törölnek: teljes. Minden ilyen módosításhoz megerősítés kell a beolvasott állapottal, az API-n keresztül óránként legfeljebb 10, naponta legfeljebb 30 lehetséges.

Olvasókulccsal minden módosító kérés elutasítást kap. Az a programozó ágens, amely MCP-n keresztül olvasókulccsal kapcsolódik, az író eszközöket egyáltalán nem is látja.

3. lépés: Érvényességi idő és név

Minden kulcs lejár: 30, 90, 180 vagy 365 nap után, az alapértelmezett 90. Korlátlan is lehet, de ezt tudatosan kell kiválasztanod, például egy éjszakai, ember nélküli feladathoz, amely megújítja. Adj a kulcsnak a céljának megfelelő nevet, például „Havi jelentés A ügyfél”. Fiókonként legfeljebb 10 kulcs lehetséges.

4. lépés: Azonnal biztonságos helyre tenni

A kulcs sqr_live_ előtaggal kezdődik, és pontosan egyszer jelenik meg. A Same-QR csak egy ellenőrző összeget tárol, és később nem tudja újra megmutatni neked. Tedd rögtön a jelszókezelődbe. A programok indításkor a SAMEQR_API_KEY környezeti változóból olvassák ki. Egy kulcs nem való:

• a forráskódba, főleg nem egy nyilvános tárolóba,
• egy címbe, mert a címek naplókba és előzményekbe kerülnek,
• táblázatba, e-mailbe vagy csevegőüzenetbe,
• egy MI-asszisztenssel folytatott csevegésbe,
• egy parancs argumentumaként, mert akkor benne lesz a shell előzményeiben.

A rögzített sqr_live_ kezdetnek van egy célja: a véletlenül közzétett titkokat kereső eszközök ebből ismerik fel a kulcsot.

5. lépés: Szükség esetén visszavonás

Ugyanebben a listában egy kattintással vonhatsz vissza egy kulcsot. Azonnal érvénytelen lesz, a QR-kódjaid változatlanok maradnak. A lejárt kulcsok megjegyzéssel a listában maradnak, hogy lásd, miért nem jut át hirtelen egy szkript. A jelszócsere ráadásul az összes kulcsot egyszerre visszavonja. Vonj vissza egy kulcsot, ha bárhol láthatóvá vált, ha egy szolgáltató már nem dolgozik neked, vagy ha már nem tudod, mire való.

Összegzés: miért a Same-QR

A Same-QR komolyan veszi a kulcsokat: elkülönített jogosultságok, értelmes alapbeállítású érvényességi idők, csak egyetlen alkalommal történő megjelenítés, csak ellenőrző összegként történő tárolás és azonnali hatályú visszavonás. Így nyugodtan használhatod az API-t, a CLI-t és a programozó ágenseket, minden csomagban.

Vágj bele rögtön: regisztrálj ingyen a sameqr.com oldalon, 20 dinamikus QR-kód tartósan ingyenes. Az API, a CLI és az MCP-szerver minden csomagban elérhető, a dokumentáció a sameqr.com/entwickler címen található.

Gyakran ismételt kérdések