Управление API-ключами сервера¶
В этой статье
Информация
API-ключ — это удобный способ авторизации для работы с API-запросами к Invapi, а также для открытия Панели управления конкретного сервера, которую вы можете использовать в отрыве от вашего центра управления и личного кабинета.
Ключ доступа к API генерируется в личном кабинете панели управления Invapi для доступа ко всему аккаунту или к конкретному серверу.
Для получения ключа для конкретного сервера нужно следовать следующим инструкциям:
Получение API-ключа для конкретного сервера¶
-
Зайдите в Invapi
-
Выберите сервер для которого хотите получить внешнюю панель управления сервером: Мои серверы >> Нужный сервер
-
Создайте API-ключ:
- Зайдите во вкладку Информация и выберите вкладку Ключи API и панель управления;
- Нажмите кнопку
Добавить новый;
- Введите имя ключа для его идентификации в поле Название ключа;
- В поле IP ACL укажите IP-адреса с которых будет разрешен доступ по этому ключу или оставьте его пустым для доступа без ограничений;
- Отметьте чекбокс Активный для активации ключа;
- Нажмите кнопку
Создать.
После этого вам будет показан API-ключ.
Внимание
Ключ будет показан только один раз. Обязательно скопируйте и сохраните значение API-ключа. В Invapi хранится только его хэш-значение и если исходный ключ будет утрачен, то его надо будет создать заново!
Редактирование/удаление API-ключа¶
Для редактирования или удаления API-ключа зайдите или в аккаунт или на конкретный сервер, как описано выше при его генерации и кликните на нужный API-ключ.В открывшемся окне во вкладке Общая информация вы можете:
- изменить имя ключа (поле Название ключа);
- задать IP-адреса, с которых будут запрещены вызовы с его использованием (поле IP ACL);
- включить или временно отключить его (чекбокс Активный).
Далее вы можете нажать на кнопку Сохранить ключ API с сохранить изменения.
Для удаления API-ключа нажмите на кнопку Удалить ключ API
Внимание
API-ключ удаляется без возможности его восстановления.
Использование API-ключа¶
API ключ можно использовать следующим образом:
-
Для авторизации в Invapi и получения сессионного токена, необходимого для последующих API-запросов к аккаунту или серверу. Авторизацию через API-ключ можно получить для доступа как ко всему аккаунту, так и к конкретному серверу через вызов auth/login в зависимости от применяемого API-ключа. Если авторизация прошла успешно и такой ключ найден в базе данных, то система вернет сессионный токен
$HOSTKEY_TOKEN. -
Для запуска Панели управления сервером, которая может быть использована для предоставления доступа к серверу без необходимости входа в ваш аккаунт центра управления Invapi, а также как отдельный модуль для встраивания в свою биллинговую систему для управления серверами HOSTKEY. Для этого вам необходимо сгенерировать API-ключи для конкретных серверов:
Просмотр информации об использовании API-ключа¶
Выбрав конкретный ключ для аккаунта или конкретного сервера и кликнув на него, во вкладке История использования вы можете посмотреть все логины, произведенные с данным API-ключом за определенный период времени. В выводе будет указан e-mail и IP адрес, с которого производился логин, его успешность, а также дата и время события.
Получение API-ключа без веб-панели¶
Вы также можете получить API-ключ, не использую веб панель управления. Для этого вам необходимо использовать API методы работы с API-ключами. Данные методы можно вызывать из командной строки или встраивать вызовы в ваши веб-решения.