Какво представлява това?
Този интерфейс в WHM ви позволява да създавате, разглеждате, редактирате и изтривате API токени. Също така можете да зададете какви права (ACL – Access Control List) да има всеки токен. С помощта на тези токени може да се осъществи връзка с WHM чрез външни програми или скриптове – например ако дадете на разработчик или реселър достъп до вашите данни по сигурен начин.
Важно: Задаването на ограничения чрез ACL все още е в експериментален етап и може да се промени в бъдеще.
Къде могат да се използват токените?
В момента API токени могат да се използват само за:
- WHM API функции
- DNS клъстери
- Конфигурационни клъстери
ℹ️ Ако промените потребителското име на cPanel акаунт, токените ще продължат да работят. Но ако изтриете акаунта – токените се премахват автоматично. Не може да създавате токени за спрени акаунти.
Таблица с токени
За да виждате и използвате тази част, трябва да сте активирали всички основни привилегии за реселъри в WHM.
Тук виждате списък с всичките си API токени. Може да:
- Търсите токени по име
- Обновявате списъка с бутона зъбно колело (⚙️)
В таблицата ще намерите:
- Име на токена
- Дата на създаване
- Срок на валидност (ако има такъв)
- IP адреси, от които токенът може да се използва (може да е един адрес, мрежа или “Any” за всички адреси)
Токени, които ще изтекат скоро, се маркират в жълто.
Изтеклите токени – в червено.
Изтеклите токени не се изтриват автоматично – трябва да ги премахнете ръчно.
Създаване на нов API токен
- Натиснете Generate Token.
- Въведете уникално име (до 50 символа; позволени са букви, цифри, тирета и долни черти).
- Изберете дали токенът:
- Да не изтича никога
- Да изтича на определена дата – избирате от календар или въвеждате ръчно (във формат YYYY-MM-DD).
- В полето IPs въведете адресите, от които ще се използва токенът. Може да оставите празно, ако искате да се използва от всякъде.
- Изберете какви права (ACL) ще има токенът. Премахнете отметките за функциите, които не искате да позволите.
Бъдете внимателни с някои от правата:
- Everything – дава пълен достъп до системата.
- Change Password – позволява смяна на пароли.
- Create User Session и Manage API Tokens – позволяват заобикаляне на някои ограничения.
- Натиснете Generate. Ще видите самия токен (в хеширан вид), името и датата му на изтичане.
- Запазете токена на сигурно място – няма да можете да го видите отново!
- Потвърдете с бутона Yes, I saved my token.
Редактиране на API токен
- Намерете токена в списъка.
- Кликнете на Edit.
- Направете желаните промени и натиснете Save.
Не забравяйте: трябва да оставите поне една активна привилегия за токена.
Премахване (Revoke) на API токен
Ако изтриете токен, всяко приложение или скрипт, който го използва, ще спре да работи.
- Намерете токена и натиснете Revoke.
- Потвърдете с Continue.
Ако искате да изтриете всички токени:
- Натиснете зъбното колело (⚙️) и изберете Revoke All.