51.5.2. API-токены

⁠51.5.2. API-токены

Любой аутентифицированный пользователь может генерировать API-токены, которые, в свою очередь, можно использовать для настройки клиентов резервного копирования вместо прямого указания имени пользователя и пароля.

Назначение API-токенов:

простой отзыв в случае компрометации клиента;
возможность ограничить разрешения для каждого клиента/токена в рамках разрешений пользователей.

Генерация API-токена в веб-интерфейсе:

API-токен состоит из двух частей:

идентификатор (Token ID), который состоит из имени пользователя, области и имени токена (user@realm!имя токена);
секретное значение.

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

Примечание

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

Создание API-токена в консоли:

# proxmox-backup-manager user generate-token backup_u@pbs client1
Result: {
  "tokenid": "backup_u@pbs!client1",
  "value": "ff13e5e0-30df-4a70-99f1-c62b13803769"
}