Безопасность и приватность CLI amoCRM
Что хранит CLI для amoCRM, где лежит токен, куда он обращается и что скрывает запись запуска.
Дайте ИИ-агенту свою CRM, не отдавая ему токен и номера телефонов ваших клиентов. Токен действует с правами
администратора, поэтому amo хранит его там, где его не прочитают ни вывод, ни лог, ни агент.
Ваш агент работает с вашими сделками и никогда не видит токен. Каждый запуск записывается со скрытыми секретами и номерами телефонов, поэтому потом можно проверить, что делал агент.
Связка ключей, разрешения, MCP и логи работают одинаково во всех инструментах WireCat, как описано на
общей странице о безопасности. amo добавляет свое: токен amoCRM, хосты, к
которым он обращается, и вход из браузера по MCP.
На этой странице:
Токен и аккаунт
amo хранит настройки в config.json, а состояние в папках, которые показывает amo doctor. session start
сохраняет долгосрочный токен и адрес аккаунта в связке ключей системы (служба amo-cli, учетная запись
token:<profile>), а где она не работает, в закрытом файле. Вход через интеграцию хранится там же (учетная запись
oauth:amocrm:<profile>): ID и секретный ключ интеграции, токен доступа и refresh-токен. Токен уходит только в
заголовок Authorization запроса и никогда не попадает в адрес, ответ, запись запуска или журнал отправок. amo
обращается только к аккаунту, в который вы вошли, на хосте под amocrm.ru, amocrm.com или kommo.com, и никогда
не идет по перенаправлению. В amoCRM нет вызова, который отзывает токен. После утечки отзовите его на вкладке
интеграции «Выданные доступы» (в Kommo Authorization), как показано в разделе
установка и подключение.
Телефоны и почта клиентов
Контакт или компания из ваших собственных сделок приходит с телефонами и почтой. Пользователь, который не администратор, видит их не больше чем у 100 других контактов и компаний в день, на пользователя и его агентов вместе. Счетчик хранится на этом компьютере: он остановит случайность или агента, но не того, кто хочет забрать базу.
Звонок, скопированный с настройкой activities, хранит только направление, но не номер телефона и не запись. Утренняя сводка скрывает номера телефонов и адреса почты и никогда не печатает текст примечания.
api call
api call достает до любой операции amoCRM API v4, поэтому у него больше проверок, чем у команды. Он проверяет
собственный ключ разрешения операции и ключ команды, которая делает то же самое. Чтение контактов, компаний,
примечаний, событий или неразобранного доступно только администратору, потому что в них телефоны и почта клиентов.
Ссылка с токеном доступа в ответе удаляется до того, как вы ее увидите. api call никогда не предлагается через MCP.
MCP в браузере
amo work mcp serve --http слушает только 127.0.0.1, для приложений в браузере, которые приходят к нему через ваш
собственный туннель. Каждое приложение входит одноразовым кодом, а сервер хранит хеш каждого входа, который выдал,
в папке состояния, доступной только вам. amo work mcp revoke забывает их все.
Записи запусков
Запись запуска хранит командную строку так, как вы ее набрали, поэтому amo runs show показывает, что запускали.
Секрет при этом все равно хранится как [redacted]: параметр с именем вроде token или password, пароль в ссылке,
длинная непрозрачная строка. Номер телефона заменяется на [redacted] внутри набранного слова, в том числе в тексте
сообщения: номер с "+" и кодом страны или от 11 до 15 цифр подряд, поэтому длинный id такой длины тоже скрывается.
Чтобы не хранить набранные слова совсем, выполните amo work config set record_input false.
Секрет узнается и по виду, в записи запуска и в сохраненном сообщении об ошибке: токен известного формата (GitHub,
OpenAI, Slack, AWS, Stripe, npm и подобные), учетные данные Bearer, случайная на вид строка из 20 и более символов
и случайная на вид последовательность из 20 и более шестнадцатеричных символов в нижнем регистре, например
шестнадцатеричный ключ или полный хеш коммита. Значение после имени секрета тоже скрывается, идет ли оно после =,
: или пробела: password=, API_TOKEN=, password hunter2, pin 1234. Некоторые секреты похожи на обычные
слова и остаются: значение только из букв после имени секрета и пробела (pin this message остается),
шестнадцатеричный ключ в верхнем регистре, короткий хеш коммита или UUID, короткий пароль, набранный без имени
секрета перед ним, и секрет внутри ссылки или пути к файлу, если он не в известном формате и не идет после имени
секрета.
Файлы настроек
config.json сохраняется доступным для чтения только вам (0600), а его папка создается только для вас (0700).
Файл или папка, созданные старой версией, могут быть открыты другим пользователям компьютера: amo doctor перечисляет
каждый в files.problems и печатает chmod, который это исправляет. Windows не проверяется. Об уязвимости сообщайте,
как сказано в SECURITY.md.