Documentation
Table of Contents
user.login
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
string/object user.login(object parameters)
Aquest m¨¨tode permet connectar a l'API i generar un token d'autenticaci¨®.
Quan empreu aquest m¨¨tode, haureu de fer user.logout per previndre la generaci¨® d'un llarg nombre de registres de sessi¨® oberts.
Aquest m¨¨tode nom¨¦s ¨¦s disponible per usuaris no autenticats i se l'ha de cridar amb el par¨¤metre "auth" a una petici¨® JSON-RPC.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
(object) ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ que contenen nom d'usuari i mot de pas.
El m¨¨tode admet els par¨¤metres seg¨¹ents.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| password (obligatori) |
string | mot de pas de l'usuari. |
| username (obligatori) |
string | Nom d'usuari. |
| userData | flag | Retorna informaci¨® de l'usuari autenticat. |
| user (obsolet) |
string | Aquest par¨¤metre ¨¦s obsolet; si us plau, empreu username.Nom d'usuari. |
Valors de retorn
(string/object) Si s'empra el par¨¤metre userData, retorna un objecte que cont¨¦ informaci¨® sobre l'usuari autenticat.
A m¨¦s de les propietats de l'objecte est¨¤ndard usuari, es retorna la informaci¨® seg¨¹ent:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| debug_mode | boolean | Indica si el mode de depuraci¨® ¨¦s habilitat per a l'usuari. Consulteu la propietat debug_mode de l'objecte grp d'usuaris per obtindre una llista de valors possibles. |
| gui_access | integer | M¨¨tode d'autenticaci¨® d'usuari a la interf¨ªcie. Consulteu la propietat gui_access de l'objecte grup d'usuaris /reference/usergroup/object#user_group) per obtindre una llista de valors possibles. |
| sessionid | string | Token d'autenticaci¨®, que s'emprar¨¤ en sol¡¤licituds d'API posteriors. |
| type | integer | Tipus d'usuari. Consulteu la propietat type de l'objecte grup d'usuaris /reference/usergroup/object#user_group) per obtindre una llista de valors possibles. |
| userip | string | Adre?a IP de l'usuari. |
Si un usuari s'ha autenticat correctament despr¨¦s d'un o m¨¦s intents erronis, el m¨¨tode retorna els valors actuals de les propietats attempt_clock, attempt_failed i attempt_ip; i despr¨¦s els restableix.
Si no s'empra el par¨¤metre userData, el m¨¨tode retorna un testimoni d'autenticaci¨®.
El testimoni d'autenticaci¨® generat s'ha de recordar i emprar al par¨¤metre auth de les sol¡¤licituds JSON-RPC posteriors. Tamb¨¦ ¨¦s necessari quan s'empra l'autenticaci¨® HTTP.
Exemples
Autenticar un usuari
Autenticar un usuari.
±Ê±ð³Ù¾±³¦¾±¨®:
{
"jsonrpc": "2.0",
"method": "user.login",
"params": {
"username": "Admin",
"password": "zabbix"
},
"id": 1
}Resposta:
Demanar informaci¨® de l'usuari autenticat
Autenticar i reenviar la informaci¨® suplement¨¤ria de l'usuari.
±Ê±ð³Ù¾±³¦¾±¨®:
{
"jsonrpc": "2.0",
"method": "user.login",
"params": {
"username": "Admin",
"password": "zabbix",
"userData": true
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"userid": "1",
"username": "Admin",
"name": "Áú»¢¶Ä²©",
"surname": "Administrator",
"url": "",
"autologin": "1",
"autologout": "0",
"lang": "ru_RU",
"refresh": "0",
"theme": "default",
"attempt_failed": "0",
"attempt_ip": "127.0.0.1",
"attempt_clock": "1355919038",
"rows_per_page": "50",
"timezone": "Europe/Riga",
"roleid": "3",
"type": 3,
"debug_mode": 0,
"userip": "127.0.0.1",
"gui_access": "0",
"sessionid": "5b56eee8be445e98f0bd42b435736e42"
},
"id": 1
}Veieu tamb¨¦
Font
CUser::login() in ui/include/classes/api/services/CUser.php.