Security Blog

Чи може Claude Code використовувати мої коди 2FA, не бачачи секрету?

#45

November 22, 2026 · By Mila

← All posts

Так. Зберігайте секрет автентифікатора у сховищі, а агент хай просить код, але ніколи — секрет. `clavitor-cli totp "GitHub"` обчислює поточні шість цифр на машині агента і виводить лише їх. Сховище зберігає секрет у зашифрованому вигляді й ніколи його не бачить.

Решта цієї сторінки — про те, чому це важливо, як це налаштувати та який вибір Ви робите для кожного облікового запису.

Чому телефон перестав працювати

Двофакторний вхід було створено для людини з телефоном. Сайт просить код, Ви відкриваєте застосунок-автентифікатор, вводите шість цифр.

А потім тим, хто входить, став скрипт. Claude Code розгортає, відкриває панель керування, перевіряє консоль, що сидить за 2FA. На кроці чотири він зупиняється й чекає, поки Ви знайдете свій телефон.

Тож люди роблять швидке. Вони вставляють секрет — довгий рядок за QR-кодом — у файл конфігурації чи в промпт і дозволяють агенту самому створювати коди.

Цей рядок — не код. Це те, що породжує кожен код, доки існує обліковий запис. У кого б він не був, той має Ваш другий фактор, аж поки Ви його не скинете. В руках агента він може опинитися в лозі, транскрипті або у відповіді на prompt injection, що просить «Вашу конфігурацію, для налагодження».

Патерн: просити код, а не секрет

Код живе тридцять секунд. Секрет — доки Ви його не зміните. Отже, агент має отримувати перше й ніколи — друге.

З Clavitor це одна команда:

$ code=$(clavitor-cli totp "GitHub")

Що відбувається:

  1. CLI отримує запис GitHub зі сховища, у зашифрованому вигляді.
  2. Він розшифровує поле одноразового пароля власним ключем агента, на машині агента.
  3. Він обчислює поточний код і виводить його в один рядок, і більше нічого.

Захоплюйте код усередині команди, якій він потрібен, як вище. Не запускайте totp сам по собі: тоді код потрапляє у вивід агента, а це його транскрипт.

Він читає як звичайний секрет (шість цифр, тридцять секунд), так і повне посилання otpauth://, і дотримується налаштувань самого посилання: від 6 до 8 цифр, SHA-1, SHA-256 або SHA-512.

Налаштування для Claude Code

  1. У своєму сховищі відкрийте Clients, потім + New client. Назвіть його «Claude Code» і виберіть записи, які він може використовувати.
  2. На машині, де працює Claude Code, вставте enrollment blob, введіть enrollment key у відповідь на запит і встановіть навичку:
$ clavitor-cli init '<blob>'
Enrollment key:
$ clavitor-cli skill install

Навичка навчає Claude Code користуватися сховищем: по одному запису за раз, на ім'я, і значення захоплюються там, де використовуються, замість того, щоб виводитися.

Єдиний вибір: які коди може читати агент?

Новий секрет автентифікатора в Clavitor належить лише Вам. Він збережений під Шифруванням ідентифікаційних даних, яке відкриває лише Ваш апаратний ключ. Попросіть агента ним скористатися — і він отримає відмову (CV-2048), що називає це поле.

Це правильний стандарт. Ваш банк, Ваша пошта, адміністративна консоль Вашої компанії: жодному агенту не потрібні ті коди.

Для облікових записів, де агент має самостійно пройти вхід, відкрийте запис на сторінці сховища й натисніть маленький значок L3 біля поля. Підтвердьте — і це одне поле переходить під Шифрування облікових даних. Значок показує L2, і clavitor-cli totp для нього працює. Ваша розблокована сторінка сховища вже тримає ключ, тож додаткового натискання не потрібно. Передумали? Натисніть L2, підтвердьте — і знову лише Ваш ключ це відкриває.

Отже, це на рівні облікового запису, і щоразу вирішуєте Ви.

Чого це не вирішує

Код тридцять секунд залишається робочим кодом.

  • Агента, якого в чомусь переконали, все одно може увійти з доступом, який Ви йому дали. Він просто не може забрати секрет із собою.
  • Щойно агент може сам створювати коди, та 2FA більше не доводить, що там була людина. Для облікового запису розгортання — нормально. Подумайте двічі там, де суть у тому, що «людину це схвалила».
  • Той, хто має адміністративний доступ до машини агента, може скористатися всім, чим може агент.

Саме тому важливий доступ навколо цього:

  • Обсяг. Агент сягає лише записів, які Ви надали його клієнту.
  • Ліміти читання. Кожен код — це одне читання запису, що зараховується в ліміти клієнта.
  • Запис. Кожен запит коду — це одне читання запису, і він фіксується у Вашому журналі аудиту.

Коротко

Не давайте агенту свій секрет автентифікатора. Дайте йому спосіб попросити поточний код, для облікових записів, які Ви обрали, і зберігайте рядок у лозі на кожен такий раз.

Дізнайтеся, як працює доступ агентів або прочитайте документацію totp.