Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Immaniġġja l-Awtentikazzjoni u s-Sessjonijiet

Lezzjoni 8 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-Isfida tal-Awtenikazzjoni
  2. Login Ibbażat fuq Formola
  3. Użu Mill-Ġdid tal-Istat tas-Sessjoni
  4. Immaniġġjar tal-Awtenikazzjoni b’Żewġ Fatturi (2FA)
  5. Immaniġġjar tal-SSO (Single Sign-On)
  6. Skoperta tal-Istat tal-Login
  7. Sigurtà tal-Kredenzjali
  8. Punti Ewlenin

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."

— Regola fundamentali tas-sigurtà

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_state u 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