Чи може Claude Code використовувати мої коди 2FA, не бачачи секрету?
Так. Зберігайте секрет автентифікатора у сховищі, а агент хай просить код, але ніколи — секрет. `clavitor-cli totp "GitHub"` обчислює поточні шість цифр на машині агента і виводить лише їх. Сховище зберігає секрет у зашифрованому вигляді й ніколи його не бачить.
Решта цієї сторінки — про те, чому це важливо, як це налаштувати та який вибір Ви робите для кожного облікового запису.
Чому телефон перестав працювати
Двофакторний вхід було створено для людини з телефоном. Сайт просить код, Ви відкриваєте застосунок-автентифікатор, вводите шість цифр.
А потім тим, хто входить, став скрипт. Claude Code розгортає, відкриває панель керування, перевіряє консоль, що сидить за 2FA. На кроці чотири він зупиняється й чекає, поки Ви знайдете свій телефон.
Тож люди роблять швидке. Вони вставляють секрет — довгий рядок за QR-кодом — у файл конфігурації чи в промпт і дозволяють агенту самому створювати коди.
Цей рядок — не код. Це те, що породжує кожен код, доки існує обліковий запис. У кого б він не був, той має Ваш другий фактор, аж поки Ви його не скинете. В руках агента він може опинитися в лозі, транскрипті або у відповіді на prompt injection, що просить «Вашу конфігурацію, для налагодження».
Патерн: просити код, а не секрет
Код живе тридцять секунд. Секрет — доки Ви його не зміните. Отже, агент має отримувати перше й ніколи — друге.
З Clavitor це одна команда:
$ code=$(clavitor-cli totp "GitHub")
Що відбувається:
- CLI отримує запис GitHub зі сховища, у зашифрованому вигляді.
- Він розшифровує поле одноразового пароля власним ключем агента, на машині агента.
- Він обчислює поточний код і виводить його в один рядок, і більше нічого.
Захоплюйте код усередині команди, якій він потрібен, як вище. Не запускайте totp сам по собі: тоді код потрапляє у вивід агента, а це його транскрипт.
Він читає як звичайний секрет (шість цифр, тридцять секунд), так і повне посилання otpauth://, і дотримується налаштувань самого посилання: від 6 до 8 цифр, SHA-1, SHA-256 або SHA-512.
Налаштування для Claude Code
- У своєму сховищі відкрийте Clients, потім + New client. Назвіть його «Claude Code» і виберіть записи, які він може використовувати.
- На машині, де працює 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.