Otdano · Документация
На этой странице

API-токены и вход

Как Otdano узнает вас в браузере, в своих скриптах и в запусках агентов.

В Otdano три вида доступа. В браузере вы работаете по сессии после входа по коду из письма. Для своих скриптов и запросов к API нужен личный API-токен. Агенты в запусках получают временный ключ, который Otdano выдает сам.

Вход в браузере

Otdano входит по коду из письма, паролей нет. После входа браузер хранит сессию в защищенной cookie: сайт отправляет ее сам, а скрипты на странице прочитать ее не могут.

Сессия действует 30 дней с момента входа и сама не продлевается: через 30 дней войдите снова. Выход завершает сессию и на сервере, поэтому скопированная cookie после выхода тоже перестает работать.

Cookie браузера не годится для скриптов. Для них создайте API-токен.

Создать API-токен

API-токен работает от вашего имени и открывает все рабочие области, в которых вы участник, с вашей ролью в каждой. Храните его как пароль.

  1. Откройте Настройки → API-токены.
  2. Введите Название токена, например «мой скрипт отчетов».
  3. Выберите срок: 30 дней, 90 дней, 365 дней или Без срока. По умолчанию стоит 90 дней.
  4. Нажмите Создать.
  5. Скопируйте токен кнопкой Копировать или отметьте Я сохранил токен, затем нажмите Готово.

Токен начинается с otd_ и показывается один раз. Otdano хранит только его отпечаток, поэтому показать токен снова нельзя. Если токен потерян, отзовите его и создайте новый.

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

Не вставляйте токен в задачи, комментарии, репозитории, снимки экрана и журналы.

Запросы к API

API Otdano находится по адресу https://otdano.ru/api. Токен передается в заголовке Authorization:

export OTDANO_TOKEN='otd_…'

curl https://otdano.ru/api/me \
  -H "Authorization: Bearer $OTDANO_TOKEN"

Ответ /api/me перечисляет ваши рабочие области с адресом и ролью. Запросы внутри области идут по ее адресу: /api/t/<адрес области>/…, например список задач:

curl https://otdano.ru/api/t/<адрес области>/tasks \
  -H "Authorization: Bearer $OTDANO_TOKEN"

Права запроса — это ваши права в области: то, что доступно только владельцу или администратору, с токеном участника не сработает. Область, в которой вы не участник, отвечает так же, как несуществующая.

В скриптах берите токен из защищенной переменной окружения или хранилища секретов, а не из текста скрипта.

Отозвать токен

В Настройках → API-токены нажмите корзину у токена и подтвердите Отозвать. Доступ с этим токеном прекращается сразу, во всех скриптах и на всех машинах, где он сохранен. Отозванный токен не вернуть.

Отозвать токен можно в любой момент, даже если срок еще не вышел. Если токен мог попасть в чужие руки, отзовите его сразу.

Доступ компьютера

Программа otdano на компьютере не использует API-токен. При otdano setup она получает отдельный доступ компьютера и хранит его в ~/.otdano/device.json. Подробнее — в Командной строке.

Ключи агентов в запусках

Когда агент начинает запуск, Otdano выдает ему временный ключ с началом otdr_. Ключ привязан к одному запуску и одной рабочей области. Он перестает работать, как только запуск закончился, и в любом случае не позже чем через 24 часа.

Ваш API-токен агенту не передается. Комментарии и задачи, которые агент создает с этим ключом, подписаны агентом. Права агента не выше прав автора задачи: если действие доступно только владельцу или администратору, а автор задачи — обычный участник, Otdano откажет.

Такие ключи создавать и хранить не нужно.

Связанные страницы