Как автоматизировать вход с 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 на части слов. Модели могут галлюцинировать или менять символы местами при воспроизведении случайных строк.
Решение — провести строгую границу между рассуждениями модели и хранением учетных данных:
- Храните имя пользователя, пароль и
TOTP_SECRETв переменных окружения или в менеджере секретов. - Передавайте модели символические плейсхолдеры, такие как
{{VAULT_USERNAME}}и{{VAULT_PASSWORD}}. Когда модель выдает действиеfillс плейсхолдером, локальная обертка выполнения подменяет его на реальное значение непосредственно перед отправкой события в браузер. - Предоставьте модели инструмент
fill_totp_code, принимающий только ID целевого элемента. Инструмент генерирует 6-значный код RFC 6238 в памяти и вводит его в поле, вообще не возвращая сами цифры в LLM.
Разбор реального сценария входа с 2FA#
Возьмем типовую рутинную задачу: войти на портал вендора (например, GitHub или биллинг) и скачать CSV-файл со счетом за месяц. Портал требует двухэтапный ввод учетных данных, затем запрос TOTP, а иногда показывает промежуточный экран «Доверять этому браузеру?».
Полный прогон с браузерным агентом Lovely Router и моделью claude-sonnet-5.5 занимает пять шагов:
- Переход на страницу и поиск поля логина. Агент загружает
https://portal.example.com/login. Он читает дерево доступности, находит поле ввода email (#login_field) и генерирует действие для заполнения{{VAULT_USERNAME}}. Если поле пароля находится на том же экране, он заполняет{{VAULT_PASSWORD}}и нажимает кнопку отправки за один шаг. - Обработка запроса 2FA. Страница переходит на
/sessions/two-factor. Агент анализирует новый DOM, обнаруживает поле ввода 6-значного кода подтверждения (#app_totp) и вызывает инструментtype_totp, передавая ему селектор цели. - Проверка временного окна TOTP и отправка. Перед генерацией кода локальный инструмент проверяет, сколько секунд осталось до конца текущего 30-секундного окна TOTP. Если осталось менее 4 секунд, инструмент делает паузу до начала следующего интервала, чтобы код не истек прямо во время отправки формы. Затем он вводит 6 цифр и отправляет форму.
- Закрытие промежуточного экрана. Портал отображает запрос «Запомнить это устройство на 30 дней». Хрупкий скрипт на базе жестких CSS-селекторов здесь бы упал, если бы экран появился только после истечения cookies. Агент же считывает кнопки, выбирает «Не запоминать» (что логично для эфемерной сессии браузера в облаке) и переходит в основную панель управления.
- Сохранение состояния сессии. Как только агент подтверждает, что заголовок панели управления виден, скрипт-обертка экспортирует
storageStateбраузера (cookies иlocalStorage) в зашифрованный файл для дальнейших задач.
Реализация хранилища и передачи TOTP на Python#
Для запуска потребуется стандартный OpenAI Python SDK, настроенный на Lovely Router API, и локальный генератор кодов RFC 6238. Один предоплаченный API-ключ Lovely Router открывает доступ к моделям Claude, GPT и Gemini, а также к браузерному агенту и инструментам сбора данных.
Установите зависимости:
pip install openaiДобавьте в окружение локальный драйвер для headless-браузера и локальную библиотеку для TOTP RFC 6238. В скрипте они импортируются как local_browser и local_totp.
Ниже приведен скрипт, который описывает схему инструментов, перехватывает переменные-плейсхолдеры до их отправки в браузер и автоматически обрабатывает нюансы с рассинхронизацией времени TOTP.
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 в месяц), только если сайт изменил верстку или выдал сложную нестандартную проверку. Полный каталог тарифов на модели доступен на странице тарифов.
Проверка конфигурации перед запуском в продакшн#
Перед запуском агента на продакшн-аккаунте со строгой политикой блокировок выполните три локальные проверки:
- Выведите в лог список
messagesпрямо перед вызовомclient.chat.completions.create()и убедитесь с помощью assert, что ниos.environ["PORTAL_PASSWORD"], ниos.environ["PORTAL_TOTP_SEED"]не присутствуют в сериализованной JSON-строке. - Принудительно запустите
generate_safe_totp()в момент, когдаint(time.time()) % 30 == 28, и замерьте время выполнения. Убедитесь, что функция засыпает на 3 секунды и выдает код следующего окна, а не отправляет значение, которое протухнет в пути. - Инициализируйте чистый контекст браузера через
browser.new_context(storage_state="auth_state.json"), перейдите напрямую по URL авторизованной панели и убедитесь, что портал не перенаправляет обратно на/login.
Запустите своего первого агента для входа с 2FA#
Получите единый API-ключ, пополните баланс и подключите ваш скрипт к браузерному агенту. Автоматизируйте сценарии с аутентификацией без риска раскрыть секреты в промпте.
Попробуйте сами
Один предоплаченный ключ, без подписки. Каждая цена в статье — это цена, которую вы платите.
Читать дальше
Все статьи →
Заполнение откликов на вакансии с помощью AI-агента
Автономный браузерный агент для многоэтапных форм вакансий: загрузка резюме и ответы на вопросы.

Мониторинг трендов TikTok в нише каждое утро
Собирайте поиск и хештеги TikTok по расписанию, извлекайте транскрипты и комментарии, а также оценивайте стоимость недели отслеживания.

Веб-поиск и браузер для Claude Code одной командой
Подключите удаленный MCP-сервер к Claude Code одной командой: поиск в сети, краулинг страниц и скриншоты по единому предоплаченному API-ключу.