# Безопасность и приватность CLI amoCRM (/ru/docs/amo/security)

Дайте ИИ-агенту свою CRM, не отдавая ему токен и номера телефонов ваших клиентов. Токен действует с правами
администратора, поэтому `amo` хранит его там, где его не прочитают ни вывод, ни лог, ни агент.

Ваш агент работает с вашими сделками и никогда не видит токен. Каждый запуск записывается со скрытыми секретами и
номерами телефонов, поэтому потом можно проверить, что делал агент.

Связка ключей, разрешения, MCP и логи работают одинаково во всех инструментах WireCat, как описано на
[общей странице о безопасности](/llms.mdx/docs/ru/security/content.md). `amo` добавляет свое: токен amoCRM, хосты, к
которым он обращается, и вход из браузера по MCP.

**На этой странице:**

1. [Токен и аккаунт](#the-token-and-the-account)
2. [Телефоны и почта клиентов](#clients-phones-and-e-mails)
3. [api call](#api-call)
4. [MCP в браузере](#mcp-in-the-browser)
5. [Записи запусков](#run-records)
6. [Файлы настроек](#settings-files)

## Токен и аккаунт [#токен-и-аккаунт]

`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), как показано в разделе
[установка и подключение](/llms.mdx/docs/ru/amo/installation/content.md#sign-out-and-revoke-access).

## Телефоны и почта клиентов [#телефоны-и-почта-клиентов]

Контакт или компания из ваших собственных сделок приходит с телефонами и почтой. Пользователь, который не
администратор, видит их не больше чем у 100 других контактов и компаний в день, на пользователя и его агентов вместе.
Счетчик хранится на этом компьютере: он остановит случайность или агента, но не того, кто хочет забрать базу.

Звонок, скопированный с настройкой activities, хранит только направление, но не номер телефона и не запись. Утренняя
сводка скрывает номера телефонов и адреса почты и никогда не печатает текст примечания.

## api call [#api-call]

`api call` достает до любой операции amoCRM API v4, поэтому у него больше проверок, чем у команды. Он проверяет
собственный ключ разрешения операции и ключ команды, которая делает то же самое. Чтение контактов, компаний,
примечаний, событий или неразобранного доступно только администратору, потому что в них телефоны и почта клиентов.
Ссылка с токеном доступа в ответе удаляется до того, как вы ее увидите. `api call` никогда не предлагается через MCP.

## 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](https://github.com/WireCatLabs/amo-cli/blob/main/SECURITY.md).
