Upravljanje autentifikacijom i sesijama
Na ovoj stranici
Lekcija je ponovno napisana 3. studenoga 2026. na temelju vodiča Computer use tvrtke OpenAI i Playwrightove dokumentacije o autentifikaciji. Prethodna verzija stavljala je lozinke i 2FA kodove izravno u upit poslan modelu—uključujući putem varijabli okruženja, što ne sprječava njihov prijenos—te je delegirala prijavu putem SSO-a agentu. Sada tvoj kod upravlja tajnama, stanje sesije sprema se pomoću
storage_state, a SSO prijava obavlja se jednom ručno. Izvori: Computer use · Playwright, authentication.
Izazov autentifikacije
Većina automatiziranih tijekova rada zahtijeva prijavu na uslugu. Dokle god tvoj agent ostaje na javnim stranicama, sve funkcionira kako treba; čim treba otvoriti CRM, back office ili sandučić e-pošte, nailazi na zid za prijavu. Obrasci, 2FA, SSO i trajne sesije zahtijevaju različite pristupe, ali jedno pravilo vrijedi za sve: model nikada ne smije vidjeti tajnu.
Prijava putem obrasca
Iskušenje je diktirati agentu slijed radnji, uključujući vjerodajnice:
# NEMOJ OVO RADITI: lozinka odlazi u zahtjev poslan API-ju
task = """
Prijavi se na stranicu:
1. Klikni polje za e-poštu i upiši: [email protected]
2. Klikni polje za lozinku i upiši: MyPassword123
3. Klikni gumb "Log in"
"""
Čitanje lozinke iz varijable okruženja prije umetanja u upit ništa ne mijenja: tvoja infrastruktura i dalje ostaje u zahtjevu, podaci se zadržavaju uz odgovor—odgovori se prema zadanim postavkama pohranjuju (Lekcija 12)—i mogu procuriti u tvoje zapise. OpenAI preporučuje držanje vjerodajnica izvan teksta stranice i snimki zaslona. Rješenje je da tvoj kod ispuni obrazac za prijavu pomoću Playwrighta, a tek nakon otvaranja sesije preda kontrolu agentu.
import os
def log_in(page, login_url: str):
"""Prijavu obavlja tvoj kod: model nikada ne vidi lozinku."""
page.goto(login_url)
page.get_by_label("Email").fill(os.environ["APP_EMAIL"])
page.get_by_label("Password").fill(os.environ["APP_PASSWORD"])
page.get_by_role("button", name="Log in").click()
page.wait_for_load_state("networkidle")
Prilagodi oznake Email i Password svojoj aplikaciji. Ovo je jedno od rijetkih mjesta u tijeku rada gdje je selektor u potpunosti opravdan: stranica za prijavu rijetko se mijenja, a sigurnosni ulozi nadmašuju potrebu za fleksibilnošću.
Ponovna upotreba stanja sesije
Prijava pri svakom izvršavanju gubi vrijeme i ponekad može potaknuti sigurnosna upozorenja na strani usluge. Playwright može spremiti stanje konteksta—kolačiće, lokalno spremište, IndexedDB—u datoteku, a zatim stvoriti novi kontekst iz te datoteke.
import os
def save_session(context, filepath="session.json"):
"""Sprema trenutno stanje sesije."""
context.storage_state(path=filepath)
def new_context_with_session(browser, filepath="session.json"):
"""Stvara kontekst iz spremljene sesije, ako postoji."""
options = {"viewport": {"width": 1280, "height": 720}}
if os.path.exists(filepath):
options["storage_state"] = filepath
return browser.new_context(**options)
Integrirano u tijek rada, ovo stvara dvostupanjsku logiku: kreni od spremljene sesije, provjeri je li još uvijek valjana i ponovi prijavu samo ako to ne uspije. Stanje se ponovno sprema nakon zadatka jer mnoge usluge usput obnavljaju svoj token sesije.
from playwright.sync_api import sync_playwright
def authenticated_workflow(task: str, login_url: str):
"""Tijek rada s ponovnom upotrebom sesije."""
pw = sync_playwright().start()
browser = pw.chromium.launch(headless=True)
try:
context = new_context_with_session(browser)
page = context.new_page()
page.goto(login_url)
if is_logged_in(page):
print("Sesija je uspješno obnovljena")
else:
log_in(page, login_url) # tvoj kod, a ne agent
if not is_logged_in(page):
raise RuntimeError("Prijava nemoguća: provjeri vjerodajnice ili 2FA")
save_session(context)
result = run_agent(task, page=page)
save_session(context) # ažuriraj stanje
return result
finally:
browser.close()
pw.stop()
Postupaj s datotekom sesije kao s lozinkom: Playwright upozorava da ona može sadržavati kolačiće i zaglavlja koja omogućuju lažno predstavljanje računa, te snažno savjetuje protiv njezinog stavljanja pod nadzor verzija, čak ni u privatnom repozitoriju. Pohrani je zajedno sa svojim tajnama.
Upravljanje dvofaktorskom autentifikacijom (2FA)
2FA predstavlja izazov jer često zahtijeva ljudsku intervenciju, bilo da je riječ o SMS kodu ili aplikaciji za autentifikaciju. Upravo tome i služi: dizajniran je tako da ga automat ne može sam zaobići. Dva pristupa postoje ovisno o korištenom faktoru, a izbor faktora prilikom stvaranja računa usluge određuje može li se tvoj tijek rada pokretati bez nadzora.
Automatizirani TOTP
Ako račun koristi TOTP aplikaciju poput Google Authenticator ili Authy, prikazani kod je samo funkcija dijeljene tajne i sata. Tvoj kod stoga može sam generirati i unijeti kod, bez pokazivanja modelu.
import os
import pyotp
def enter_totp_code(page):
"""Unosi trenutni TOTP kod: tajna i kod ostaju u tvom kodu."""
totp = pyotp.TOTP(os.environ["TOTP_SECRET"])
page.get_by_label("Verification code").fill(totp.now())
page.get_by_role("button", name="Verify").click()
Razmisli što radiš: pohranjivanje TOTP tajne uz lozinku svodi 2FA na jedan faktor, jer obje tajne žive na istom mjestu. Ovaj pristup rezerviraj za namjenski račun usluge, s pravima ograničenim na strogi minimum.
Ručno čekanje
Faktori koje nije moguće automatizirati, poput SMS-a ili push obavijesti, zahtijevaju eksplicitnu pauzu. Agent se zaustavlja, operater potvrđuje na svom telefonu, a zatim se petlja nastavlja tamo gdje je stala. Ovo je prihvatljivo rješenje za proces pokrenut ručno, puno manje za noćni cron zadatak.
def wait_for_2fa(page):
"""Pauzira agenta i čeka ručnu potvrdu."""
print("Potreban je 2FA. Potvrdi ručno, zatim pritisni Enter.")
input("Pritisni Enter za nastavak...")
# Agent se nastavlja nakon potvrde
Upravljanje SSO-om (Single Sign-On)
SSO prijave (Google, Microsoft, SAML) preusmjeravaju na vanjskog pružatelja identiteta: agent bi usred tijeka promijenio domenu i morao bi tamo unijeti vjerodajnice. Nemoj delegirati ovaj korak agentu. Obavi SSO prijavu jednom, ručno, u vidljivom pregledniku kojim upravlja Playwright, a zatim spremi stanje sesije: naknadna izvršavanja kreću iz tog stanja.
def manual_sso_login(login_url: str, filepath="session.json"):
"""Čovjek se prijavljuje u otvorenom pregledniku; sesija se sprema."""
pw = sync_playwright().start()
browser = pw.chromium.launch(headless=False)
context = browser.new_context()
page = context.new_page()
page.goto(login_url)
input("Prijavi se u otvorenom prozoru, zatim pritisni Enter...")
save_session(context, filepath)
browser.close()
pw.stop()
Kada sesija na kraju istekne, tijek rada mora se zaustaviti i zatražiti ovu ljudsku prijavu ponovno. Dodaj ovu uputu u smjernice agenta: ako se nađe ispred stranice pružatelja identiteta, zaustavlja se i to prijavljuje umjesto da pokušava bilo što.
Detektiranje stanja prijave
Sva ova mehanika počiva na pitanju na koje moraš moći pouzdano odgovoriti: jesmo li prijavljeni? Namjenska funkcija provjerava dva signala: prvo trenutni URL, jer je preusmjeravanje na /login nedvosmisleno, a zatim prisutnost elementa rezerviranog za autentificirane korisnike, obično izbornika računa. Prvi test je trenutan, drugi pokriva aplikacije koje prikazuju stranicu za prijavu bez promjene URL-a.
from playwright.sync_api import TimeoutError as PlaywrightTimeoutError
def is_logged_in(page) -> bool:
"""Provjerava je li sesija aktivna."""
# Provjera URL-a
if "/login" in page.url or "/signin" in page.url:
return False
# Provjera DOM elementa
try:
page.wait_for_selector("[data-testid=user-menu]", timeout=3000)
return True
except PlaywrightTimeoutError:
return False
Klauzula except cilja precizno na istek vremena: goli except: progutao bi i prekide tipkovnice ili stvarne programerske pogreške, koje želiš vidjeti kako isplivavaju na površinu.
Sigurnost vjerodajnica
"Nikada ne pohranjuj lozinke u svoj izvorni kod, svoje upite ili svoje zapise."
U praksi, ovo se pravilo raščlanjuje na nekoliko navika koje gotovo ništa ne koštaju jednom kada se usvoje. Vjerodajnice žive u varijablama okruženja, koje se u razvoju napajaju iz .env datoteke koju odmah isključuješ iz nadzora verzija putem .gitignore—ovaj propust klasičan je uzrok curenja tajni u javne repozitorije. U proizvodnji zamijeni ovu datoteku upraviteljem tajni, poput Vaulta ili AWS Secrets Managera, koji isporučuje vrijednosti na zahtjev i prati pristup. Samo tvoj kod ih čita, nikada model. Planiraj redovitu rotaciju lozinki i API tokena, tako da staro curenje više ništa ne otvara. Konačno, filtriraj svoje zapise kako nikada ne bi bilježili osjetljive podatke: agent koji vjerno bilježi svaki pritisak tipke također kopira ono što je natjeran upisati.
Ključne točke
- Model nikada ne vidi tajnu: tvoj kod unosi lozinku i 2FA kod pomoću Playwrighta
- Spremi stanje sesije s
storage_statei tretiraj tu datoteku kao tajnu - TOTP se automatizira na strani koda, rezerviran za račun usluge s ograničenim pravima
- Obavi SSO prijavu jednom ručno, zatim ponovno upotrijebi spremljenu sesiju
- Uvijek provjeri stanje prijave prije pokretanja tijeka rada