Immaniġġja l-Awtentikazzjoni u s-Sessjonijiet
F'din il-paġna
Lezzjoni miktuba mill-ġdid fit-3 ta’ Novembru 2026 ibbażata fuq il-gwida Computer use ta’ OpenAI u d-dokumentazzjoni tal-awtentikazzjoni ta’ Playwright. Il-verżjoni preċedenti kienet tqiegħed passwords u kodiċijiet 2FA direttament fil-prompt mibgħut lill-mudell—inkluż permezz ta’ varjabbli tal-ambjent, li ma jipprevjenix it-trażmissjoni tagħhom—u tiddelega l-login SSO lill-aġent. Issa, il-kodiċi tiegħek jimmaniġġja s-sigrieti, l-istat tas-sessjoni jiġi salvat bl-użu ta’
storage_state, u l-SSO jsir darba biss manwalment. Sorsi: Computer use · Playwright, authentication.
L-Isfida tal-Awtenikazzjoni
Il-biċċa l-kbira tal-flussi tax-xogħol tal-awtomazzjoni jeħtieġu li tkun iddaħħal f’servizz. Sakemm l-aġent tiegħek jibqa’ fuq paġni pubbliċi, kollox jaħdem sew; fil-mument li jkollu bżonn jiftaħ CRM, back office, jew inbox tal-email, jiltaqa’ ma’ ħajt ta’ login. Formoli, 2FA, SSO, u sessjonijiet persistenti kull wieħed jeħtieġ trattament differenti, iżda regola waħda tirregolahom kollha: il-mudell qatt ma jara sigriet.
Login Ibbażat fuq Formola
It-tentazzjoni hija li timla s-sekwenza lill-aġent, inklużi l-kredenzjali:
# TAGĦMILX DAN: il-password tidħol fir-reqesta mibgħuta lill-API
task = """
Idħol fis-sit:
1. Ikklikkja l-qasam tal-email u ikteb: [email protected]
2. Ikklikkja l-qasam tal-password u ikteb: MyPassword123
3. Ikklikkja l-buttuna "Log in"
"""
Il-qari tal-password minn varjabbli tal-ambjent qabel ma tidħilha fil-prompt ma jbiddel xejn: għadha tħalli l-infrastruttura tiegħek fir-reqesta, tinżamm mar-risposta—ir-risposti huma maħżuna b’mod default (Lezzjoni 12)—u tista’ tnixxi fil-logs tiegħek. OpenAI tirrakkomanda li żżomm il-kredenzjali barra mit-test tal-paġna u mill-iscreenshots. Is-soluzzjoni hija li l-kodiċi tiegħek jimla l-formola tal-login b’Playwright, imbagħad jgħaddiha lill-aġent ladarba s-sessjoni tkun miftuħa.
import os
def log_in(page, login_url: str):
"""Login imwettaq mill-kodiċi tiegħek: il-mudell qatt ma jara l-password."""
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")
Adatta t-tikketti Email u Password għall-applikazzjoni tiegħek. Dan huwa wieħed mill-ftit postijiet fil-fluss tax-xogħol fejn selettur huwa ġustifikat għalkollox: paġna ta’ login rari tinbidel, u l-istakes tas-sigurtà jisbqu l-flessibbiltà.
Użu Mill-Ġdid tal-Istat tas-Sessjoni
Id-dħul kull darba li ssir eżekuzzjoni jħassar il-ħin u xi kultant jista’ jattiva allerti tas-sigurtà fuq in-naħa tas-servizz. Playwright jista’ jsalva l-istat ta’ kuntest—cookies, ħażna lokali, IndexedDB—f’fajl, imbagħad joħloq kuntest ġdid minn dak il-fajl.
import os
def save_session(context, filepath="session.json"):
"""Isalva l-istat attwali tas-sessjoni."""
context.storage_state(path=filepath)
def new_context_with_session(browser, filepath="session.json"):
"""Joħloq kuntest minn sessjoni salvata, jekk teżisti waħda."""
options = {"viewport": {"width": 1280, "height": 720}}
if os.path.exists(filepath):
options["storage_state"] = filepath
return browser.new_context(**options)
Integrat fil-fluss tax-xogħol, dan joħloq loġika f’żewġ passi: ibda mis-sessjoni salvata, ivverifika li għadha valida, u għaddi mil-login mill-ġdid biss jekk dan ifalli. L-istat jiġi salvat mill-ġdid wara l-kompitu, għax ħafna servizzi jiġġeddu t-token tas-sessjoni tagħhom matul it-triq.
from playwright.sync_api import sync_playwright
def authenticated_workflow(task: str, login_url: str):
"""Fluss tax-xogħol b'użu mill-ġdid tas-sessjoni."""
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("Sessjoni rrestawrata b'suċċess")
else:
log_in(page, login_url) # il-kodiċi tiegħek, mhux l-aġent
if not is_logged_in(page):
raise RuntimeError("Login impossibbli: iċċekkja l-kredenzjali jew 2FA")
save_session(context)
result = run_agent(task, page=page)
save_session(context) # aġġorna l-istat
return result
finally:
browser.close()
pw.stop()
Ittratta l-fajl tas-sessjoni bħala password: Playwright jwissik li jista’ jkun fih cookies u headers li jippermettu l-impersonazzjoni tal-kont, u jirrakkomanda b’mod qawwi kontra l-verżjonament tiegħu, anke f’repożitorju privat. Aħżnu mas-sigrieti tiegħek.
Immaniġġjar tal-Awtenikazzjoni b’Żewġ Fatturi (2FA)
Il-2FA jpoġġi sfida għax spiss jeħtieġ intervent uman, kemm jekk kodiċi SMS jew app awtentikatur. Dak huwa preċiżament l-iskop tiegħu: huwa ddisinjat biex awtomata ma tkunx tista’ taqbżu waħedha. Żewġ approċċi jikkoegżistu skont il-fattur użat, u l-għażla tal-fattur meta tinħoloq il-kont tas-servizz tiddetermina jekk il-fluss tax-xogħol tiegħek jistax jimxi waħdu.
TOTP Awtomatizzat
Jekk il-kont juża app TOTP bħal Google Authenticator jew Authy, il-kodiċi muri huwa sempliċiment funzjoni tas-sigriet kondiviż u l-arloġġ. Il-kodiċi tiegħek għalhekk jista’ jiġġenerah u jdaħħlu huwa stess, mingħajr ma jurieh lill-mudell.
import os
import pyotp
def enter_totp_code(page):
"""Idaħħal il-kodiċi TOTP attwali: is-sigriet u l-kodiċi jibqgħu fil-kodiċi tiegħek."""
totp = pyotp.TOTP(os.environ["TOTP_SECRET"])
page.get_by_label("Verification code").fill(totp.now())
page.get_by_role("button", name="Verify").click()
Ikkunsidra x’qed tagħmel: il-ħażna tas-sigriet TOTP flimkien mal-password tnaqqas il-2FA għal fattur wieħed, peress li ż-żewġ sigrieti jgħixu fl-istess post. Irriżerva dan l-approċċ għal kont ta’ servizz dedikat, b’drittijiet limitati għall-minimu strett.
Stennija Manwali
Fatturi mhux awtomatizzabbli, bħal SMS jew notifiki push, jeħtieġu pausa espliċita. L-aġent jieqaf, operatur jivvalida fuq it-telefon tiegħu, imbagħad iċ-ċiklu jkompli minn fejn kien waqaf. Din hija soluzzjoni aċċettabbli għal proċess imneddi manwalment, ferm inqas għal cron job ta’ kull lejl.
def wait_for_2fa(page):
"""Iwaqqaf l-aġent u jistenna validazzjoni manwali."""
print("2FA meħtieġ. Ivvalida manwalment, imbagħad agħfas Enter.")
input("Agħfas Enter biex tkompli...")
# L-aġent ikompli wara l-validazzjoni
Immaniġġjar tal-SSO (Single Sign-On)
Il-logins SSO (Google, Microsoft, SAML) jagħmlu redirect għal fornitur tal-identità estern: l-aġent ibiddel id-dominju f’nofs il-fluss u jkollu jdaħħal il-kredenzjali hemmhekk. Tiddelegax dan il-pass lill-aġent. Wettaq il-login SSO darba biss, manwalment, f’browser viżibbli kkontrollat minn Playwright, imbagħad salva l-istat tas-sessjoni: eżekuzzjonijiet sussegwenti jibdew minn dan l-istat.
def manual_sso_login(login_url: str, filepath="session.json"):
"""Bniedem jidħol f'browser viżibbli; is-sessjoni tiġi salvata."""
pw = sync_playwright().start()
browser = pw.chromium.launch(headless=False)
context = browser.new_context()
page = context.new_page()
page.goto(login_url)
input("Idħol fit-tieqa miftuħa, imbagħad agħfas Enter...")
save_session(context, filepath)
browser.close()
pw.stop()
Meta s-sessjoni eventwalment tiskadi, il-fluss tax-xogħol irid jieqaf u jitlob dan il-login uman mill-ġdid. Żid din l-istruzzjoni fil-linji gwida tal-aġent: jekk isib ruħu quddiem paġna ta’ fornitur tal-identità, jieqaf u jirrapportaha minflok ma jipprova xi ħaġa.
Skoperta tal-Istat tal-Login
Dan il-mekkaniżmu kollu jistrieħ fuq mistoqsija li trid tkun kapaċi twieġeb b’mod affidabbli: aħna ddaħħlin? Funzjoni dedikata taqsam żewġ sinjali, l-ewwel l-URL attwali, peress li redirect lejn /login huwa ċar, imbagħad il-preżenza ta’ element riżervat għall-utenti awtentikati, tipikament il-menu tal-kont. L-ewwel test huwa istantanju, it-tieni jkopri applikazzjonijiet li juru l-paġna tal-login mingħajr ma jbiddlu l-URL.
from playwright.sync_api import TimeoutError as PlaywrightTimeoutError
def is_logged_in(page) -> bool:
"""Jiċċekkja jekk is-sessjoni hijiex attiva."""
# Ċekk tal-URL
if "/login" in page.url or "/signin" in page.url:
return False
# Ċekk tal-element DOM
try:
page.wait_for_selector("[data-testid=user-menu]", timeout=3000)
return True
except PlaywrightTimeoutError:
return False
L-except jimmira preċiżament l-iskadenza tat-timeout: except: sempliċi kieku jibelgħa wkoll interrupt tat-tastiera jew żball reali tal-ipprogrammar, li trid tara jitilgħu ‘l fuq.
Sigurtà tal-Kredenzjali
"Qatt taħżinx passwords fil-kodiċi sors tiegħek, fil-prompts tiegħek, jew fil-logs tiegħek."
Fil-prattika, din ir-regola tinħall f’ftit drawwiet li jiswew kważi xejn ladarba jiġu adottati. Il-kredenzjali jgħixu f’varjabbli tal-ambjent, mogħtija fl-iżvilupp minn fajl .env li immedjatament teskludi mill-verżjonament permezz ta’ .gitignore—din l-ommissjoni hija kawża klassika ta’ tnixxija ta’ sigrieti f’repożitorji pubbliċi. Fil-produzzjoni, issostitwixxi dan il-fajl b’maniġer tas-sigrieti, bħal Vault jew AWS Secrets Manager, li jwassal valuri fuq talba u jtraċċa l-aċċess. Il-kodiċi tiegħek biss jaqrahom, qatt il-mudell. Ippjana rotazzjoni regolari ta’ passwords u tokens API, sabiex tnixxija antika ma tiftaħ xejn aktar. Fl-aħħar, iffiltra l-logs tiegħek biex qatt ma tirreġistra data sensittiva hemmhekk: aġent li jirreġistra b’mod fidil kull daqsta ta’ tastiera jikkopja wkoll dak li ġie magħmul jikteb.
Punti Ewlenin
- Il-mudell qatt ma jara sigriet: il-kodiċi tiegħek idaħħal il-password u l-kodiċi 2FA b’Playwright
- Salva l-istat tas-sessjoni b’
storage_stateu ttratta dak il-fajl bħala sigriet - It-TOTP huwa awtomatizzat fuq in-naħa tal-kodiċi, riżervat għal kont ta’ servizz b’drittijiet limitati
- Wettaq il-login SSO darba biss manwalment, imbagħad uża s-sessjoni salvata mill-ġdid
- Dejjem iċċekkja l-istat tal-login qabel ma tniedi fluss tax-xogħol