API marķieri
Pārskats
Šajā sadaļā var izveidot un pārvaldīt API pilnvaras.
API pilnvaras tiek izmantotas autentifikācijai Zabbix API.
Katra API pilnvara tiek piešķirta vienam lietotājam un pārmanto šī lietotāja atļaujas.
Ar API pilnvaru autentificēti pieprasījumi tiek autorizēti atbilstoši saistītā lietotāja lomai un atļaujām.
API pilnvaras var filtrēt pēc nosaukuma, lietotājiem, kuriem pilnvaras ir piešķirtas, derīguma termiņa, lietotājiem, kuri izveidojuši pilnvaras, vai statusa (iespējota/atspējota). Noklikšķiniet uz pilnvaras statusa sarakstā, lai ātri iespējotu/atspējotu pilnvaru. Varat arī masveidā iespējot/atspējot pilnvaras, sarakstā tās atlasot un pēc tam noklikšķinot uz pogas Enable/Disable zem saraksta.
Lai izveidotu jaunu pilnvaru, augšējā labajā stūrī noklikšķiniet uz pogas Create API token, pēc tam pilnvaras konfigurācijas ekrānā aizpildiet obligātos laukus:
| Parameter | Description |
|---|---|
| Name | Pilnvaras redzamais nosaukums. |
| User | Lietotājs, kuram jāpiešķir pilnvara. Lai ātri atlasītu lietotāju, sāciet rakstīt lietotājvārdu, vārdu vai uzvārdu, pēc tam automātiskās pabeigšanas sarakstā atlasiet vajadzīgo lietotāju. Varat arī noklikšķināt uz pogas Select un atlasīt lietotāju pilnajā lietotāju sarakstā. Pilnvaru var piešķirt tikai vienam lietotājam. |
| Description | Neobligāts pilnvaras apraksts. |
| Set expiration date and time | Noņemiet atzīmi no šīs izvēles rūtiņas, ja pilnvarai nedrīkst būt derīguma termiņa. |
| Expiry date | Noklikšķiniet uz kalendāra ikonas, lai atlasītu pilnvaras derīguma termiņu, vai ievadiet datumu manuāli formātā YYYY-MM-DD hh:mm:ss |
| Enabled | Noņemiet atzīmi no šīs izvēles rūtiņas, ja pilnvara jāizveido atspējotā stāvoklī. |
Noklikšķiniet uz Add, lai izveidotu pilnvaru.
Nokopējiet Auth token vērtību un saglabājiet to drošā vietā pirms lapas aizvēršanas, pēc tam noklikšķiniet uz Close. Pilnvara tiks parādīta sarakstā.
Auth token vērtību vēlāk vairs nevarēs apskatīt. Tā ir pieejama tikai uzreiz pēc pilnvaras izveides. Ja saglabātā pilnvara tiek pazaudēta, tā būs jāģenerē no jauna, un tādējādi tiks izveidota jauna autorizācijas virkne.
Noklikšķiniet uz pilnvaras nosaukuma, lai rediģētu nosaukumu, aprakstu, derīguma termiņa iestatījumus vai pilnvaras statusu. Ņemiet vērā, ka nav iespējams mainīt lietotāju, kuram pilnvara ir piešķirta. Noklikšķiniet uz pogas Update, lai saglabātu izmaiņas. Ja pilnvara ir pazaudēta vai atklāta, varat noklikšķināt uz pogas Regenerate, lai ģenerētu jaunu pilnvaras vērtību. Tiks parādīts apstiprinājuma dialoglodziņš ar lūgumu apstiprināt šo darbību, jo pēc tās veikšanas iepriekš ģenerētā pilnvara kļūs nederīga.
Lietotāji, kuriem nav piekļuves izvēlnes sadaļai Administration, var skatīt un mainīt viņiem piešķirto pilnvaru informāciju tikai sadaļā User profile > API tokens section, ja viņu lietotāja lomas atļaujās ir iespējota opcija Manage API tokens.