Бонус за пополнение: Чёрная пятница·Пополните от $50 и получите $10 · Пополните от $100 и получите $25·До 30 ноябряПополнить →

Как автоматизировать вход с 2FA с помощью браузерного агента

Безопасная автоматизация 2FA-входа: браузерный ИИ-агент, хранилище секретов и локальный TOTP без передачи учетных данных в промпт модели.

16 нояб. 2026 г. · Время чтения: 9 мин

Чтобы безопасно автоматизировать вход с двухфакторной аутентификацией (2FA), не передавайте пароли и сиды TOTP (Time-Based One-Time Password) в контекст языковой модели. Передавайте браузерному агенту символические ссылки на секреты, а локальный генератор TOTP подключайте через вызов инструментов (tool calling). Модель решает, куда нажать и какое поле ввода активно, а рантайм внедряет чувствительные данные напрямую в DOM браузера.

Жестко заданные селекторы ломаются, когда SaaS-панель меняет имя класса или показывает промежуточный экран безопасности. Браузерный ИИ-агент читает актуальное дерево доступности (accessibility tree) и визуальную разметку, адаптируется к неожиданным экранам и проходит многоэтапную аутентификацию, не раскрывая учетные данные в логах промптов.

Почему учетным данным не место в промпте агента#

При создании скриптов для веб-автоматизации проще всего прописать логин, пароль и код 2FA прямо в системных инструкциях. Но это создает три серьезные проблемы с безопасностью.

На каждом шаге цикла агент отправляет историю диалога провайдеру модели. Если пароль или 32-значный base32-секрет TOTP находится в системном промпте, он передается по сети при каждом вызове и оседает в логах запросов.

Если на странице есть непроверенный текст (комментарии пользователей, тикеты техподдержки или темы писем), инъекция в промпт (prompt injection) может заставить модель ввести пароль в публичную строку поиска или передать сид TOTP через URL-параметр.

Токенизаторы LLM часто разбивают сложные пароли или сиды base32 на части слов. Модели могут галлюцинировать или менять символы местами при воспроизведении случайных строк.

Решение — провести строгую границу между рассуждениями модели и хранением учетных данных:

  1. Храните имя пользователя, пароль и TOTP_SECRET в переменных окружения или в менеджере секретов.
  2. Передавайте модели символические плейсхолдеры, такие как {{VAULT_USERNAME}} и {{VAULT_PASSWORD}}. Когда модель выдает действие fill с плейсхолдером, локальная обертка выполнения подменяет его на реальное значение непосредственно перед отправкой события в браузер.
  3. Предоставьте модели инструмент fill_totp_code, принимающий только ID целевого элемента. Инструмент генерирует 6-значный код RFC 6238 в памяти и вводит его в поле, вообще не возвращая сами цифры в LLM.

Разбор реального сценария входа с 2FA#

Возьмем типовую рутинную задачу: войти на портал вендора (например, GitHub или биллинг) и скачать CSV-файл со счетом за месяц. Портал требует двухэтапный ввод учетных данных, затем запрос TOTP, а иногда показывает промежуточный экран «Доверять этому браузеру?».

Полный прогон с браузерным агентом Lovely Router и моделью claude-sonnet-5.5 занимает пять шагов:

  1. Переход на страницу и поиск поля логина. Агент загружает https://portal.example.com/login. Он читает дерево доступности, находит поле ввода email (#login_field) и генерирует действие для заполнения {{VAULT_USERNAME}}. Если поле пароля находится на том же экране, он заполняет {{VAULT_PASSWORD}} и нажимает кнопку отправки за один шаг.
  2. Обработка запроса 2FA. Страница переходит на /sessions/two-factor. Агент анализирует новый DOM, обнаруживает поле ввода 6-значного кода подтверждения (#app_totp) и вызывает инструмент type_totp, передавая ему селектор цели.
  3. Проверка временного окна TOTP и отправка. Перед генерацией кода локальный инструмент проверяет, сколько секунд осталось до конца текущего 30-секундного окна TOTP. Если осталось менее 4 секунд, инструмент делает паузу до начала следующего интервала, чтобы код не истек прямо во время отправки формы. Затем он вводит 6 цифр и отправляет форму.
  4. Закрытие промежуточного экрана. Портал отображает запрос «Запомнить это устройство на 30 дней». Хрупкий скрипт на базе жестких CSS-селекторов здесь бы упал, если бы экран появился только после истечения cookies. Агент же считывает кнопки, выбирает «Не запоминать» (что логично для эфемерной сессии браузера в облаке) и переходит в основную панель управления.
  5. Сохранение состояния сессии. Как только агент подтверждает, что заголовок панели управления виден, скрипт-обертка экспортирует storageState браузера (cookies и localStorage) в зашифрованный файл для дальнейших задач.

Реализация хранилища и передачи TOTP на Python#

Для запуска потребуется стандартный OpenAI Python SDK, настроенный на Lovely Router API, и локальный генератор кодов RFC 6238. Один предоплаченный API-ключ Lovely Router открывает доступ к моделям Claude, GPT и Gemini, а также к браузерному агенту и инструментам сбора данных.

Установите зависимости:

Shell
pip install openai

Добавьте в окружение локальный драйвер для headless-браузера и локальную библиотеку для TOTP RFC 6238. В скрипте они импортируются как local_browser и local_totp.

Ниже приведен скрипт, который описывает схему инструментов, перехватывает переменные-плейсхолдеры до их отправки в браузер и автоматически обрабатывает нюансы с рассинхронизацией времени TOTP.

Python
import os
import time
import json
from openai import OpenAI
from local_browser import launch_headless_browser  # local headless browser driver
from local_totp import current_code  # local RFC 6238 generator

# Load secrets into memory; never pass these strings to the LLM
VAULT = {
    "{{VAULT_USER}}": os.environ["PORTAL_USERNAME"],
    "{{VAULT_PASS}}": os.environ["PORTAL_PASSWORD"],
}
TOTP_SEED = os.environ["PORTAL_TOTP_SEED"]

client = OpenAI(
    base_url="https://api.lovelyrouter.com/v1",
    api_key=os.environ["LOVELY_ROUTER_API_KEY"],
)

TOOLS = [
    {
        "type": "function",
        "function": {
            "name": "fill_input",
            "description": "Type text or a vault placeholder into an input field.",
            "parameters": {
                "type": "object",
                "properties": {
                    "selector": {"type": "string"},
                    "value": {
                        "type": "string",
                        "description": "Use {{VAULT_USER}} or {{VAULT_PASS}} for credentials.",
                    },
                    "press_enter": {"type": "boolean"},
                },
                "required": ["selector", "value"],
            },
        },
    },
    {
        "type": "function",
        "function": {
            "name": "inject_totp",
            "description": "Generate the current 6-digit 2FA code and type it into the selector.",
            "parameters": {
                "type": "object",
                "properties": {
                    "selector": {"type": "string"},
                },
                "required": ["selector"],
            },
        },
    },
    {
        "type": "function",
        "function": {
            "name": "click_element",
            "description": "Click a button or link by selector.",
            "parameters": {
                "type": "object",
                "properties": {
                    "selector": {"type": "string"},
                },
                "required": ["selector"],
            },
        },
    },
]

def generate_safe_totp(seed: str) -> str:
    """Wait for a fresh window if the current TOTP code expires in < 4 seconds."""
    remaining = 30 - (int(time.time()) % 30)
    if remaining < 4:
        time.sleep(remaining + 1)
    return current_code(seed)

def execute_tool(page, name: str, args: dict) -> str:
    if name == "fill_input":
        # Swap symbolic placeholder for the real secret outside the LLM context
        raw_val = args["value"]
        actual_val = VAULT.get(raw_val, raw_val)
        page.fill(args["selector"], actual_val)
        if args.get("press_enter"):
            page.press(args["selector"], "Enter")
        return f"Filled {args['selector']} with {raw_val}"

    if name == "inject_totp":
        code = generate_safe_totp(TOTP_SEED)
        page.fill(args["selector"], code)
        page.press(args["selector"], "Enter")
        return f"Injected 6-digit TOTP into {args['selector']} and submitted."

    if name == "click_element":
        page.click(args["selector"])
        return f"Clicked {args['selector']}"

    return "Unknown tool"

def run_login_agent(target_url: str, state_output_path: str):
    with launch_headless_browser() as browser:
        context = browser.new_context()
        page = context.new_page()
        page.goto(target_url)

        messages = [
            {
                "role": "system",
                "content": (
                    "You are a browser login agent. Log into the portal using "
                    "{{VAULT_USER}} and {{VAULT_PASS}}. When prompted for a 2FA "
                    "code, call inject_totp. Stop once the main dashboard loads."
                ),
            }
        ]

        for turn in range(6):
            # Extract a compact list of interactive elements for the model
            dom_snapshot = page.evaluate("""() => {
                const els = Array.from(document.querySelectorAll('input, button, a'));
                return els.map(e => ({
                    tag: e.tagName,
                    id: e.id ? '#' + e.id : '',
                    name: e.name || '',
                    type: e.type || '',
                    text: (e.innerText || e.placeholder || '').slice(0, 40)
                }));
            }""")

            messages.append({
                "role": "user",
                "content": f"URL: {page.url}\nElements: {json.dumps(dom_snapshot)}",
            })

            response = client.chat.completions.create(
                model="claude-sonnet-5.5",
                messages=messages,
                tools=TOOLS,
            )

            msg = response.choices[0].message
            messages.append(msg)

            if not msg.tool_calls:
                print("Login finished:", msg.content)
                break

            for call in msg.tool_calls:
                args = json.loads(call.function.arguments)
                result = execute_tool(page, call.function.name, args)
                messages.append({
                    "role": "tool",
                    "tool_call_id": call.id,
                    "content": result,
                })
            page.wait_for_timeout(1500)

        # Save authenticated session cookies for downstream tasks
        context.storage_state(path=state_output_path)
        browser.close()

if __name__ == "__main__":
    run_login_agent("https://portal.example.com/login", "auth_state.json")

В процессе execute_tool, когда модель заполняет {{VAULT_PASS}}, в историю сообщений записывается подтверждение: "Filled #password with {{VAULT_PASS}}". Ни пароль, ни 6-значная строка TOTP ни разу не попадают в массив messages.

Работа с другими видами 2FA: SMS, email и push-уведомления#

Не все сайты поддерживают аутентификаторы. Если устаревший портал требует SMS-код, magic link по email или push-уведомление, автоматизировать процесс без участия человека помогают три паттерна.

Для SMS-кодов перенаправьте телефонный номер аккаунта на программируемый номер через Cloud phone API. Предоставьте инструмент fetch_latest_sms_code, который опрашивает входящие сообщения по идентификатору отправителя, извлекает 6-значный код регулярным выражением и вводит его в активное поле браузера.

Для magic link и одноразовых кодов из писем привяжите аккаунт к почтовому ящику, к которому у бэкенда есть доступ по IMAP или через вебхуки. На экране «Проверьте вашу почту» агент вызывает инструмент wait_for_email_otp, получающий ссылку подтверждения или код из последнего письма.

Для push-подтверждений участие человека на физическом устройстве все еще необходимо. В этом случае держите сессию браузера открытой. Агент вводит логин и пароль, инициирует отправку push-уведомления и шлет вебхук в рабочий чат команды. Как только человек нажимает «Подтвердить», страница перенаправляется, и агент возобновляет работу.

Расход токенов и стоимость одного входа#

Вход за 5 шагов, при котором передаются компактные слепки DOM (около 4 000 входных токенов за шаг) и короткие JSON вызовов инструментов (около 300 выходных токенов за шаг), суммарно расходует 20 000 входных и 1 500 выходных токенов. Если повторять системный промпт и описания инструментов между шагами или прогонами, кэширование промптов (prompt caching) снизит затраты на повторяющиеся префиксы. В таблице ниже приведен базовый расчет стоимости одного «холодного» входа без учета кэширования.

При использовании claude-sonnet-5.5 ($2.00 за 1M входных токенов, $10.00 за 1M выходных токенов) один 5-шаговый прогон входа с 2FA стоит $0.055:

Статья расходовОбъемТарифСтоимость
Claude Sonnet 5.5 (входные)20,000 токенов (0.02M)$2.00 per 1M$0.040
Claude Sonnet 5.5 (выходные)1,500 токенов (0.0015M)$10.00 per 1M$0.015
Итого за один вход$0.055

Проходить полный сценарий 2FA при каждом сборе данных не требуется. Сохраните auth_state.json с помощью context.storage_state(), и фоновые скрипты смогут переиспользовать сессионные cookies в течение 24 часов. Вызывайте агента для 2FA-входа только раз в сутки, когда сессия истекает.

Если вы управляете 100 разными порталами и повторно авторизуетесь на каждом раз в день в течение 30 дней (3,000 входов в месяц), для стандартных форм логина можно выбрать более быструю и экономичную модель. Ежемесячные затраты на 3,000 прогонов авторизации (суммарно 60M входных и 4.5M выходных токенов) для трех моделей по одному API-ключу:

МодельВходные (60M токенов)Выходные (4.5M токенов)Итого в месяц (3,000 запусков)
Claude Sonnet 5.5 (claude-sonnet-5.5)$2.00 per 1M ($120.00)$10.00 per 1M ($45.00)$165.00
GPT-6.1 Terra (gpt-6.1-terra)$1.00 per 1M ($60.00)$5.00 per 1M ($22.50)$82.50
Gemini 3 Flash (gemini-3-flash)$0.50 per 1M ($30.00)$3.00 per 1M ($13.50)$43.50

Для стандартных форм входа отлично подойдут gemini-3-flash ($43.50 в месяц за 3,000 запусков) или gpt-6.1-terra ($82.50 в месяц). Переключайтесь на claude-sonnet-5.5 ($165.00 в месяц), только если сайт изменил верстку или выдал сложную нестандартную проверку. Полный каталог тарифов на модели доступен на странице тарифов.

Проверка конфигурации перед запуском в продакшн#

Перед запуском агента на продакшн-аккаунте со строгой политикой блокировок выполните три локальные проверки:

  1. Выведите в лог список messages прямо перед вызовом client.chat.completions.create() и убедитесь с помощью assert, что ни os.environ["PORTAL_PASSWORD"], ни os.environ["PORTAL_TOTP_SEED"] не присутствуют в сериализованной JSON-строке.
  2. Принудительно запустите generate_safe_totp() в момент, когда int(time.time()) % 30 == 28, и замерьте время выполнения. Убедитесь, что функция засыпает на 3 секунды и выдает код следующего окна, а не отправляет значение, которое протухнет в пути.
  3. Инициализируйте чистый контекст браузера через browser.new_context(storage_state="auth_state.json"), перейдите напрямую по URL авторизованной панели и убедитесь, что портал не перенаправляет обратно на /login.

Запустите своего первого агента для входа с 2FA#

Получите единый API-ключ, пополните баланс и подключите ваш скрипт к браузерному агенту. Автоматизируйте сценарии с аутентификацией без риска раскрыть секреты в промпте.

Попробуйте сами

Один предоплаченный ключ, без подписки. Каждая цена в статье — это цена, которую вы платите.

Читать дальше

Все статьи →