Pravljenje i bezbedno upravljanje API ključevima: čitanje, pisanje, opoziv

Šta je API ključ

API ključ je dugačak, nasumičan niz znakova kojim se program predstavlja nekoj usluzi. Ko ga zna, može da radi sve što ključ dozvoljava. Zato API ključ treba čuvati bezbedno kao lozinku. U servisu Same-QR treba ti za komandnu liniju sameqr, za sopstvene skripte preko REST API-ja i za agente za programiranje kao što su Claude Code, Cursor i Codex. ChatGPT i Claude.ai ga ne traže, oni se prijavljuju preko OAuth-a.

Korak 1: Pronađi pravo mesto

Prijavi se u kontrolnu tablu i otvori Nalog. Tamo je odeljak „Pristup za CLI, skripte i agente“. Ključevi se mogu praviti samo ovde, uz prijavu u pregledaču. Ključ ne može da napravi nove ključeve, pa se ukradeni ključ ne može umnožavati.

Korak 2: Izaberi prava

Postoje tri nivoa. Uvek izaberi najmanji koji je dovoljan za zadatak.

• Izveštaji o skeniranju, analize, asistent koji samo odgovara na pitanja: samo čitanje.
• Skripte koje prave QR kodove i stranice, menjaju imena i tekstove, objavljuju, učitavaju kartice: čitanje + pisanje.
• Postupci koji menjaju ciljeve postojećih QR kodova, isključuju stranice ili ih brišu: puno. Svaka takva promena traži potvrdu sa pročitanim stanjem, a preko API-ja je moguće najviše 10 na sat i 30 na dan.

Sa ključem za čitanje svaki upit koji nešto menja biva odbijen. Agent za programiranje povezan preko MCP-a sa ključem za čitanje uopšte ne vidi alate za pisanje.

Korak 3: Rok važenja i ime

Svaki ključ ističe: posle 30, 90, 180 ili 365 dana, a podrazumevano je 90. Moguće je i bez ograničenja, ali to moraš svesno da izabereš, na primer za noćni zadatak bez čoveka koji ga obnavlja. Daj ključu ime prema nameni, na primer „Mesečni izveštaj klijent A“. Po nalogu je moguće najviše 10 ključeva.

Korak 4: Odmah ga bezbedno sačuvaj

Ključ počinje sa sqr_live_ i prikazuje se tačno jednom. Same-QR čuva samo kontrolni zbir i ne može ti ga kasnije ponovo prikazati. Odmah ga stavi u menadžer lozinki. Programi ga pri pokretanju čitaju iz promenljive okruženja SAMEQR_API_KEY. Ključ ne pripada:

• u izvorni kod, pogotovo ne u javni repozitorijum,
• u adresu, jer adrese završavaju u dnevnicima i istorijama,
• u tabelu, imejl ili poruku u četu,
• u razgovor sa AI asistentom,
• kao argument komande, jer tada ostaje u istoriji komandi.

Fiksni početak sqr_live_ ima svrhu: alati koji traže slučajno objavljene tajne po njemu prepoznaju ključ.

Korak 5: Opozovi ako je potrebno

Na istoj listi ključ opozivaš jednim klikom. Odmah postaje nevažeći, a tvoji QR kodovi ostaju nepromenjeni. Istekli ključevi ostaju na listi sa napomenom, da vidiš zašto skripta odjednom ne prolazi. Promena lozinke dodatno opoziva sve ključeve odjednom. Opozovi ključ ako je negde postao vidljiv, ako neki saradnik više ne radi za tebe ili ako više ne znaš čemu služi.

Zaključak: Zašto Same-QR

Same-QR ozbiljno shvata ključeve: odvojena prava, rokovi sa smislenom podrazumevanom vrednošću, prikaz samo jednom, čuvanje samo kao kontrolni zbir i opoziv sa trenutnim dejstvom. Tako API, CLI i agente za programiranje možeš mirno da koristiš, u svakom paketu.

Počni odmah: registruj se besplatno na sameqr.com, 20 dinamičkih QR kodova je trajno besplatno. API, CLI i MCP server dostupni su u svakom paketu, a dokumentacija se nalazi na sameqr.com/entwickler.

Često postavljana pitanja