Аккаунт
Регистрация, вход, профиль и организация — что платформа помнит об аккаунте, что из этого меняется в консоли и что нельзя изменить самому.
Заведите аккаунт
Для регистрации нужны только адрес почты и пароль. Ставить ничего не нужно, карту никто не спрашивает, и ключ можно выпустить сразу после неё.
- Откройте консольЭто отдельный хост продукта, и все операции с аккаунтом живут там.
- Укажите адрес и парольНе короче **6 символов**; верхняя граница — 256 **байт** UTF-8. Нижняя граница считает символы, поэтому шесть букв — это шесть букв в любом алфавите. Верхняя считает байты, потому что она ограничивает работу хеширования, а буква кириллицы стоит два байта: 256 байт — это 128 кириллических букв.
- Примите два согласияУсловия публичной оферты и отдельное согласие на обработку персональных данных. Оба обязательны, и форма проверяет каждое согласие отдельно; [сами документы](https://kumorouter.com/legal) лежат на основном сайте.
- Вы уже внутриТот же ответ, что создаёт аккаунт, выпускает и сессию: консоль ставит себе куку и открывает обзор, входить отдельно не нужно.
Одной транзакцией создаются три вещи: пользователь, его личная организация и её финансовые умолчания. Организация появляется сама, заводить её отдельно не нужно, и дальше именно она — владелец всего, что вы выпустите и потратите.
Адрес сравнивается без учёта регистра, поэтому адрес, отличающийся только регистром букв, уже занят.
Письмо с подтверждением адреса приходит своим чередом, и его ссылка удостоверяет, что адрес ваш. Сегодня этим всё и исчерпывается: подтверждение не открывает ни одной двери, неподтверждённый аккаунт входит и работает. Ссылка живёт сутки и срабатывает один раз, а на любую отклонённую ссылку приходит один и тот же ответ; за новым письмом идите в консоль — она отправит его на адрес текущей сессии.
Первый вызов за три минуты → Выпустить ключ →
Вход, выход и пароль
Вход проверяет пару «адрес и пароль» и выдаёт сессию в куке. Неизвестный адрес и неверный пароль — один и тот же отказ и одна и та же фраза: любая видимая разница между ними сказала бы постороннему, какие адреса у вас зарегистрированы.
По той же причине запрос на восстановление пароля отвечает одинаково всегда — и когда у адреса есть аккаунт, и когда нет. Письмо уходит только в первом случае, но со стороны формы эти два случая неразличимы. Ссылка из письма действует тридцать минут и срабатывает один раз.
Смена пароля в настройках проверяет текущий пароль до того, как что-либо меняется, и завершает все сессии — включая ту, из которой вы её делаете. Это ровно то поведение, которого от смены пароля и ждут: если пароль сменили потому, что старый утёк, чужая открытая вкладка обязана перестать работать в ту же секунду. Восстановление пароля по письму делает то же самое.
Выход отзывает сессию, которую называет кука, и стирает саму куку. Он про одно устройство; чтобы завершить все, меняйте пароль.
Профиль
Профиль — это четыре поля, и все они правятся в настройках консоли.
Юзернейм
От 5 до 32 символов: латинские буквы, цифры и нижнее подчёркивание. Начинается с буквы, заканчивается буквой или цифрой, двух подчёркиваний подряд в нём не бывает. Ведущая собака принимается и отбрасывается, хранится юзернейм в нижнем регистре.
Заменить его можно два раза за всю жизнь аккаунта, и консоль показывает, сколько замен осталось. Когда обе истрачены, юзернейм меняет только поддержка — и её замена вашего счётчика не тратит. Часть юзернеймов зарезервирована платформой и занята не другим аккаунтом, а ею самой.
Почта
Адрес меняется здесь же. Новый адрес после смены не подтверждён, пока вы не откроете ссылку из нового письма, — консоль сама предложит его отправить. Работать это не мешает, но почта об аккаунте теперь идёт на новый адрес, поэтому опечатка в нём стоит дороже опечатки где-либо ещё в профиле.
Как устроена консоль
Три предпочтения, и разница между ними важнее, чем кажется.
- Тема — светлая, тёмная или системная.
- Язык интерфейса — только консоль. Выбор не уезжает на другие хосты Kumo: у этой документации свой переключатель в шапке.
- Валюта отображения — в чём консоль печатает цены и баланс. Это витрина, а не счёт: оплата в любом случае проходит в рублях, а внутренняя учётная единица одна и не меняется вместе с этим переключателем.
Организация
Аккаунт входит в консоль, но платит и владеет всем не он, а его организация.
- Ключ выпускается организации, а не пользователю: любой вызов, который ключ аутентифицирует, считается и тратится за ней.
- Кошелёк принадлежит организации, и пакет — тоже: он один на весь аккаунт.
- Лог вызовов, движения средств и потребление читаются по организации целиком. Ни у одной из этих операций нет селектора «чей»: областью всегда является организация текущей сессии.
- Проекты — ярлык внутри организации, которым ключи группируются между собой.
Чем платит ключ → Как группируются ключи →
Удаление аккаунта
Удаление аккаунта не происходит по нажатию кнопки и по устройству процесса произойти не может: запрос создаёт заявку на рассмотрение и никогда не обезличивает аккаунт сам. Заявка проходит три состояния — принята, одобрена, применена, — и консоль показывает, в каком она сейчас.
Самостоятельного удаления пока нет, и консоль говорит это прямо: заявка обрабатывается руками. Напишите в поддержку с того адреса, на который зарегистрирован аккаунт, — ответ придёт по почте. Ключи выключают после подтверждения, остаток кошелька возвращают.