en-us	#### Updating host prototype tags  Replace host prototype tags with new ones.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostprototype.update",     "params": {         "hostid": "10092",         "tags": [             {                 "tag": "Datacenter",                 "value": "{#DATACENTER.NAME}"             },             {                 "tag": "Instance type",                 "value": "{#INSTANCE_TYPE}"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10092"         ]     },     "id": 1 } ```
ca	#### Actualitzar les etiquetes de prototips d'equips  Actualitzar les etiquetes de prototips d'equips per les noves.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostprototype.update",     "params": {         "hostid": "10092",         "tags": [             {                 "tag": "Datacenter",                 "value": "{#DATACENTER.NAME}"             },             {                 "tag": "Instance type",                 "value": "{#INSTANCE_TYPE}"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10092"         ]     },     "id": 1 } ```

en-us	#### Updating host tags  Replace all host tags with a new one.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.update",     "params": {         "hostid": "10387",         "tags": {             "tag": "OS",             "value": "RHEL 7"         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10387"         ]     },     "id": 1 } ```
ca	#### Actualitzar les etiquetes d'equips  Reemplaça totes les etiquetes d'un equip per una de nova.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.update",     "params": {         "hostid": "10387",         "tags": {             "tag": "OS",             "value": "RHEL 7"         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10387"         ]     },     "id": 1 } ```

en-us	#### Updating item preprocessing options  Update an item prototype with item preprocessing rule “Custom multiplier”.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.update",     "params": {         "itemid": "44211",         "preprocessing": [             {                 "type": 1,                 "params": "4",                 "error_handler": 2,                 "error_handler_params": "5"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```
ca	#### Actualitzar les opcions de preprocessament d'elements  Actualitzar un prototip d'element amb la regla de preprocessament d'element “Multiplicador a mida”.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.update",     "params": {         "itemid": "44211",         "preprocessing": [             {                 "type": 1,                 "params": "4",                 "error_handler": 2,                 "error_handler_params": "5"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```

en-us	#### Updating LLD rule preprocessing options  Update an LLD rule with preprocessing rule “JSONPath”.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "44211",         "preprocessing": [             {                 "type": 12,                 "params": "$.path.to.json",                 "error_handler": 2,                 "error_handler_params": "5"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```
ca	#### Actualitzar les opcions de preprocessament de regles LLD  Actualitzar una LLD amb una regla de preprocessament “JSONPath”.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "44211",         "preprocessing": [             {                 "type": 12,                 "params": "$.path.to.json",                 "error_handler": 2,                 "error_handler_params": "5"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```

en-us	#### Updating LLD rule script  Update an LLD rule script with a different script and remove unnecessary parameters that were used by previous script.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "23865",         "parameters": [],         "script": "Zabbix.log(3, 'Log test');\nreturn 1;"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 1 } ```
ca	#### Actualitzar un script de regla LLD  Actualitzar un script de regla LLD amb un script diferent i esborrar els paràmetres innecessaris que s'han emprat per l'script esborrat.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "23865",         "parameters": [],         "script": "Zabbix.log(3, 'Log test');\nreturn 1;"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 1 } ```

en-us	#### Updating multiple triggers  Enable multiple triggers by setting their status to "0":  ```bash curl --request POST \   --url 'https://example.com/zabbix/api_jsonrpc.php' \   --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \   --header 'Content-Type: application/json-rpc' \   --data '{"jsonrpc":"2.0","method":"trigger.update","params":[{"triggerid":"13938","status":0},{"triggerid":"13939","status":0}],"id":6}' ```  The successful response will contain the IDs of the updated triggers:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "13938",             "13939"         ]     },     "id": 6 } ```  ::: notetip This is the preferred method of updating. Some API methods, such as the `host.massupdate` allow to write a simpler code. However, it is not recommended to use these methods as they will be removed in the future releases. :::
ca	#### Actualització de diversos triggers  Activar múltiples triggers; és a dir, definir el seu estat a "0":  ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.update","params":[{"triggerid":"13938","status":0},{"triggerid":"13939","status":0}],"id":6}' ```   Una resposta correcta contindrà els identificadors dels triggers actualitzats:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "13938",             "13939"         ]     },     "id": 6 } ```  ::: notetip Aquest és el mètode preferit per actualitzar. Alguns mètodes de l'API com `host.massupdate` permeten fer-ho amb codi més senzill, però no es recomana emprar aquests mètodes, ja que s'esborraran en versions futures. :::

en-us	#### Updating problems  The problem update popup allows to:  -   comment on the problem -   view comments and actions so far -   change problem severity -   suppress/unsuppress problem -   acknowledge/unacknowledge problem -   change symptom problem to cause problem -   manually close problem  ![](../../assets/en/manual/acknowledges/update_problem.png){width="600"}  All mandatory input fields are marked with a red asterisk.  |Parameter|Description| |--|--------| |*Problem*|If only one problem is selected, the problem name is displayed.<br>If several problems are selected, *N problems selected* is displayed.| |*Message*|Enter text to comment on the problem (maximum 2048 characters).| |*History*|Previous activities and comments on the problem are listed, along with the time and user details.<br>For the meaning of icons used to denote user actions see the [event detail](/manual/web_interface/frontend_sections/monitoring/problems#viewing_details) page.<br>Note that history is displayed if only one problem is selected for the update.| |*Scope*|Define the scope of such actions as changing severity, acknowledging or manually closing problems:<br>**Only selected problem** - will affect this event only<br>**Selected and all other problems of related triggers** - in case of acknowledgment/closing problem, will affect this event and all other problems that are not acknowledged/closed so far. If the scope contains problems already acknowledged or closed, these problems will not be acknowledged/closed repeatedly. On the other hand, the number of message and severity change operations are not limited.| |*Change severity*|Mark the checkbox and click on the severity button to update problem severity.<br>The checkbox for changing severity is available if read-write permissions exist for at least one of the selected problems. Only those problems that are read-writable will be updated when clicking on *Update*.<br>If read-write permissions exist for none of the selected triggers, the checkbox is disabled.| |*Suppress*|Mark the checkbox to suppress the problem:<br>**Indefinitely** - suppress indefinitely<br>**Until** - suppress until a given time. Both [absolute and relative](/manual/config/visualization/graphs/simple#time-period-selector) time formats are supported, for example:<br>`now+1d` - for one day from now (default)<br>`now/w` - until the end of the current week<br>`2022-05-28 12:00:00` - until absolute date/time<br>Note that a simple period (e. g., `1d`, `1w`) is not supported.<br>Availability of this option depends on the "Suppress problems" user role settings.<br>See also: [Problem suppression](/manual/acknowledgment/suppression)| |*Unsuppress*|Mark the checkbox to unsuppress the problem. This checkbox is active only if at least one of the selected problems is suppressed.<br>Availability of this option depends on the "Suppress problems" user role settings.| |*Acknowledge*|Mark the checkbox to acknowledge the problem.<br>This checkbox is available if there is at least one unacknowledged problem among the selected.<br>It is not possible to add another acknowledgment for an already acknowledged problem (it is possible to add another comment though).| |*Unacknowledge*|Mark the checkbox to unacknowledge the problem.<br>This checkbox is available if there is at least one acknowledged problem among the selected.| |*Convert to cause*|Mark the checkbox to convert the symptom problem(s) to cause problem(s).| |*Close problem*|Mark the checkbox to manually close the selected problem(s).<br>The checkbox for closing a problem is available if the *Allow manual close* option is checked in [trigger configuration](/manual/config/triggers/trigger) for at least one of the selected problems. Only those problems will be closed that are allowed to be closed when clicking on *Update*.<br>If no problem is manually closeable, the checkbox is disabled.<br>Already closed problems will not be closed repeatedly.|
ca	#### Actualitzar problemes  La finestra emergent d'actualització del problema permet:  - comentar-lo - veure comentaris i accions preses fins ara - Canviar-li la gravetat - esborrar-lo o desactivar-lo - Reconèixer/no reconèixer el problema - canviar el símptoma que causa el problema - tancar-lo manualment  ![](../../assets/en/manual/acknowledges/update_problem.png){width="600"}  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  |Paràmetre|Descripció| |--|---------| |*Problema*|Si només es tria un problema, es veurà el nom del problema.<br>Si es trien diversos problemes, es veien *N problemes seleccionats*.| |*Missatge*|Introduïu text per comentar el problema (màxim 2048 caràcters).| |*Historial*|S'enumeren les activitats anteriors i els comentaris sobre el problema, juntament amb l'hora i els detalls de l'usuari.<br>Per al significat de les icones que s'empren per indicar les accions de l'usuari, consulteu el [detall de l'esdeveniment](/manual/web_interface/frontend_sections/monitoring/problems#viewing_details).<br>Tingueu en compte que l'historial es mostra si només es tria un problema per a l'actualització.| |*Àmbit*|Definiu l'abast d'accions com ara canviar la gravetat, reconèixer o tancar manualment problemes:<br>**Només el problema triat** - només afectarà aquest esdeveniment<br>**Els problemes triats i tots els altres dels triggers relacionats** - en cas de problema de reconeixement/tancament, afectarà aquest esdeveniment i tots els altres problemes que no s'hagin reconegut/tancat fins ara. Si l'abast conté problemes ja reconeguts o tancats, aquests problemes no seran reconeguts/tancats repetidament. D'altra banda, el nombre d'operacions de canvi de missatge i gravetat no és pas limitat.| |*Canvia la gravetat*|Marqueu la casella de selecció i feu clic al botó de gravetat per actualitzar la gravetat del problema.<br>La casella de selecció per canviar la gravetat és disponible si existeixen permisos de lectura i escriptura per a almenys un dels problemes seleccionats. Només els problemes que es poden llegir i escriure s'actualitzaran en fer clic a *Actualitza*.<br>Si no hi ha permisos de lectura i escriptura per a cap dels triggers seleccionats, la casella de selecció és desactivada.| |*Esborrar*|Marqueu la casella de selecció per esborrar el problema:<br>**Indefinidament** - esborrar indefinidament<br>**Fins** - esborrar fins a un moment determinat. S'admeten els dos formats d'hora [absolut i relatiu](/manual/config/visualization/graphs/simple#time-period-selector), per exemple:<br>`now+1d` - durant un dia a partir d'ara (per defecte)< br>`now/w` - fins al final de la setmana actual<br>`2022-05-28 12:00:00` - fins a la data/hora absoluta<br>Tingueu en compte que un punt simple (p. ex., `1d` , `1w`) no és compatible.<br>La disponibilitat d'aquesta opció depèn de la configuració del rol d'usuari "Esborrar problemes".<br>Veieu també: [Esborrat de problemes](/manual/acknowledgement/suppression)| |*Desesborrar*|Marqueu la casella de selecció per anul·lar la supressió del problema. Aquesta casella de selecció només és activa si s'esborra almenys un dels problemes triats.<br>La disponibilitat d'aquesta opció depèn de la configuració del rol d'usuari "Esborrar problemes".| |*Reconeix*|Marqueu la casella de selecció per reconèixer el problema.<br>Aquesta casella de selecció és disponible si hi ha almenys un problema no reconegut entre els triats.<br>No és possible afegir un altre reconeixement per a un problema ja reconegut (és però és possible afegir un altre comentari).| |*Desreconèixer*|Marqueu la casella de selecció per anul·lar el reconeixement del problema.<br>Aquesta casella de selecció és disponible si hi ha almenys un problema reconegut entre els triats.| |*Convertir en causa*|Marqueu la casella de selecció per convertir el(s) problema(s) del símptoma en causa(s).| |*Tancar*|Marqueu la casella de selecció per tancar manualment els problemes triats.<br>La casella de selecció per tancar un problema és disponible si l'opció *Permetre el tancament manual* és marcada a [configuració del trigger](/manual/config/triggers/trigger) per almenys un dels problemes triats. Només es tancaran els problemes que es puguin tancar en fer clic a *Actualitzar*.<br>Si cap problema es pot tancar manualment, la casella de selecció és desactivada.<br>Els problemes ja tancats no es tancaran repetidament.|

en-us	#### Updating service tags  Make SLA with ID "5" to be calculated at monthly intervals for NoSQL related services, without changing its schedule or excluded downtimes; set SLO to 95%.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "sla.update",     "params": [         {             "slaid": "5",             "name": "NoSQL Database engines",             "slo": "95",             "period": 2,             "service_tags": [                 {                     "tag": "Database",                     "operator": "0",                     "value": "Redis"                 },                 {                     "tag": "Database",                     "operator": "0",                     "value": "MongoDB"                 }             ]         }     ],     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "slaids": [             "5"         ]     },     "id": 1 } ```
ca	#### Actualitzar les etiquetes de servei  Fer que es calculi a intervals mensuals l'SLA amb ID "5", per als serveis vinculats a NoSQL, sense modificar la seva programació ni excloure els temps d'aturada; establir l'SLO a 95%.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "sla.update",     "params": [         {             "slaid": "5",             "name": "NoSQL Database engines",             "slo": "95",             "period": 2,             "service_tags": [                 {                     "tag": "Database",                     "operator": "0",                     "value": "Redis"                 },                 {                     "tag": "Database",                     "operator": "0",                     "value": "MongoDB"                 }             ]         }     ],     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "slaids": [             "5"         ]     },     "id": 1 } ```

en-us	#### Updating tag filter  Change tag filter for connector with ID "5".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "connector.update",     "params": [         {             "connectorid": 5,             "tags_evaltype": 2,             "tags": [                 {                     "tag": "service",                     "operator": 0,                     "value": "mysqld"                 },                 {                     "tag": "error",                     "operator": 12,                     "value": ""                 }             ]         }     ],     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "connectorids": [             "5"         ]     },     "id": 1 } ```
ca	#### Actualitzar el filtre d'etiquetes  Camvien el filtre d'etiqueta per al connector amb ID "5".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "connector.update",     "params": [         {             "connectorid": 5,             "tags_evaltype": 2,             "tags": [                 {                     "tag": "service",                     "operator": 0,                     "value": "mysqld"                 },                 {                     "tag": "error",                     "operator": 12,                     "value": ""                 }             ]         }     ],     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "connectorids": [             "5"         ]     },     "id": 1 } ```

en-us	#### Updating template dashboard pages  Rename the first dashboard page, replace widgets on the second dashboard page and add a new page as the third one. Delete all other dashboard pages.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templatedashboard.update",     "params": {         "dashboardid": "2",         "pages": [             {                 "dashboard_pageid": 1,                 "name": "Renamed Page"             },             {                 "dashboard_pageid": 2,                 "widgets": [                     {                         "type": "clock",                         "x": 0,                         "y": 0,                         "width": 4,                         "height": 3                     }                 ]             },             {                 "display_period": 60             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "2"         ]     },     "id": 1 } ```
ca	#### Actualitzar les pàgines de tauler de plantilla  Reanomena la primera pàgina del tauler, reemplaça els ginys de la segona pàgina del tauler i afegeix una nova pàgina com a tercera. Esborra la resta de pàgines del tauler.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templatedashboard.update",     "params": {         "dashboardid": "2",         "pages": [             {                 "dashboard_pageid": 1,                 "name": 'Renamed Page'             },             {                 "dashboard_pageid": 2,                 "widgets": [                     {                         "type": "clock",                         "x": 0,                         "y": 0,                         "width": 4,                         "height": 3                     }                 ]             },             {                 "display_period": 60             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "2"         ]     },     "id": 2 } ```

en-us	#### Updating template tags  Replace all template tags with a new one.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "template.update",     "params": {         "templateid": "10086",         "tags": [             {                 "tag": "Host name",                 "value": "{HOST.NAME}"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10086"         ]     },     "id": 1 } ```
ca	#### Actualitzar les etiquetes de plantilles  Reemplaça totes les etiquetes d'una plantilla per una de nova.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "template.update",     "params": {         "templateid": "10086",         "tags": [             {             "tag": "Nom d'equip",             "value": "{HOST.NAME}"              }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10086"         ]     },     "id": 1 } ```

en-us	 #### Upgrade
ca	 #### Actualització

en-us	#### Upgrade between minor versions  It is possible to upgrade between minor versions of 6.4.x (for example, from 6.4.1 to 6.4.3). Upgrading between minor versions is easy.  To execute Zabbix minor version upgrade it is required to run:      $ sudo dnf upgrade 'zabbix-*'  To execute Zabbix server minor version upgrade run:      $ sudo dnf upgrade 'zabbix-server-*'  To execute Zabbix agent minor version upgrade run:      $ sudo dnf upgrade 'zabbix-agent-*'  or, for Zabbix agent 2:      $ sudo dnf upgrade 'zabbix-agent2-*'
ca	#### Actualització entre versions menors  És possible actualitzar versions menors de la 6.4.x (per exemple, de la 6.4.1 a la 6.4.3). És fàcil.  Per actualitzar la versió menor de Zabbix, executeu:       $ sudo dnf upgrade 'zabbix-*'  Per actualitzar la versió menor del servidor Zabbix, executeu:       $ sudo dnf upgrade 'zabbix-*'  Per actualitzar la versió menor de l'agent Zabbix, executeu:       $ sudo dnf upgrade 'zabbix-agent-*'  o, per a l'agent de Zabbix 2:       $ sudo dnf upgrade 'zabbix-agent2-*'

en-us	#### Upgrade between minor versions  It is possible to upgrade minor versions of 6.4.x (for example, from 6.4.1 to 6.4.3). It is easy.  To upgrade Zabbix minor version please run:      $ sudo apt install --only-upgrade 'zabbix.*'  To upgrade Zabbix server minor version please run:      $ sudo apt install --only-upgrade 'zabbix-server.*'  To upgrade Zabbix agent minor version please run:      $ sudo apt install --only-upgrade 'zabbix-agent.*'  or, for Zabbix agent 2:      $ sudo apt install --only-upgrade 'zabbix-agent2.*'
ca	#### Actualització entre versions menors  És possible actualitzar versions menors de 6.4.x(per exemple, de 6.4.1 a 6.4.3). És senzill.  Per actualitzar la versió menor de Zabbix, executeu:       $ sudo apt install --only-upgrade 'zabbix.*'  Per actualitzar la versió menor del servidor Zabbix, executeu:       $ sudo apt install --only-upgrade 'zabbix-server.*'  Per actualitzar la versió menor de l'agent Zabbix, executeu:       $ sudo apt install --only-upgrade 'zabbix-agent.*'  o, per a l'agent de Zabbix 2:       $ sudo apt install --only-upgrade 'zabbix-agent2.*'

en-us	#### Upgrade between minor versions  When upgrading between minor versions of 6.4.x (for example from 6.4.1 to 6.4.3) it is required to execute the same actions for server/proxy/agent as during the upgrade between major versions. The only difference is that when upgrading between minor versions no changes to the database are made.
ca	#### Actualització entre versions menors  Quan actualitzeu entre versions menors de 6.4.x (per exemple, de la 6.4.1 a la 6.4.3), cal fer les mateixes accions per al servidor/proxy/agent que quan actualitzeu entre versions principals. L'única diferència és que quan s'actualitza entre versions menors, no es fan canvis a la base de dades.

en-us	#### Upgrade procedure
ca	#### Procés d'actualització

en-us	#### Upgrade procedure
ca	#### Procés d'actualització

en-us	 #### Upgrade process  To complete successful Zabbix server upgrade on MySQL/MariaDB, you may require to set `GLOBAL log_bin_trust_function_creators = 1` in MySQL  if binary logging is enabled, there are no superuser privileges and `log_bin_trust_function_creators = 1` is not set in MySQL configuration file.   To set the variable using the MySQL console, run:      mysql> SET GLOBAL log_bin_trust_function_creators = 1;  Once the upgrade has been successfully completed, this option can be disabled:      mysql> SET GLOBAL log_bin_trust_function_creators = 0;
ca	### Proces d'actualització  Per completar amb èxit l'actualització del servidor Zabbix a MySQL/MariaDB, és possible que calgui establir `GLOBAL log_bin_trust_function_creators = 1` a MySQL si el registre binari és habilitat, no hi ha privilegis de superusuari i `log_bin_trust_function_creators = 1` no és establert al fitxer de configuració de MySQL.  Per configurar la variable mitjançant la consola MySQL, executeu:       mysql> SET GLOBAL log_bin_trust_function_creators = 1;  Un cop l'actualització s'hagi completat amb èxit, es pot desactivar aquesta opció:      mysql> SET GLOBAL log_bin_trust_function_creators = 0;

en-us	##### Upgrade with MariaDB 10.2.1 and before  Upgrading Zabbix may fail if database tables were created with MariaDB 10.2.1 and before, because in those versions the default row format is compact. This can be fixed by changing the row format to dynamic (see also [ZBX-17690](https://support.zabbix.com/browse/ZBX-17690)).
ca	### Actualitzar amb MariaDB 10.2.1 i versions anteriors  L'actualització de Zabbix pot fallar si les taules de base de dades es van crear amb MariaDB 10.2.1 o versions anteriors, perquè en aquestes versions el format de fila predeterminat és compacte. Això es pot resoldre canviant el format de fila a dinàmic (veieu també [ZBX-17690](https://support.zabbix.com/browse/ZBX-17690)).

en-us	### Upgrading HA cluster  To perform a major version upgrade for the HA nodes:  -   stop all nodes; -   create a full database backup; -   if the database uses replication make sure that all nodes are in sync and have no issues. Do not upgrade if replication is broken. -   select a single node that will perform database upgrade, change its configuration to standalone mode by commenting out HANodeName and [upgrade](/manual/installation/upgrade) it; -   make sure that database upgrade is fully completed (*System information* should display that Zabbix server is running); -   restart the node in HA mode; -   upgrade and start the rest of nodes (it is not required to change them to standalone mode as the database is already upgraded at this point).  In a minor version upgrade it is sufficient to upgrade the first node, make sure it has upgraded and running, and then start upgrade on the next node.
ca	### Actualitzant un clúster d'alta disponibilitat  Per fer una actualització gran de la versió per als nodes HA:  - atureu tots els nodes; - creeu una còpia de seguretat completa de la base de dades; - si la base de dades empra replicació, assegureu-vos que tots els nodes estiguin sincronitzats i que no tinguin cap problema. No actualitzeu si la rèplica és trencada. - trieu un únic node que actualitzarà la base de dades, canvieu la seva configuració al mode autònom comentant HANodeName i [actualitzeu](/manual/installation/upgrade); - Assegureu-vos que l'actualització de la base de dades s'hagi completat completament (*La informació del sistema* hauria de mostrar que el servidor Zabbix s'està executant); - reinicieu el node en mode HA; - actualitzeu i inicieu la resta de nodes (no cal canviar-los al mode autònom, ja que la base de dades ja està actualitzada en aquest moment).  En una actualització de versió menor, n'hi ha prou amb actualitzar el primer node, assegurar-se que s'ha actualitzat bé i que s'executa correctament i, tot seguit, actualitzar l'altre node.

en-us	#### - Upgrading  The Zabbix appliance packages may be upgraded. To do so, run:      dnf update zabbix*
ca	#### - Actualització  Els paquets de l'aplicació Zabbix es poden actualizar. Per fer-ho, executeu:      dnf update zabbix*

en-us	#### Upgrading Zabbix agent 2 (6.0.5 or older)  When upgrading Zabbix agent 2 (version 6.0.5 or older) from packages, a plugin-related file conflict error may occur. To fix the error, back up your agent 2 configuration (if necessary), uninstall agent 2 and install it anew.  On RHEL-based systems, run:      dnf remove zabbix-agent2     dnf install zabbix-agent2  On Debian-based systems, run:      apt remove zabbix-agent2     apt install zabbix-agent2  For more information, see [ZBX-23250](https://support.zabbix.com/browse/ZBX-23250).
ca	#### Actualització de l'agent Zabbix 2 (6.0.5 o anterior)  Quan actualitzeu l'agent Zabbix 2 (versió 6.0.5 o anterior) des dels paquets, es pot produir un error de conflicte de fitxer relacionat amb els connectors. Per solucionar l'error, feu una còpia de seguretat de la configuració de l'agent 2 (si cal), desinstal·leu l'agent 2 i instal·leu-lo de nou.  En sistemes basats en RHEL, executeu:      dnf remove zabbix-agent2     dnf install zabbix-agent2  En sistemes basats en Debian, executeu:      apt remove zabbix-agent2     apt install zabbix-agent2  Per obtindre més informació, veieu [ZBX-23250](https://support.zabbix.com/browse/ZBX-23250).

en-us	 Upgrading Zabbix agents is recommended but not mandatory.   Upgrading Zabbix proxies is highly recommended. Zabbix server fully supports proxies that are of the same major version as the server. Zabbix server also supports proxies that are **no older** than Zabbix server previous LTS release version, but with limited functionality (data collection, execution of [remote commands](/manual/config/notifications/action/operation/remote_command), [immediate item value checks](/manual/config/items/check_now)). Configuration update is also disabled, and [outdated](/manual/appendix/compatibility#supported-zabbix-proxies) proxies will only work with old configuration.
ca	 Es recomana actualitzar els agents Zabbix, però no és obligatori.  Es recomana actualitzar els proxys Zabbix. El servidor Zabbix és totalment compatible amb proxys que són de la mateixa versió principal que el servidor. El servidor Zabbix també admet proxys que **no són més antics** que la versió LTS anterior del servidor Zabbix, però amb una funcionalitat limitada (recollida de dades, execució d'[ordres remotes](/manual/config/notifications/action/operation/remote_command), [comprovacions immediates del valor de l'element](/manual/config/items/check_now)). L'actualització de configuració també és desactivada i els proxys [obsolets](/manual/appendix/compatibility#supported-zabbix-proxies) només funcionaran amb la configuració antiga.

en-us	 ### url  A link to the module description.  *Type*: String  *Example*:   ```json "url": "http://example.com" ```
ca	### url  Enllaç a la descripció del mòdul.  *Tipus*: Cadena  *Exemple*:   ```json "url": "http://exemple.cat" ```

en-us	 ### Usability
ca	 ### Usabilitat

en-us	 **Usability updates for Graph widget**  When configuring a [*Graph*](/manual/web_interface/frontend_sections/dashboards/widgets/graph) widget, it is now possible to rename data sets by customizing the *Data set label*. This makes it easier to identify data sets in widget configuration, as well as identify aggregated data sets in graph *Legend*.  Autocomplete functionality of the widget has also been improved. The *Item pattern* field suggestions now only display the items that belong to the hosts selected in the *Host pattern* field.
ca	 **Actualitzacions d'usabilitat per al giny de Gràfic**  Quan configureu un giny [*Gràfic*](/manual/web_interface/frontend_sections/dashboards/widgets/graph), ara és possible canviar el nom dels conjunts de dades personalitzant l'*etiqueta del conjunt de dades*. Això fa que sigui més fàcil identificar conjunts de dades a la configuració del giny, així com identificar conjunts de dades agregades al gràfic *Llegenda*.  També s'ha millorat la funcionalitat d'emplenament automàtic del giny. Els suggeriments del camp *Patró d'elements* ara només mostren els elements que pertanyen als equips triats al camp *Patró d'equip*.

en-us	#### Usage example  Executing the script **check\_oracle.sh** with the first parameters '-h'. The second parameter will be replaced by IP address or DNS name, depending on the selection in the host properties.      check_oracle.sh["-h","{HOST.CONN}"]  Assuming host is configured to use IP address, Zabbix will execute:      check_oracle.sh '-h' '192.168.1.4'
ca	#### Exemple d'ús  Executar l'script **check\_oracle.sh** amb els primers paràmetres '-h'. El segon paràmetre es substituirà per l'adreça IP o el nom DNS, segons la selecció dins les propietats de l'equip.      check_oracle.sh["-h","{HOST.CONN}"]  Suposant que l'equip s'ha configurat per emprar adreça IP, Zabbix executarà:      check_oracle.sh '-h' '192.168.1.4'

en-us	#### Usage examples
ca	#### Exemples d'ús

en-us	#### Usage examples  By using some appropriate suffixes you can write trigger expressions that are easier to understand and maintain, for example these expressions:      last(/host/system.uptime)<86400s     avg(/host/system.cpu.load,600s)<10     last(/host/vm.memory.size[available])<20971520  could be changed to:      last(/host/system.uptime)<1d     avg(/host/system.cpu.load,10m)<10     last(/host/vm.memory.size[available])<20M
ca	#### Exemples d'ús  Emprant els sufixes adequats, podeu escriure les expressions de triggers més senzilles d'entendre i gestionar; per exemple aquestes:   last(/host/system.uptime)<86400s  avg(/host/system.cpu.load,600s)<10  last(/host/vm.memory.size[available])<20971520  poden canviar-se a:   last(/host/system.uptime)<1d  avg(/host/system.cpu.load,10m)<10  last(/host/vm.memory.size[available])<20M

en-us	#### Usage examples  Examples of keys for aggregate calculations.
ca	#### Exemples d'ús  Exemples de claus per als càlculs agregats.

en-us	 #### Usage  In the following locations:     - graph names    - map element labels     - map shape labels    - map link labels   only a **single** function, from the following set: `avg`, `last`, `max`, `min`,  is allowed as an expression macro, e.g.:      {?avg(/{HOST.HOST}/{ITEM.KEY},1h)}      Expressions such as `{?last(/host/item1)/last(/host/item2)}`, `{?count(/host/item1,5m)}`  and `{?last(/host/item1)*10}` are incorrect in these locations.  However, in:     - trigger event names     - trigger-based notifications and commands    - problem update notifications and commands      **complex** expressions are allowed, e.g.:       {?trendavg(/host/item1,1M:now/M)/trendavg(/host/item1,1M:now/M-1y)*100}  See also:   -   [Supported macros](/manual/appendix/macros/supported_by_location) for a list of supported locations of the expression macro -   [Example](/manual/config/triggers/expression#example_18) of using an expression macro in the event name
ca	#### Ús  A les ubicacions següents:      - noms dels gràfics      - etiquetes d'elements del mapa      - etiquetes amb forma de targeta      - etiquetes d'enllaç de mapa  només es permet una funció **única**, del conjunt següent: `avg`, `last`, `max`, `min`, com a macro d'expressió, per exemple:       {?avg(/{HOST.HOST}/{ITEM.KEY},1h)}      Expressions com `{?last(/host/item1)/last(/host/item2)}`, `{?count(/host/item1,5m)}` i `{?last(/host/item1)*10}` són incorrectes en aquests llocs.  Tanmateix, en:      - noms dels esdeveniments de triggers     - notificacions i ordres basades en triggers     - notificacions i ordres d'actualització de problemes     Es permeten expressions **complexes**, per exemple:       {?trendavg(/host/item1,1M:now/M)/trendavg(/host/item1,1M:now/M-1y)*100}  Veieu també:  - [Macros admeses](/manual/appendix/macros/supported_by_location) per obtindre una llista d'ubicacions admeses de la macro d'expressió - [Exemple](/manual/config/triggers/expression#example_18) emprant una macro d'expressió al nom de l'esdeveniment

en-us	 ### Usage with command-line utilities  Note that when testing or using item keys with zabbix_agentd or zabbix_get from the command line you should consider shell syntax too.  For example, if a certain parameter of the key has to be enclosed in double quotes you have to explicitly escape double quotes, otherwise they will be trimmed by the shell as special characters and will not be passed to the Zabbix utility.  Examples:      $ zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'      $ zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]
ca	 ### Ús amb utilitats de línia d'ordres  Tingueu en compte que quan feu proves o empreu claus d'element amb zabbix_agentd o zabbix_get des de la línia de comandes també hauríeu de tindre en compte la sintaxi de l'intèrpret d'ordres.  Per exemple, si un paràmetre determinat de la clau s'ha de tancar entre cometes dobles, heu d'escapar explícitament de cometes dobles; en cas contrari, seran retallades per l'intèrpret d'ordres com a caràcters especials i no es passaran pas a la utilitat Zabbix. Exemples:      $ zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'      $ zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]

en-us	#### Usage      zabbix_js -s script-file -p input-param [-l log-level] [-t timeout]     zabbix_js -s script-file -i input-file [-l log-level] [-t timeout]     zabbix_js -h     zabbix_js -V  zabbix\_js accepts the following command line parameters:        -s, --script script-file          Specify the file name of the script to execute. If '-' is specified as file name, the script will be read from stdin.       -i, --input input-file            Specify the file name of the input parameter. If '-' is specified as file name, the input will be read from stdin.       -p, --param input-param           Specify the input parameter.       -l, --loglevel log-level          Specify the log level.       -t, --timeout timeout             Specify the timeout in seconds. Valid range: 1-60 seconds (default: 10 seconds).       -h, --help                        Display help information.       -V, --version                     Display the version number.  Example:      zabbix_js -s script-file.js -p example
ca	#### Ús      zabbix_js -s script-file -p input-param [-l log-level] [-t timeout]     zabbix_js -s script-file -i input-file [-l log-level] [-t timeout]     zabbix_js -h     zabbix_js -V  zabbix\_js accepta els següents paràmetres de línia de comandes:        -s, --script script-file          Especifica el nom de l'arxiu a executar. Si s'escriu '-' com a nom d'arxiu, l'script es llegirà des d'stdin.       -i, --input input-file            Expeficia el nom d'arxiu del paràmetre d'entrada. Si s'escriu '-' com a nom d'arxiu, l'script es llegirà des d'stdin.       -p, --param input-param           Especifica el paràmetre d'entrada.       -l, --loglevel log-level          Especifica el nivell de registre.       -t, --timeout timeout             Especifica el temps d'espera en segons. Rang vàlid: 1-60 segons (per defecte: 10 segons).       -h, --help                        Veure informació d'ajuda.       -V, --version                     Veure el nombre de versió.  Exemple:      zabbix_js -s script-file.js -p exemple

en-us	#### Use cases
ca	#### Casos d'ús

en-us	#### Use cases
ca	#### Casos d'ús

en-us	### Use cases  Some use cases for recovery operations are as follows:  1.  Notify on a recovery all users that were notified on the problem:     -  Select *Notify all involved* as operation type.  2.  Have multiple operations upon recovery: send a notification and execute a remote command:     -  Add operation types for sending a message and executing a command.  3.  Open a ticket in external helpdesk/ticketing system and close it when the problem is resolved:     -  Create an external script that communicates with the helpdesk system.     -  Create an action having operation that executes this script and thus opens a ticket.     -  Have a recovery operation that executes this script with other parameters and closes the ticket.     -  Use the {EVENT.ID} macro to reference the original problem.
ca	### Casos d'ús  Alguns casos d'ús per a les operacions de recuperació són:  1. Notifiqueu durant una recuperació a tots els usuaris que hagin sigut informats del problema:         - Trieu "Enviar missatge de recuperació" com a tipus d'operació. 2. Feu diverses operacions en recuperar: envieu una notificació i executeu l'ordre remota:         - Afegiu tipus d'operacions per enviar missatges i executar l'ordre. 3. Obriu un cas al sistema d'assistència/ticketing extern i tanqueu-lo quan es resolgui el problema:         - Crear un script extern que es comuniqui amb el sistema d'assistència.         - Crear una acció amb una operació que executa aquest script i, per tant, obre un cas.         - Tindre una operació de recuperació que executi aquest script amb altres paràmetres i tanqui el cas.         - Empreu la macro {EVENT.ID} per fer referència al problema original.

en-us	#### Use cases  Some use cases for this functionality are as follows:  1.  Mark trigger events in the frontend:     -   Define a tag at the trigger level, for example `scope:performance`;     -   All problems created by this trigger will be marked with this tag. 2.  Mark all template-inherited problems:     -   Define a tag at the template level, for example `target:MySQL`;     -   All host problems created by triggers from this template will be marked with this tag. 3.  Mark all host problems:     -   Define a tag at the host level, for example `service:Jira`;     -   All problems of the host triggers will be marked with this tag. 4.  Group related items:     -   Define a tag at the item level, for example `component:cpu`;     -   In the *Latest data* section, use the tag filter to view all items tagged as `component:cpu`. 5.  Identify problems in a log file and close them separately:     -   Define tags in the log trigger that will identify events using value extraction by the `{{ITEM.VALUE<N>}.regsub()}` macro;     -   In the trigger configuration, set multiple problem event generation mode;     -   In the trigger configuration, use [event correlation](/manual/config/event_correlation):          select the option that OK event closes only matching events and choose the tag for matching;     -   See problem events created with a tag and closed individually. 6.  Use it to filter notifications:     -   Define tags at the trigger level to mark events by different tags;     -   Use tag filtering in action conditions to receive notifications only on the events that match tag data. 7.  Use information extracted from item value as tag value:     -   Use an `{{ITEM.VALUE<N>}.regsub()}` macro in the tag value;     -   See tag values in *Monitoring* → *Problems* as extracted data from the item value. 8.  Identify problems better in notifications:     -   Define tags at the trigger level;     -   Use an {EVENT.TAGS} macro in the problem notification;     -   Easier identify which application/service the notification belongs to. 9.  Simplify configuration tasks by using tags at the template level:     -   Define tags at the template trigger level;     -   See these tags on all triggers created from template triggers. 10. Create triggers with tags from low-level discovery (LLD):     -   Define tags on trigger prototypes;     -   Use LLD macros in the tag name or value;     -   See these tags on all triggers created from trigger prototypes. 11. Match services using [service tags](/manual/it_services/service_tree#service-tags):     -   Define [service actions](/manual/it_services/service_actions#conditions) for services with matching tags;     -   Use service tags to map a service to an SLA for [SLA calculations](/manual/it_services/sla#configuration). 12. Map services to problems using [problem tags](/manual/it_services/service_tree#service-configuration):     -   In the service configuration, specify [problem tag](/manual/it_services/service_tree#problem-tags), for example `target:MySQL`;     -   Problems with the matching tag will be automatically correlated to the service;     -   Service status will change to the status of the problem with the highest severity.  13. Suppress problems when a host is in maintenance mode:     -   Define tags in *[Maintenance periods](/manual/maintenance#configuration)* to suppress only problems with matching tags. 14. Grant access to user groups:     -   Specify tags in the [user group](/manual/config/users_and_usergroups/usergroup#configuration) configuration to allow viewing only problems with matching tags.
ca	#### Casos d'ús  Alguns casos d'ús d'aquesta funcionalitat són els següents:  1. Marqueu els esdeveniments triggers a la interfície:      - Definiu una etiqueta al nivell de trigger, per exemple `abast: rendiment`;      - Tots els problemes creats per aquest trigger es marcaran amb aquesta etiqueta. 2. Marqueu tots els problemes heretats de la plantilla:      - Definiu una etiqueta a nivell de plantilla, per exemple `target:MySQL`;      - Tots els problemes d'equip creats per triggers d'aquesta plantilla es marcaran amb aquesta etiqueta. 3. Marqueu tots els problemes de l'equip:      - Definiu una etiqueta a nivell d'equip, per exemple `service:Jira`;      - Tots els problemes dels triggers de l'equip es marcaran amb aquesta etiqueta. 4. Elements relacionats amb el grup:      - Definiu una etiqueta a nivell d'element, per exemple `component:cpu`;      - A la secció *Dades més recents*, empreu el filtre d'etiquetes per veure tots els elements etiquetats com a `component:cpu`. 5. Identifiqueu els problemes en un fitxer de registre i tanqueu-los per separat:      - Definiu etiquetes al trigger de registre que identificaran esdeveniments mitjançant l'extracció de valors mitjançant la macro `{{ITEM.VALUE<N>}.regsub()}`;      - A la configuració del trigger, configureu el mode de generació d'esdeveniments de problemes múltiples;      - A la configuració del trigger, empreu la [correlació d'esdeveniments](/manual/config/correlació_events):          trieu l'opció que l'esdeveniment OK tanca només els esdeveniments coincidents i trieu l'etiqueta per fer coincidir;      - Veure esdeveniments problemàtics creats amb una etiqueta i tancats individualment. 6. Empreu-lo per filtrar les notificacions:      - Definir etiquetes al nivell de trigger per marcar esdeveniments amb diferents etiquetes;      - Emprar el filtratge d'etiquetes en condicions d'acció per rebre notificacions només dels esdeveniments que coincideixen amb les dades de l'etiqueta. 7. Empreu la informació extreta del valor de l'element com a valor de l'etiqueta:      - Emprar una macro `{{ITEM.VALUE<N>}.regsub()}` al valor de l'etiqueta;      - Veure els valors de les etiquetes a *Monitoratge* → *Problemes* com a dades extretes del valor de l'element. 8. Identifiqueu millor els problemes a les notificacions:      - Definir etiquetes al nivell de trigger;      - Emprar una macro {EVENT.TAGS} a la notificació del problema;      - Identificar més fàcilment a quina aplicació/servei pertany la notificació. 9. Simplifica les tasques de configuració utilitzant etiquetes a nivell de plantilla:      - Definir etiquetes al nivell de trigger de la plantilla;      - Veure aquestes etiquetes a tots els triggers creats a partir dels triggers de plantilla. 10. Creeu triggers amb etiquetes de decoberta de baix nivell (LLD):      - Definir etiquetes en prototips de trigger;      - Emprar macros LLD al nom o valor de l'etiqueta;      - Veure aquestes etiquetes a tots els trigger creats a partir de prototips de trigger. 11. Relaciona els serveis mitjançant les [etiquetes de servei](/manual/it_services/service_tree#service-tags):      - Definir [accions de servei](/manual/it_services/service_actions#conditions) per als serveis amb etiquetes coincidents;      - Emprar etiquetes de servei per assignar un servei a un SLA per a [càlculs SLA](/manual/it_services/sla#configuration). 12. Assigna els serveis a problemes amb [etiquetes de problemes](/manual/it_services/service_tree#service-configuration):      - A la configuració del servei, especifica l'[etiqueta del problema](/manual/it_services/service_tree#problem-tags), per exemple `target:MySQL`;      - Els problemes amb l'etiqueta coincident es correlacionaran automàticament amb el servei;      - L'estat del servei canviarà a l'estat del problema amb la gravetat més alta. 13. Suprimeix els problemes quan un equip és en mode de manteniment:      - Definir etiquetes a *[Períodes de manteniment](/manual/maintenance#configuration)* per esborrar només problemes amb les etiquetes coincidents. 14. Concedeix accés als grups d'usuaris:      - Especificar les etiquetes a la configuració de [grup d'usuaris](/manual/config/users_and_usergroups/usergroup#configuration) per permetre visualitzar només els problemes amb les etiquetes coincidents.

en-us	#### Use cases  User macros with context can be defined to accomplish more flexible thresholds in trigger expressions (based on the values retrieved by low-level discovery). For example, you may define the following macros:  -   {$LOW\_SPACE\_LIMIT} = 10 -   {$LOW\_SPACE\_LIMIT:/home} = 20 -   {$LOW\_SPACE\_LIMIT:regex:"\^\\/\[a-z\]+$"} = 30  Then a low-level discovery macro may be used as macro context in a trigger prototype for mounted file system discovery:      last(/host/vfs.fs.size[{#FSNAME},pfree])<{$LOW_SPACE_LIMIT:"{#FSNAME}"}  After the discovery different low-space thresholds will apply in triggers depending on the discovered mount points or file system types. Problem events will be generated if:  -   /home folder has less than 20% of free disk space -   folders that match the regexp pattern (like /etc, /tmp or /var) have     less than 30% of free disk space -   folders that don't match the regexp pattern and are not /home have     less than 10% of free disk space
ca	#### Cas d'ús  Es poden definir macros d'usuari amb context per aconseguir llindars més flexibles en expressions de triggers (basades en valors recuperats per descoberta de baix nivell). Per exemple, podeu definir les macros següents:  - {$LOW\_SPACE\_LIMIT} = 10 - {$LOW\_SPACE\_LIMIT:/home} = 20 - {$LOW\_SPACE\_LIMIT:regex:"\^\\/\[a-z\]+\$"} = 30  Tot seguit, es pot emprar una macro de descoberta de baix nivell com a context de macro en un prototip de trigger per a la descoberta del sistema de fitxers muntat:       last(/host/vfs.fs.size[{#FSNAME},pfree])<{$LOW_SPACE_LIMIT:"{#FSNAME}"}  Després de la descoberta, s'aplicaran diferents llindars d'espai sota els triggers en funció dels punts de muntatge o dels tipus de sistema de fitxers descoberts. Es generaran esdeveniments de problemes si:  - la carpeta /home té menys d'un 20% d'espai lliure al disc - Les carpetes que coincideixen amb el patró d'expressió regular (com /etc, /tmp o /var) tenen menys del 30% d'espai lliure en disc - Les carpetes que no coincideixen amb el patró d'expressió regular i no són /home tenen menys del 10% d'espai lliure en disc

en-us	##### Use cases  Zabbix frontend uses GUI interface to define possible options: required, verify\_ca, verify\_full. Specify required options in the installation wizard step *Configure DB connections*. These options are mapped to the configuration file (zabbix.conf.php) in the following manner:  |GUI settings|Configuration file|Description|Result| |----|----|----|----| |![](../../../../assets/en/manual/appendix/install/encrypt_db_transport.png)|...<br>// Used for TLS connection.<br>$DB\['ENCRYPTION'\] = true;<br>$DB\['KEY\_FILE'\] = '';<br>$DB\['CERT\_FILE'\] = '';<br>$DB\['CA\_FILE'\] = '';<br>$DB\['VERIFY\_HOST'\] = false;<br>$DB\['CIPHER\_LIST'\] = '';<br>...|Check *Database TLS encryption*<br>Leave *Verify database certificate* unchecked|Enable 'required' mode.| |![](../../../../assets/en/manual/appendix/install/encrypt_db_verify_ca.png)|...<br>$DB\['ENCRYPTION'\] = true;\\\\ $DB\['KEY\_FILE'\] = '';<br>$DB\['CERT\_FILE'\] = '';<br>$DB\['CA\_FILE'\] = '/etc/ssl/mysql/ca.pem';<br>$DB\['VERIFY\_HOST'\] = false;<br>$DB\['CIPHER\_LIST'\] = '';<br>...|1\. Check *Database TLS encryption* and *Verify database certificate*<br>2. Specify path to *Database TLS CA file*|Enable 'verify\_ca' mode.| |![](../../../../assets/en/manual/appendix/install/encrypt_db_verify_full1.png)|...<br>// Used for TLS connection with strictly defined Cipher list.<br>$DB\['ENCRYPTION'\] = true;<br>$DB\['KEY\_FILE'\] = '<key\_file\_path>';<br>$DB\['CERT\_FILE'\] = '<key\_file\_path>';<br>$DB\['CA\_FILE'\] = '<key\_file\_path>';<br>$DB\['VERIFY\_HOST'\] = true;<br>$DB\['CIPHER\_LIST'\] = '<cipher\_list>';<br>...<br><br>Or:<br><br>...<br>// Used for TLS connection without Cipher list defined - selected by MySQL server<br>$DB\['ENCRYPTION'\] = true;<br>$DB\['KEY\_FILE'\] = '<key\_file\_path>';<br>$DB\['CERT\_FILE'\] = '<key\_file\_path>';<br>$DB\['CA\_FILE'\] = '<key\_file\_path>';<br>$DB\['VERIFY\_HOST'\] = true;<br>$DB\['CIPHER\_LIST'\] = '';<br>...|1\. Check *Database TLS encryption* and *Verify database certificate*<br>2. Specify path to *Database TLS key file*<br>3. Specify path to *Database TLS CA file*<br>4. Specify path to *Database TLS certificate file*<br>5. Specify TLS cipher list (optional)|Enable 'verify\_full' mode for MySQL.| |![](../../../../assets/en/manual/appendix/install/encrypt_db_verify_full2.png)|...<br>$DB\['ENCRYPTION'\] = true;<br>$DB\['KEY\_FILE'\] = '<key\_file\_path>';<br>$DB\['CERT\_FILE'\] = '<key\_file\_path>';<br>$DB\['CA\_FILE'\] = '<key\_file\_path>';<br>$DB\['VERIFY\_HOST'\] = true;<br>$DB\['CIPHER\_LIST'\] = ' ';<br>...<br>|1\. Check *Database TLS encryption* and *Verify database certificate*<br>2. Specify path to *Database TLS key file*<br>3. Specify path to *Database TLS CA file*<br>4. Specify path to *Database TLS certificate file*<br>5. Check *Database host verification*|Enable 'verify\_full' mode for PostgreSQL.|  **See also:** [Encryption configuration examples for MySQL](/manual/appendix/install/db_encrypt/mysql), [Encryption configuration examples for PostgreSQL](/manual/appendix/install/db_encrypt/postgres).
ca	##### Casos d'ús  La interfície de Zabbix empra la interfície GUI per definir les opcions possibles: obligatori, verificar\_ca, verificar\_sencer. Especifiqueu les opcions necessàries a la pasa d'instal·lació de l'assistent *Configura les connexions de base de dades*. Aquestes opcions s'assignen al fitxer de configuració (zabbix.conf.php) de la manera següent:  |Configuració de la GUI|Fitxer de configuració|Descripció|Resultat| |----|----|----|----| |![](../../../../assets/en/manual/appendix/install/encrypt_db_transport.png)|...<br>// S'empra per a la connexió TLS.<br>$DB \['ENCRYPTION'\] = cert;<br>$DB\['KEY\_FILE'\] = '';<br>$DB\['CERT\_FILE'\] = '';<br>$ DB\['CA\_FILE'\] = '';<br>$DB\['VERIFY\_HOST'\] = fals;<br>$DB\['CIPHER\_LIST'\] = '';< br>...|Comproveu *xifratge TLS de la base de dades*<br>Deixeu *Verifica el certificat de la base de dades* desmarcat|Activeu el mode "obligatori".| |![](../../../../assets/en/manual/appendix/install/encrypt_db_verify_ca.png)|...<br>$DB\['ENCRYPTION'\] = true; \\\\ $DB\['KEY\_FILE'\] = '';<br>$DB\['CERT\_FILE'\] = '';<br>$DB\['CA\_FILE'\ ] = '/etc/ssl/mysql/ca.pem';<br>$DB\['VERIFY\_HOST'\] = fals;<br>$DB\['CIPHER\_LIST'\] = ''; <br>...|1\. Comproveu *Encriptació TLS de la base de dades* i *Verifiqueu el certificat de la base de dades*<br>2. Especifiqueu el camí al *fitxer CA TLS de la base de dades*|Activeu el mode "verificar\_ca".| |![](../../../../assets/en/manual/appendix/install/encrypt_db_verify_full1.png)|...<br>// S'empra per a la connexió TLS amb una llista de xifratge estrictament definida. <br>$DB\['ENCRYPTION'\] = true;<br>$DB\['KEY\_FILE'\] = '<key\_file\_path>';<br>$DB\['CERT\ _FILE'\] = '<key\_file\_path>';<br>$DB\['CA\_FILE'\] = '<key\_file\_path>';<br>$DB\['VERIFY\ _HOST'\] = cert;<br>$DB\['CIPHER\_LIST'\] = '<xifratge\_lista>';<br>...<br><br>O:<br><br> ...<br>// S'empra per a la connexió TLS sense la llista de xifratge definida - definida pel servidor MySQL<br>$DB\['ENCRYPTION'\] = true;<br>$DB\['KEY\_FILE'\] = '<key\_file\_path>';<br>$DB\['CERT\_FILE'\] = '<key\_file\_path>';<br>$DB\['CA\_FILE'\] = '<key\_file\_path>';<br>$DB\['VERIFY\_HOST'\] = true;<br>$DB\['CIPHER\_LIST'\] = '';<br>. ..|1\. Comproveu *Encriptació TLS de la base de dades* i *Verifiqueu el certificat de la base de dades*<br>2. Especifiqueu el camí al *fitxer de claus TLS de la base de dades*<br>3. Especifiqueu el camí al *fitxer CA TLS de la base de dades*<br>4. Especifiqueu el camí al *fitxer de certificat TLS de la base de dades*<br>6. Especifiqueu la llista de xifratge TLS (opcional)|Activeu el mode "verificar\_complet" per a MySQL.| |![](../../../../assets/en/manual/appendix/install/encrypt_db_verify_full2.png)|...<br>$DB\['ENCRYPTION'\] = cert; <br>$DB\['KEY\_FILE'\] = '<key\_file\_path>';<br>$DB\['CERT\_FILE'\] = '<key\_file\_path>'; <br>$DB\['CA\_FILE'\] = '<key\_file\_path>';<br>$DB\['VERIFY\_HOST'\] = true;<br>$DB\[' CIPHER\_LIST'\] = ' ';<br>...<br>|1\. Comproveu *Encriptació TLS de la base de dades* i *Verifiqueu el certificat de la base de dades*<br>2. Especifiqueu el camí al *fitxer de claus TLS de la base de dades*<br>3. Especifiqueu el camí al *fitxer CA TLS de la base de dades*<br>4. Especifiqueu el camí al *fitxer de certificat TLS de la base de dades*<br>6. Comproveu *Verificació de l'equip de la base de dades*|Activeu el mode "verificar\_complet" per a PostgreSQL.|  **Veieu també:** [Exemples de configuració de xifratge per a MySQL](/manual/appendix/install/db_encrypt/mysql), [exemples de configuració de xifrat per PostgreSQL](/manual/appendix/install/db_encrypt/postgres).

en-us	 #### Use case with global variables shared across webhook calls  As global variables are shared across different webhook calls, the following code will result in the tag value counter gradually increasing:  ``` try  {    aa = aa + 1; } catch(e) {    aa = 0; }  result = {         'tags': {             'endpoint': aa         }     }; return JSON.stringify(result); ```  Using local variables instead of global ones is recommended to make sure that each script operates on its own data and that there are no collisions between simultaneous calls.
ca	 #### Cas d'ús amb variables globals compartides entre crides de webhook  A mesura que les variables globals es comparteixen entre diferents crides de webhook, el codi següent farà que el comptador del valor de l'etiqueta augmenti gradualment:  ``` try  {    aa = aa + 1; } catch(e) {    aa = 0; }  result = {         'tags': {             'endpoint': aa         }     }; return JSON.stringify(result); ```  Es recomana emprar variables locals en lloc de globals per assegurar-se que cada script funciona amb les seves pròpies dades i que no hi ha conflicte entre crides simultànies.

en-us	# user.checkAuthentication
ca	# user.checkAuthentication

en-us	#### User-configured ciphersuites  The built-in ciphersuite selection criteria can be overridden with user-configured ciphersuites.  ::: noteimportant User-configured ciphersuites is a feature intended for advanced users who understand TLS ciphersuites, their security and consequences of mistakes, and who are comfortable with TLS troubleshooting. :::  The built-in ciphersuite selection criteria can be overridden using the following parameters:  |Override scope|Parameter|Value|Description| |--|--|------|------| |Ciphersuite selection for certificates|TLSCipherCert13|Valid OpenSSL 1.1.1 [cipher strings](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) for TLS 1.3 protocol (their values are passed to the OpenSSL function SSL\_CTX\_set\_ciphersuites()).|Certificate-based ciphersuite selection criteria for TLS 1.3<br><br>Only OpenSSL 1.1.1 or newer.| |^|TLSCipherCert|Valid OpenSSL [cipher strings](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) for TLS 1.2 or valid GnuTLS [priority strings](https://gnutls.org/manual/html_node/Priority-Strings.html). Their values are passed to the SSL\_CTX\_set\_cipher\_list() or gnutls\_priority\_init() functions, respectively.|Certificate-based ciphersuite selection criteria for TLS 1.2/1.3 (GnuTLS), TLS 1.2 (OpenSSL)| |Ciphersuite selection for PSK|TLSCipherPSK13|Valid OpenSSL 1.1.1 [cipher strings](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) for TLS 1.3 protocol (their values are passed to the OpenSSL function SSL\_CTX\_set\_ciphersuites()).|PSK-based ciphersuite selection criteria for TLS 1.3<br><br>Only OpenSSL 1.1.1 or newer.| |^|TLSCipherPSK|Valid OpenSSL [cipher strings](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) for TLS 1.2 or valid GnuTLS [priority strings](https://gnutls.org/manual/html_node/Priority-Strings.html). Their values are passed to the SSL\_CTX\_set\_cipher\_list() or gnutls\_priority\_init() functions, respectively.|PSK-based ciphersuite selection criteria for TLS 1.2/1.3 (GnuTLS), TLS 1.2 (OpenSSL)| |Combined ciphersuite list for certificate and PSK|TLSCipherAll13|Valid OpenSSL 1.1.1 [cipher strings](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) for TLS 1.3 protocol (their values are passed to the OpenSSL function SSL\_CTX\_set\_ciphersuites()).|Ciphersuite selection criteria for TLS 1.3<br><br>Only OpenSSL 1.1.1 or newer.| |^|TLSCipherAll|Valid OpenSSL [cipher strings](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) for TLS 1.2 or valid GnuTLS [priority strings](https://gnutls.org/manual/html_node/Priority-Strings.html). Their values are passed to the SSL\_CTX\_set\_cipher\_list() or gnutls\_priority\_init() functions, respectively.|Ciphersuite selection criteria for TLS 1.2/1.3 (GnuTLS), TLS 1.2 (OpenSSL)|  To override the ciphersuite selection in [zabbix\_get](/manpages/zabbix_get) and [zabbix\_sender](/manpages/zabbix_sender) utilities - use the command-line parameters:  -   `--tls-cipher13` -   `--tls-cipher`  The new parameters are optional. If a parameter is not specified, the internal default value is used. If a parameter is defined it cannot be empty.  If the setting of a TLSCipher\* value in the crypto library fails then the server, proxy or agent will not start and an error is logged.  It is important to understand when each parameter is applicable.
ca	#### Suites de xifrat configurades per l'usuari   Els criteris de selecció de la suite de xifrat integrada es poden substituir per les suites de xifrat configurades per l'usuari.  ::: noteimportant Les suites de xifrat configurades per l'usuari és una característica per als usuaris avançats que entenen les suites de xifrat TLS, la seva seguretat i les conseqüències dels errors, i que se senten còmodes amb la resolució de problemes de TLS. :::   Els criteris de selecció de la suite de xifrat integrat es poden substituir mitjançant la configuració següent:  |Substitueix l'àmbit|Paràmetre|Valor|Descripció| |--|--|-------|------| |Selecció de la suite de xifrat per als certificats OpenSSL 1.1.1|TLSCipherCert13|[Cadenes de xifrat](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) vàlid per al protocol TLS 1.3 (els seus valors ​​es passen a la funció OpenSSL SSL\_CTX\_set\_ciphersuites()).|Criteris de selecció del conjunt de xifrat basat en certificats per a TLS 1.3<br><br>Només OpenSSL 1.1.1 o versió posterior.| |^|TLSCipherCert|[Cadenes de xifrat](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) OpenSSL vàlid per a TLS 1.2 o [cadenes de prioritat](https://gnutls.org/manual/html_node/Priority-Strings.html) GnuTLS vàlid. Els seus valors es passen a les funcions SSL\_CTX\_set\_cipher\_list() o gnutls\_priority\_init(), respectivament.|Criteris de selecció de la suite de xifrat basat en certificats per a TLS 1.2/1.3 (GnuTLS), TLS 1.2 (OpenSSL)| |Selecció de la suite de xifrat per a PSK|TLSCipherPSK13|[Cadenes de xifrat](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) OpenSSL 1.1.1 vàlid per al protocol TLS 1.3 (els seus valors ​​es passen a la funció OpenSSL SSL\_CTX\_set\_ciphersuites()).|Criteris de selecció de paquets de xifrat basats en PSK per a TLS 1.3<br><br>Només OpenSSL 1.1.1 o posterior.| |^|TLSCipherPSK|[Cadenes de xifrat](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) OpenSSL vàlid per a TLS 1.2 o [cadenes de prioritat](https://gnutls.org/manual/html_node/Priority-Strings.html) GnuTLS vàlid. Els seus valors es passen a les funcions SSL\_CTX\_set\_cipher\_list() o gnutls\_priority\_init(), respectivament.|Criteris de selecció del conjunt de xifrat basat en PSK per a TLS 1.2/1.3 (GnuTLS), TLS 1.2 (OpenSSL) | |Llista combinada de conjunts de xifrat per a certificat i PSK|TLSCipherAll13|[Cadenes de xifrat](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) OpenSSL 1.1.1 vàlid per al protocol TLS 1.3 (els seus valors es passen a la funció OpenSSL SSL\_CTX\_set\_ciphersuites()).|Criteris de selecció de Ciphersuite per a TLS 1.3<br><br>Només OpenSSL 1.1.1 o posterior.| |^|TLSCipherAll|[Cadenes de xifrat](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) OpenSSL vàlid per a TLS 1.2 o [cadenes de prioritat](https://gnutls.org/manual/html_node/Priority-Strings.html) GnuTLS vàlid. Els seus valors es passen respectivament a les funcions SSL\_CTX\_set\_cipher\_list() o gnutls\_priority\_init().|Criteris de selecció de Ciphersuite per a TLS 1.2/1.3 (GnuTLS), TLS 1.2 (OpenSSL)|  Per anul·lar la selecció de la suite de xifrat a les utilitats [zabbix\_get](/manpages/zabbix_get) i [zabbix\_sender](/manpages/zabbix_sender), empreu els paràmetres de la línia d'ordres:  - `--tls-cipher13` - `--tls-cipher`  Els nous paràmetres són opcionals. Si no s'especifica cap paràmetre, s'empra el valor per defecte intern. Si es defineix un paràmetre, no pot ésser buit.  Si no s'estableix un valor TLSCipher\* a la biblioteca de xifrat, el servidor, el proxy o l'agent no s'inicien i es registra un error.  És important entendre quan cada paràmetre és aplicable.

en-us	# user.create
ca	# user.create

en-us	### User creation    A new user cannot be created without assigning a user role to them anymore (user role setting can be found under *Permissions* tab). When trying to do so, you will face an error stating: *"Cannot add user: field "roleid" is mandatory"*.
ca	### Creació d'usuaris  Ja no es pot crear un usuari nou sense assignar-li una funció d'usuari (la configuració de la funció d'usuari es pot trobar a la pestanya *Permisos*). Quan intenteu fer-ho, trobareu un error que indica: *"No es pot afegir usuari: el camp "roleid" és obligatori"*.

en-us	### User creation    A new user cannot be created without assigning a user role to them anymore (user role setting can be found under *Permissions* tab). When trying to do so, you will face an error stating: *"Cannot add user: field "roleid" is mandatory"*.
ca	### Creació d'usuaris  Ja no es pot crear un usuari nou sense assignar-li una funció d'usuari (la configuració de la funció d'usuari es pot trobar a la pestanya *Permisos*). Quan intenteu fer-ho, trobareu un error que indica: *"No es pot afegir usuari: el camp "roleid" és obligatori"*.

en-us	# user.delete
ca	# user.delete

en-us	# userdirectory.create
ca	# userdirectory.create

en-us	# userdirectory.delete
ca	# userdirectory.delete

en-us	# userdirectory.get
ca	# userdirectory.get

en-us	# > User directory object  The following objects are directly related to the `userdirectory` API.
ca	# > Objecte directori d'usuaris  Els objectes següents són relacionats directament amb l'API `userdirectory`.

en-us	# userdirectory.test
ca	# userdirectory.test

en-us	### User directory  The user directory object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |userdirectoryid|string|ID of the user directory.<br><br>If a user directory is deleted, the value of the [User object](/manual/api/reference/user/object#user) property `userdirectoryid` is set to "0" for all users that are linked to the deleted user directory.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |idp_type|integer|Type of the authentication protocol used by the identity provider for the user directory.<br>Note that only one user directory of type SAML can exist.<br><br>Possible values:<br>1 - User directory of type LDAP;<br>2 - User directory of type SAML.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |group_name|string|LDAP/SAML user directory attribute that contains the group name used to map groups between the LDAP/SAML user directory and Zabbix.<br><br>Example: *cn*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `provision_status` is set to "Enabled" and `saml_jit_status` of [Authentication object](/manual/api/reference/authentication/object#authentication) is set to "Enabled for configured SAML IdPs"| |user_username|string|LDAP/SAML user directory attribute (also SCIM attribute if `scim_status` is set to "SCIM provisioning is enabled") that contains the user's name which is used as the value for the [User object](/manual/api/reference/user/object#user) property `name` when the user is provisioned.<br><br>Examples: *cn*, *commonName*, *displayName*, *name*| |user_lastname|string|LDAP/SAML user directory attribute (also SCIM attribute if `scim_status` is set to "SCIM provisioning is enabled") that contains the user's last name which is used as the value for the [User object](/manual/api/reference/user/object#user) property `surname` when the user is provisioned.<br><br>Examples: *sn*, *surname*, *lastName*| |provision_status|integer|Provisioning status of the user directory.<br><br>Possible values:<br>0 - *(default)* Disabled (provisioning of users created by this user directory is disabled);<br>1 - Enabled (provisioning of users created by this user directory is enabled; additionally, the status of LDAP or SAML provisioning (`ldap_jit_status` or `saml_jit_status` of [Authentication object](/manual/api/reference/authentication/object#authentication)) must be enabled).| |provision_groups|array|Array of [provisioning groups mappings](object#provisioning_groups_mappings) objects for mapping LDAP/SAML user group pattern to Zabbix user group and user role.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `provision_status` is set to "Enabled"| |provision_media|array|Array of [media type mappings](object#media_type_mappings) objects for mapping user's LDAP/SAML media attributes (e.g., email) to Zabbix user media for sending notifications.| |**[LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap)-specific properties:**|<|<| |name|string|Unique name of the user directory.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `idp_type` is set to "User directory of type LDAP"| |host|string|Host name, IP or URI of the LDAP server.<br>URI must contain schema (`ldap://` or `ldaps://`), host, and port (optional).<br><br>Examples:<br>*host.example.com*<br>*127.0.0.1*<br>*ldap://ldap.example.com:389*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `idp_type` is set to "User directory of type LDAP"| |port|integer|Port of the LDAP server.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `idp_type` is set to "User directory of type LDAP"| |base_dn|string|LDAP user directory base path to user accounts.<br><br>Examples:<br>*ou=Users,dc=example,dc=org*<br>*ou=Users,ou=system* (for OpenLDAP)<br>*DC=company,DC=com* (for Microsoft Active Directory)<br>*uid=%{user},dc=example,dc=com* (for direct user binding; placeholder "*%{user}*" is mandatory)<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `idp_type` is set to "User directory of type LDAP"| |search_attribute|string|LDAP user directory attribute by which to identify the user account from the information provided in the login request.<br><br>Examples:<br>*uid* (for OpenLDAP)<br>*sAMAccountName* (for Microsoft Active Directory)<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `idp_type` is set to "User directory of type LDAP"| |bind_dn|string|LDAP server account for binding and searching over the LDAP server.<br><br>For direct user binding and anonymous binding, `bind_dn` must be empty.<br><br>Examples:<br>*uid=ldap_search,ou=system* (for OpenLDAP)<br>*CN=ldap_search,OU=user_group,DC=company,DC=com* (for Microsoft Active Directory)<br>*CN=Admin,OU=Users,OU=Zabbix,DC=zbx,DC=local*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type LDAP"| |bind_password|string|LDAP password of the account for binding and searching over the LDAP server.<br><br>For direct user binding and anonymous binding, `bind_password` must be empty.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type LDAP"| |description|string|Description of the user directory.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type LDAP"| |group_basedn|string|LDAP user directory base path to groups; used to configure a user membership check in the LDAP user directory.<br><br>Ignored when provisioning a user if `group_membership` is set.<br><br>Example: *ou=Groups,dc=example,dc=com*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type LDAP"| |group_filter|string|Filter string for retrieving LDAP user directory groups that the user is a member of; used to configure a user membership check in the LDAP user directory.<br><br>Ignored when provisioning a user if `group_membership` is set.<br><br>Supported `group_filter` placeholders:<br>*%{attr}* - search attribute (replaced by the `search_attribute` property value);<br>*%{groupattr}* - group attribute (replaced by the `group_member` property value);<br>*%{host}* - host name, IP or URI of the LDAP server (replaced by the `host` property value);<br>*%{user}* - Zabbix user username.<br><br>Default: *(%{groupattr}=%{user})*<br><br>Examples:<br>- *(member=uid=%{ref},ou=Users,dc=example,dc=com)* will match "User1" if an LDAP group object contains the "*member*" attribute with the value "*uid=User1,ou=Users,dc=example,dc=com*", and will return the group that "User1" is a member of;<br>- *(%{groupattr}=cn=%{ref},ou=Users,ou=Zabbix,DC=example,DC=com)* will match "User1" if an LDAP group object contains the attribute specified in the `group_member` property with the value "*cn=User1,ou=Users,ou=Zabbix,DC=example,DC=com*", and will return the group that "User1" is a member of.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type LDAP"| |group_member|string|LDAP user directory attribute that contains information about the group members; used to configure a user membership check in the LDAP user directory.<br><br>Ignored when provisioning a user if `group_membership` is set.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type LDAP"| |group_membership|string|LDAP user directory attribute that contains information about the groups that a user belongs to.<br><br>Example: *memberOf*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type LDAP"| |search_filter|string|Custom filter string used to locate and authenticate a user in an LDAP user directory based on the information provided in the login request.<br><br>Supported `search_filter` placeholders:<br>*%{attr}* - search attribute name (e.g., *uid*, *sAMAccountName*);<br>*%{user}* - Zabbix user username.<br><br>Default: *(%{attr}=%{user})*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type LDAP"| |start_tls|integer|LDAP server configuration option that allows the communication with the LDAP server to be secured using Transport Layer Security (TLS).<br><br>Note that `start_tls` must be set to "Disabled" for hosts using the `ldaps://` protocol.<br><br>Possible values:<br>0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type LDAP"| |user_ref_attr|string|LDAP user directory attribute used to reference a user object. The value of `user_ref_attr` is used to get values from the specified attribute in the user directory and place them instead of the *%{ref}* placeholder in the `group_filter` string.<br><br>Examples: *cn*, *uid*, *member*, *uniqueMember*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type LDAP"| |**[SAML](/manual/web_interface/frontend_sections/users/authentication/saml)-specific properties:**|<|<| |idp_entityid|string|URI that identifies the identity provider and is used to communicate with the identity provider in SAML messages.<br><br>Example: *https://idp.example.com/idp*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `idp_type` is set to "User directory of type SAML"| |sp_entityid|string|URL or any string that identifies the identity provider's service provider.<br><br>Examples:<br>*https://idp.example.com/sp*<br>*zabbix*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `idp_type` is set to "User directory of type SAML"| |username_attribute|string|SAML user directory attribute (also SCIM attribute if `scim_status` is set to "SCIM provisioning is enabled") that contains the user's username which is compared with the value of the [User object](/manual/api/reference/user/object#user) property `username` when authenticating.<br><br>Examples: *uid*, *userprincipalname*, *samaccountname*, *username*, *userusername*, *urn:oid:0.9.2342.19200300.100.1.1*, *urn:oid:1.3.6.1.4.1.5923.1.1.1.13*, *urn:oid:0.9.2342.19200300.100.1.44*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `idp_type` is set to "User directory of type SAML"| |sso_url|string|URL of the identity provider's SAML single sign-on service, to which Zabbix will send the SAML authentication requests.<br><br>Example: *http://idp.example.com/idp/sso/saml*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `idp_type` is set to "User directory of type SAML"|  |slo_url|string|URL of the identity provider's SAML single log-out service, to which Zabbix will send the SAML logout requests.<br><br>Example: *https://idp.example.com/idp/slo/saml*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type SAML"| |encrypt_nameid|integer|Whether the SAML name ID should be encrypted.<br><br>Possible values:<br>0 - *(default)* Do not encrypt name ID;<br>1 - Encrypt name ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type SAML"| |encrypt_assertions|integer|Whether the SAML assertions should be encrypted.<br><br>Possible values:<br>0 - *(default)* Do not encrypt assertions;<br>1 - Encrypt assertions.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type SAML"| |nameid_format|string|Name ID format of the SAML identity provider's service provider.<br><br>Examples:<br>*urn:oasis:names:tc:SAML:2.0:nameid-format:persistent*<br>*urn:oasis:names:tc:SAML:2.0:nameid-format:transient*<br>*urn:oasis:names:tc:SAML:2.0:nameid-format:kerberos*<br>*urn:oasis:names:tc:SAML:2.0:nameid-format:entity*<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type SAML"| |scim_status|integer|Whether SCIM provisioning for SAML is enabled or disabled.<br><br>Possible values:<br>0 - *(default)* SCIM provisioning is disabled;<br>1 - SCIM provisioning is enabled.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type SAML"| |sign_assertions|integer|Whether the SAML assertions should be signed with a SAML signature.<br><br>Possible values:<br>0 - *(default)* Do not sign assertions;<br>1 - Sign assertions.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type SAML"| |sign_authn_requests|integer|Whether the SAML AuthN requests should be signed with a SAML signature.<br><br>Possible values:<br>0 - *(default)* Do not sign AuthN requests;<br>1 - Sign AuthN requests.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type SAML"| |sign_messages|integer|Whether the SAML messages should be signed with a SAML signature.<br><br>Possible values:<br>0 - *(default)* Do not sign messages;<br>1 - Sign messages.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type SAML"| |sign_logout_requests|integer|Whether the SAML logout requests should be signed with a SAML signature.<br><br>Possible values:<br>0 - *(default)* Do not sign logout requests;<br>1 - Sign logout requests.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type SAML"| |sign_logout_responses|integer|Whether the SAML logout responses should be signed with a SAML signature.<br><br>Possible values:<br>0 - *(default)* Do not sign logout responses;<br>1 - Sign logout responses.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `idp_type` is set to "User directory of type SAML"|
ca	### Directori d'usuari  El directori d'usuari té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |userdirectoryid|cadena|ID del directori d'usuari.<br><br>Si s'esborra un directori d'usuari, el valor de la propietat [User object](/manual/api/reference/user/object#user) `userdirectoryid` s'estableix a "0" per a tots els usuaris que són enllaçats al directori d'usuaris esborrat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura* <br>- *obligatori* per a les operacions d'actualització| |idp_type|enter|Tipus del protocol d'autenticació que empra el proveïdor d'identitats per al directori d'usuaris.<br>Tingueu en compte que només pot existir un directori d'usuaris de tipus SAML.<br><br>Valors possibles:<br>1 -Directori d'usuaris de tipus LDAP;<br>2 -Directori d'usuaris de tipus SAML.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per a operacions de creació| |name_group|cadena|Atribut del directori d'usuaris LDAP/SAML que conté el nom del grup emprat per mapar grups entre el directori d'usuaris LDAP/SAML i Zabbix.<br><br>Exemple: *cn*<br><br>[Comportament de la propietat ](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `provision_status` s'estableix a "Activat" i `saml_jit_status` d'[Objecte d'autenticació](/manual/api/reference/authentication/ object#authentication) s'estableix a "Habilitat per als IdP SAML configurats"| |user_username|cadena|Atribut del directori d'usuari LDAP/SAML (també atribut SCIM si `scim_status` s'estableix a "El subministrament SCIM és habilitat") que conté el nom de l'usuari que s'empra com a valor per a l'[objecte d'usuari](/manual/ api/reference/user/object#user) propietat `name` quan s'aprovisiona l'usuari.<br><br>Exemples: *cn*, *commonName*, *displayName*, *name*| |user_lastname|cadena|Atribut del directori d'usuari LDAP/SAML (també atribut SCIM si `scim_status` és establert a "El subministrament SCIM és activat") que conté el cognom de l'usuari que s'empra com a valor per a l'[objecte d'usuari](/manual /api/reference/user/object#user) propietat `cognom` quan s'aprovisiona l'usuari.<br><br>Exemples: *sn*, *surname*, *lastName*| |provision_status|enter|Estat d'aprovisionament del directori d'usuaris.<br><br>Valors possibles:<br>0 - *(per defecte)* Inhabilitat (l'aprovisionament dels usuaris creats per aquest directori d'usuaris és desactivat);<br>1 - Activat (l'aprovisionament d'usuaris creats per aquest directori d'usuaris és habilitat; a més, l'estat de l'aprovisionament LDAP o SAML (`ldap_jit_status` o `saml_jit_status` de l'[Objecte d'autenticació](/manual/api/reference/authentication/object#authentication))) s'ha d'habilitar).| |provision_groups|array|Matriu d'objectes [mapatges de grups d'aprovisionament](object#provisioning_groups_mappings) per associar el patró de grup d'usuaris LDAP/SAML al grup d'usuaris i rol d'usuari Zabbix.<br><br>[Comportament de la propietat](/manual/api/ reference_commentary#property-behavior):<br>- *obligatori* si `provision_status` és establert com a "Activat"| |provision_media|array|Matriu de [mapatges de tipus de suport](object#media_type_mappings) objectes per assignar els atributs de mitjans LDAP/SAML de l'usuari (per exemple, correu electrònic) als mitjans d'usuari Zabbix per enviar notificacions.| |**Propietats específiques d'[LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap):**|<|<| |name|cadena|Nom únic del directori d'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `idp_type` és establert a " Directori d'usuaris de tipus LDAP"| |host|cadena|Nom d'equip, IP o URI del servidor LDAP.<br>l'URI ha de contindre l'esquema (`ldap://` o `ldaps://`), l'equip i el port (opcional).<br><br>Exemples:<br>*equip.exemple.com*<br>*127.0.0.1*<br>*ldap://ldap.example.com:389*<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `idp_type` és establert a "Directori d'usuari de tipus LDAP"| |port|enter|Port del servidor LDAP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `idp_type` és establert a "Usuari directori de tipus LDAP"| |base_dn|cadena|Camí base del directori d'usuaris LDAP als comptes d'usuari.<br><br>Exemples:<br>*ou=Usuaris,dc=exemple,dc=org*<br>*ou=Usuaris,ou=sistema* (per a OpenLDAP)<br>*DC=company,DC=com* (per a Microsoft Active Directory)<br>*uid=%{user},dc=example,dc=com* (per a l'enllaç directe d'usuari; marcador de posició "*%{user}*" és obligatori)<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `idp_type` s'estableix a "Directori d'usuari de escriviu LDAP"| |search_attribute|cadena|Atribut del directori d'usuari LDAP pel qual s'identifica el compte d'usuari a partir de la informació proporcionada a la petició d'inici de sessió.<br><br>Exemples:<br>*uid* (per a OpenLDAP)<br>*sAMAccountName* (per a Microsoft Active Directory)<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `idp_type` és establert a "Directori d'usuari de tipus LDAP"| |bind_dn|cadena|Compte de servidor LDAP per vincular i cercar al servidor LDAP.<br><br>Per a l'enllaç directe d'usuari i l'enllaç anònim, `bind_dn` ha de ser buit.<br><br>Exemples:<br>*uid=ldap_search,ou=system* (per a OpenLDAP)<br>*CN=ldap_search,OU=grup_usuaris,DC=empresa,DC=com* (per a Microsoft Active Directory)<br>*CN=Administrador,OU=Usuaris,OU=Zabbix,DC=zbx,DC=local*<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuaris de tipus LDAP"| |bind_password|cadena|mot de pas LDAP del compte per vincular i cercar al servidor LDAP.<br><br>Per a l'enllaç directe d'usuari i l'enllaç anònim, `bind_password` ha de ser buit.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuaris de tipus LDAP"| |description|cadena|Descripció del directori d'usuaris.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus LDAP"| |group_basedn|cadena|Ruta base del directori d'usuaris LDAP als grups; s'empra per configurar una comprovació de pertinença d'usuari al directori d'usuaris LDAP.<br><br>S'ignora quan s'aprovisiona un usuari si s'ha definit `group_membership`.<br><br>Exemple: *ou=Groups,dc=example,dc=com*<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus LDAP"| |group_filter|cadena|Cadena de filtre per recuperar grups de directoris d'usuaris LDAP dels quals l'usuari n'és membre; s'empra per configurar una comprovació de pertinença d'usuari al directori d'usuaris LDAP.<br><br>S'ignora quan s'aprovisiona un usuari si s'ha definit `group_membership`.<br><br>Reservadors de posició `group_filter` admesos:<br>*%{attr}* - atribut de cerca (substituït pel valor de propietat `search_attribute`);<br>*%{groupattr}* - atribut de grup (substituït pel valor de propietat `group_member`);<br>*%{host}* - nom d'equip, IP o URI del servidor LDAP (substituït pel valor de la propietat `host`);<br>*%{user}* - nom d'usuari de l'usuari Zabbix.<br><br>Per defecte: *(%{groupattr}=% {usuari})*<br><br>Exemples:<br>- *(member=uid=%{ref},ou=Usuaris,dc=example,dc=com)* coincidirà amb "Usuari1" si un grup LDAP conté l'atribut "*member*" amb el valor "*uid=Usuari1,ou=Usuaris,dc=example,dc=com*", i retornarà el grup del qual "Usuari1" n'és membre;<br>- *(%{groupattr}=cn=%{ref},ou=Usuaris,ou=Zabbix,DC=example,DC=com)* coincidirà amb "Usuari1" si un objecte de grup LDAP conté l'atribut especificat a la propietat `group_member` amb el valor "*cn=Usuari1,ou=Usuaris,ou=Zabbix,DC=example,DC=com*", i retornarà el grup del qual "Usuari1" n'és membre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` s'estableix a "Directori d'usuaris de tipus LDAP"| |group_member|cadena|Atribut del directori d'usuaris LDAP que conté informació sobre els membres del grup; s'empra per configurar una comprovació de pertinença d'usuari al directori d'usuaris LDAP.<br><br>S'ignora quan s'aprovisiona un usuari si s'ha definit `group_membership`.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property -behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus LDAP"| |group_membership|cadena|Atribut del directori d'usuaris LDAP que conté informació sobre els grups als quals pertany un usuari.<br><br>Exemple: *memberOf*<br><br>[Comportament de la propietat](/manual/api/reference_commentary# property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus LDAP"| |search_filter|cadena|Cadena de filtre personalitzada que s'empra per trobar i autenticar un usuari en un directori d'usuaris LDAP en funció de la informació proporcionada a la petició d'inici de sessió.<br><br>Reservadors de posició `search_filter` admesos:<br>*%{attr}* - nom de l'atribut de cerca (p. ex., *uid*, *sAMAccountName*);<br>*%{user}* - nom d'usuari de Zabbix.<br><br>Per defecte: *(%{attr}=%{user})*<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus LDAP"| |start_tls|enter|Opció de configuració del servidor LDAP que permet assegurar la comunicació amb el servidor LDAP mitjançant Transport Layer Security (TLS).<br><br>Tingueu en compte que `start_tls` s'ha d'establir com a "Desactivat" per als equips que empren el Protocol `ldaps://`.<br><br>Valors possibles:<br>0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus LDAP"| |user_ref_attr|cadena|Atribut del directori d'usuari LDAP emprat per fer referència a un objecte d'usuari. El valor d'`user_ref_attr` s'empra per obtindre valors de l'atribut especificat al directori d'usuari i posar-los en lloc del marcador de posició *%{ref}* a la cadena `group_filter`.<br><br>Exemples: *cn* , *uid*, *member*, *uniqueMember*<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuaris de tipus LDAP"| |**[SAML](/manual/web_interface/frontend_sections/users/authentication/saml)-propietats específiques:**|<|<| |idp_entityid|cadena|URI que identifica el proveïdor d'identitat i s'empra per comunicar-se amb el proveïdor d'identitat als missatges SAML.<br><br>Exemple: *https://idp.example.com/idp*<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `idp_type` és establert a "Directori d'usuari de tipus SAML"| |sp_entityid|cadena|URL o qualsevol cadena que identifiqui el proveïdor de serveis del proveïdor d'identitat.<br><br>Exemples:<br>*https://idp.example.com/sp*<br>*zabbix*<br> <br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `idp_type` és establert a "Directori d'usuari de tipus SAML"| |username_attribute|cadena|SAML user directory attribute (també atribut SCIM si `scim_status` s'estableix a "provisionament SCIM activat") que conté el nom d'usuari de l'usuari que es compara amb el valor de la propietat `username` de l'[Objecte usuari](/manual/api/reference/user/object#user) quan s'autentica.<br><br>Exemples: *uid*, *userprincipalname*, *samaccountname*, *username*, *username*, *urn:oid:0.9. 2342.19200300.100.1.1*, *urn:oid:1.3.6.1.4.1.5923.1.1.1.13*, *urn:oid:0.9.2342.19200300.100.1.44*<br><br><br>[Comportament de propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `idp_type` és establert a "Directori d'usuari de tipus SAML"| |sso_url|cadena|URL del servei d'inici de sessió únic SAML del proveïdor d'identitats, al qual Zabbix enviarà les peticions d'autenticació SAML.<br><br>Exemple: *http://idp.example.com/idp/sso/saml*<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `idp_type` és establert a "Directori d'usuari de tipus SAML"| |slo_url|cadena|URL del servei de tancament únic de SAML del proveïdor d'identitats, al qual Zabbix enviarà les peticions de tancament de SAML.<br><br>Exemple: *https://idp.example.com/idp/slo/saml*<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus SAML"| |encrypt_nameid|enter|Si l'ID de nom SAML s'ha de xifrar.<br><br>Valors possibles:<br>0 -*(per defecte)* No encripteu l'ID de nom;<br>1 - Encripteu l'ID de nom.<br ><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` s'estableix en "Directori d'usuari de tipus SAML"| |encrypt_assertions|enter|Si les afirmacions SAML s'han de xifrar.<br><br>Valors possibles:<br>0 - *(per defecte)* No encripteu les afirmacions;<br>1 - Encripteu les afirmacions.<br><br >[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuaris de tipus SAML"| |nameid_format|cadena|Format d'identificador de nom del proveïdor de serveis del proveïdor d'identitat SAML.<br><br>Exemples:<br>*urn:oasis:names:tc:SAML:2.0:nameid-format:persistent*<br>*urn:oasis:names:tc:SAML:2.0:nameid-format:transient*<br>*urn:oasis:names:tc:SAML:2.0:nameid-format:kerberos*<br>*urn:oasis:names:tc:SAML:2.0:nameid-format:entity*<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuaris de tipus SAML"| |scim_status|enter|Si el subministrament SCIM per a SAML és activat o desactivat.<br><br>Valors possibles:<br>0 - *(per defecte)* El subministrament SCIM és desactivat;<br>1 - El subministrament SCIM és habilitat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus SAML"| |sign_assertions|enter|Si les afirmacions SAML s'han de signar amb una signatura SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* No signar assercions;<br>1 - Signar assercions.< br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus SAML"| |sign_authn_requests|enter|Si les peticions d'autenticació SAML s'han de signar amb una signatura SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* No signar peticions d'autenticació;<br>1 - Signa peticions d'autenticació.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus SAML"| |sign_messages|enter|Si els missatges SAML s'han de signar amb una signatura SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* No signar missatges;<br>1 - Signar missatges.< br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus SAML"| |sign_logout_requests|enter|Si les peticions de tancament de sessió de SAML s'han de signar amb una signatura SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* No inicieu la sessió de peticions de tancament de sessió;<br>1 - Tanqueu la sessió.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus SAML"| |sign_logout_responses|enter|Si les respostes de tancament de sessió de SAML s'han de signar amb una signatura SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* No inicieu la sessió de respostes de tancament de sessió;<br>1 - Tanqueu la sessió respostes.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `idp_type` és establert a "Directori d'usuari de tipus SAML"|

en-us	# User directory  This class is designed to work with user directories.  Object references:\  -   [User directory](/manual/api/reference/userdirectory/object#userdirectory)  Available methods:\  -   [userdirectory.create](/manual/api/reference/userdirectory/create) - create new user directory -   [userdirectory.delete](/manual/api/reference/userdirectory/delete) - delete user directory -   [userdirectory.get](/manual/api/reference/userdirectory/get) - retrieve user directory -   [userdirectory.update](/manual/api/reference/userdirectory/update) - update user directory -   [userdirectory.test](/manual/api/reference/userdirectory/test) - test user directory connection
ca	# Directori d'usuaris  Aquest objecte és dissenyat per treballar amb directoris d'usuaris.  Referències d'objectes:\  -   [Directori d'usuaris](/manual/api/reference/userdirectory/object#userdirectory)  Mètodes disponibles:\  -   [userdirectory.create](/manual/api/reference/userdirectory/create) - crear nou directori d'usuaris -   [userdirectory.delete](/manual/api/reference/userdirectory/delete) - esborrar directoris d'usuaris -   [userdirectory.get](/manual/api/reference/userdirectory/get) - recuperar directoris d'usuaris -   [userdirectory.update](/manual/api/reference/userdirectory/update) - actualitzar directoris d'usuaris -   [userdirectory.test](/manual/api/reference/userdirectory/test) - prova la connexió amb directoris d'usuaris

en-us	# userdirectory.update
ca	# userdirectory.update

en-us	#### userdirectory  [ZBX-22800](https://support.zabbix.com/browse/ZBX-22800) `userdirectory.get`: Restored sorting by `name`.\
ca	#### userdirectory  [ZBX-22800](https://support.zabbix.com/browse/ZBX-22800) `userdirectory.get`: Restaurat ordenant per `name`.\

en-us	#### userdirectory  [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Added new properties `idp_type`, `provision_status`, `user_username`, `user_lastname`, `user_ref_attr`, `group_membership`, `group_basedn`, `group_name`, `group_member`, `group_filter`, `idp_entityid`, `sp_entityid`, `sso_url`, `slo_url`, `username_attribute`, `nameid_format`, `scim_status`, `encrypt_nameid`, `encrypt_assertions`, `sign_messages`, `sign_assertions`, `sign_authn_requests`, `sign_logout_requests`, `sign_logout_responses`, `provision_media`, `provision_groups`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: Removed support for searching by `base_dn`, `bind_dn`, `host`, `search_attribute`, `search_filter`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: Removed support for filtering by `host`, `name`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: Added support for filtering by `idp_type`, `provision_status`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: Added new parameters `selectProvisionMedia`, `selectProvisionGroups`.\
ca	#### userdirectory  [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) S'han afegit les noves propietats `idp_type`, `provision_status`, `user_username`, `user_lastname`, `user_ref_attr`, `group_membership`` group_basedn`, `group_name`, `group_member`, `group_filter`, `idp_entityid`, `sp_entityid`, `sso_url`, `slo_url`, `username_attribute`, `nameid_format`, `scim_status`encrypt_id`, `scim_status`encrypt_id`, `sign_messages`, `sign_assertions`, `sign_authn_requests`, `sign_logout_requests`, `sign_logout_responses`, `provision_media`, `provision_groups`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: S'ha trete el suport per a la cerca per `base_dn`, `bind_dn`, `host`, `search_attribute`, `search_filter`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: s'ha tret el suport per al filtrat per `host`, `name`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: S'ha afegit suport per al filtrat per `idp_type`, `provision_status`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: S'han afegit els nous paràmetres `selectProvisionMedia`, `selectProvisionGroups`.\

en-us	##### User  Drop privileges to a specific, existing user on the system.<br>Only has effect if run as 'root' and AllowRoot is disabled.  Default: `zabbix`
ca	##### Usuari  Treu els privilegis a un usuari específic existent al sistema.<br>Només té efecte si s'executa com a'root' i AllowRoot és desactivat.  Per defecte: `zabbix`

en-us	##### User  Drop privileges to a specific, existing user on the system.<br>Only has effect if run as 'root' and AllowRoot is disabled.  Default: `zabbix`
ca	##### Usuari  Treu els privilegis a un usuari específic existent al sistema.<br>Només té efecte si s'executa com a'root' i AllowRoot és desactivat.  Per defecte: `zabbix`

en-us	##### User Drop privileges to a specific, existing user on the system.<br>Only has effect if run as 'root' and AllowRoot is disabled.  Default: `zabbix`
ca	##### Usuari Treu els privilegis a un usuari específic existent al sistema.<br>Només té efecte si s'executa com a'root' i AllowRoot és desactivat.  Per defecte: `zabbix`

en-us	# user.get
ca	# user.get

en-us	# usergroup.create
ca	# usergroup.create

en-us	# usergroup.delete
ca	# usergroup.delete

en-us	# usergroup.get
ca	# usergroup.get

en-us	# > User group object  The following objects are directly related to the `usergroup` API.
ca	# > Objecte grup d'usuaris  Els següents objectes són relacionats amb l'API `usergroup`.

en-us	#### User groups  A listing of existing user groups with their details is displayed.  ![](../../../../../assets/en/manual/web_interface/user_groups0.png){width="600"}  Displayed data:  |Column|Description| |--|--------| |*Name*|Name of the user group. Clicking on the user group name opens the user group [configuration form](/manual/config/users_and_usergroups/usergroup#configuration).| |*\#*|The number of users in the group. Clicking on *Users* will display the respective users filtered out in the user list.| |*Members*|Usernames of individual users in the user group (with name and surname in parentheses). Clicking on the username will open the user configuration form. Users from disabled groups are displayed in red.| |*Frontend access*|Frontend access level is displayed:<br>**System default** - users are authenticated by Zabbix, LDAP or HTTP (depending on the [authentication](authentication) method set globally);<br>**Internal** - users are authenticated by Zabbix; ignored if HTTP authentication is the global default;<br>**LDAP** - users are authenticated by LDAP; ignored if HTTP authentication is the global default;<br>**Disabled** - access to Zabbix frontend is forbidden for this group.<br>By clicking on the current level, you can change it.| |*Debug mode*|[Debug mode](/manual/web_interface/debug_mode) status is displayed - *Enabled* or *Disabled*. By clicking on the status you can change it.| |*Status*|User group status is displayed - *Enabled* or *Disabled*. By clicking on the status you can change it.|  To configure a new user group, click on the *Create user group* button in the top right-hand corner.
ca	 #### Grups d'usuaris  Es mostra una llista dels grups d'usuaris existents amb els seus detalls.  ![](../../../../../assets/en/manual/web_interface/user_groups0.png){width="600"}  Dades mostrades:  |Columna|Descripció| |--|---------| |*Nom*|Nom del grup d'usuaris. Si feu clic al nom del grup d'usuaris, s'obre el [formulari de configuració](/manual/config/users_and_usergroups/usergroup#configuration) per al grup d'usuaris.| |*\#*|El nombre d'usuaris del grup. En fer clic a *Usuaris* es mostraran els respectius usuaris filtrats a la llista d'usuaris.| |*Membres*|Noms d'usuari dels usuaris individuals del grup d'usuaris (amb els noms i cognoms entre parèntesis). Si feu clic al nom d'usuari, s'obrirà el formulari de configuració de l'usuari. Els usuaris dels grups desactivats surten en vermell.| |*Accés a la interfície*|Es mostra el nivell d'accés a la interfície:<br>**Per defecte del sistema** - Autenticació Zabbix, LDAP o HTTP; en funció de l'autenticació escollida [mètode] (authentication)<br>**Intern** - l'usuari és autenticat per Zabbix;s'ignora si l'autenticació HTTP és la predeterminada global;<br>**LDAP** - els usuaris s'autentiquen mitjançant LDAP; s'ignora si l'autenticació HTTP és el valor predeterminat global;<br>**Desactivat** -  l'accés a la interfície de Zabbix és prohibit per a aquest grup.<br>Feu clic al nivell actual, podeu canviar-lo.| |*Mode de depuració*|Es mostra [mode de depuració](/manual/web_interface/debug_mode) - *Activat* o *Desactivat*. Si feu clic a l'estat, podeu canviar-lo.| |*Estat*|Es mostra l'estat del grup d'usuaris - *Activat* o *Desactivat*. Si feu clic a l'estat, podeu canviar-lo.|  Per configurar un grup d'usuaris nou, feu clic al botó *Crear grup d'usuaris* a l'extrem superior dret.

en-us	### User groups  The user groups object has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |usrgrpid|string|ID of user group to send the report to.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |access\_userid|string|ID of user on whose behalf the report will be generated.<br><br>0 - *(default)* Generate report by recipient.|
ca	### Grups d'usuaris  L'objecte té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |usergrpid|string|ID del grup d'usuaris a qui enviar l'informe.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |access\_userid|string|ID de l'usuari en nom del qual es generarà l'informe.<br><br>0 - *(per defecte)* Genereu un informe per destinatari.|

en-us	### User group  The user group object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |usrgrpid|string|ID of the user group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the user group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |debug\_mode|integer|Whether debug mode is enabled or disabled.<br><br>Possible values:<br>0 - *(default)* disabled;<br>1 - enabled.| |gui\_access|integer|Frontend authentication method of the users in the group.<br><br>Possible values:<br>0 - *(default)* use the system default authentication method;<br>1 - use internal authentication;<br>2 - use LDAP authentication;<br>3 - disable access to the frontend.| |users\_status|integer|Whether the user group is enabled or disabled.<br>For [deprovisioned](/manual/web_interface/frontend_sections/users/authentication#configuration) users, the user group cannot be enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |userdirectoryid|string|User directory used for authentication.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `gui_access` is set to "use the system default authentication method" or "use LDAP authentication"|
ca	### Grup d'usuaris  L'obecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |usrgrpid|string|ID del grup d'usuaris.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |name|string|Nom del grup d'usuaris.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |debug\_mode|integer|Indica si el mode de depuració és activat o desactivat.<br><br>Valors possibles:<br>0 - *(per defecte)* desactivat;<br>1 - activat.| |gui\_access|integer|Mètode d'autenticació de la GUI per a usuaris del grup.<br><br>Valors possibles:<br>0 - *(per defecte)* mètode d'autenticació predeterminat del sistema; <br>1 - autenticació interna;<br>2 - Empreu l'autenticació LDAP; 3 - accés desactivat.| |users\_status|integer|Indica si el grup d'usuaris és actiu o no .<br><br>Valors possibles:<br>0 - *(per defecte)* actiu;<br>1 - desactivat.|  |userdirectoryid|string|Directori d'usuari emprat per l'autenticació.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `gui_access` és "emprar el mètode d'autenticació per defecte del sistema" o "emprar autenticació LDAP"|

en-us	# User group  This class is designed to work with user groups.  Object references:\  -   [User group](/manual/api/reference/usergroup/object#user_group)  Available methods:\  -   [usergroup.create](/manual/api/reference/usergroup/create) -     creating new user groups -   [usergroup.delete](/manual/api/reference/usergroup/delete) -     deleting user groups -   [usergroup.get](/manual/api/reference/usergroup/get) - retrieving     user groups -   [usergroup.update](/manual/api/reference/usergroup/update) -     updating user groups
ca	# Grup d'usuaris  Aquest objecte és dissenyat per treballar amb grups d'usuaris.  Referències d'objectes:\  -   [Grup d'usuaris](/manual/api/reference/usergroup/object#user_group)  Mètodes disponibles:\  -   [usergroup.create](/manual/api/reference/usergroup/create) - crear nou grup d'usuaris -   [usergroup.delete](/manual/api/reference/usergroup/delete) - esborrar grups d'usuaris -   [usergroup.get](/manual/api/reference/usergroup/get) - recuperar grups d'usuaris -   [usergroup.update](/manual/api/reference/usergroup/update) - actualitzar grups d'usuaris

en-us	# usergroup.update
ca	# usergroup.update

en-us	# user.login
ca	# user.login

en-us	# user.logout
ca	# user.logout

en-us	#### User macro context  See [user macros with context](/manual/config/macros/user_macros_context).
ca	#### Context de la macro d'usuari  Veieu [macros d'usuari amb context](/manual/config/macros/user_macros_context).

en-us	# usermacro.create
ca	# usermacro.create

en-us	# usermacro.createglobal
ca	# usermacro.createglobal

en-us	# usermacro.delete
ca	# usermacro.delete

en-us	# usermacro.deleteglobal
ca	# usermacro.deleteglobal

en-us	# usermacro.get
ca	# usermacro.get

en-us	# > User macro object  The following objects are directly related to the `usermacro` API.
ca	# > Objecte de macros d'usuaris  Els següents objectes són relacionats amb l'API `usermacro`.

en-us	#### User macro support in preprocessing custom error-handling parameters  User macros are now supported in item value preprocessing custom error-handling parameters (*Set value to* and *Set error to* fields).  Although undocumented, this functionality worked before Zabbix 6.4.0, but it stopped working in previous 6.4.x versions. Now the support has been restored and documented.
ca	#### Suport de macro d'usuari al preprocessament de paràmetres personalitzats de gestió d'errors  Les macros d'usuari ara s'admeten als paràmetres personalitzats de gestió d'errors de preprocessament del valor de l'element (camps *Estableix el valor a* i *Estableix error a*).  Encara que no era documentada, aquesta funcionalitat funcionava abans de Zabbix 6.4.0, però va deixar de funcionar en versions anteriors 6.4.x. Ara el suport ha estat restaurat i documentat.

en-us	 # User macro  This class is designed to work with host-level and global user macros.  Object references:\  -   [Global macro](/manual/api/reference/usermacro/object#global_macro) -   [Host macro](/manual/api/reference/usermacro/object#host_macro)  Available methods:\  -   [usermacro.create](/manual/api/reference/usermacro/create) -     creating new host macros -   [usermacro.createglobal](/manual/api/reference/usermacro/createglobal) -     creating new global macros -   [usermacro.delete](/manual/api/reference/usermacro/delete) -     deleting host macros -   [usermacro.deleteglobal](/manual/api/reference/usermacro/deleteglobal) -     deleting global macros -   [usermacro.get](/manual/api/reference/usermacro/get) - retrieving     host and global macros -   [usermacro.update](/manual/api/reference/usermacro/update) -     updating host macros -   [usermacro.updateglobal](/manual/api/reference/usermacro/updateglobal) -     updating global macros
ca	# Macro d'usuari  Aquesta classe és dissenyada per treballar amb macros d'usuari de nivell d'equip i globals.  Referències d'objectes:\  -   [Macro global](/manual/api/reference/usermacro/object#global_macro) -   [Macro d'equip](/manual/api/reference/usermacro/object#host_macro)  Mètodes disponibles:\  -   [usermacro.create](/manual/api/reference/usermacro/create) - crear noves macros d'equip -   [usermacro.createglobal](/manual/api/reference/usermacro/createglobal) - crear noves macros globals -   [usermacro.delete](/manual/api/reference/usermacro/delete) - esborrar macros d'equips -   [usermacro.deleteglobal](/manual/api/reference/usermacro/deleteglobal) - esborrar macros globals -   [usermacro.get](/manual/api/reference/usermacro/get) - recuperar macros d'equip i globals -   [usermacro.update](/manual/api/reference/usermacro/update) - actualitzar macros d'equips -   [usermacro.updateglobal](/manual/api/reference/usermacro/updateglobal) - actualitzar macros globals

en-us	# usermacro.update
ca	# usermacro.update

en-us	# usermacro.updateglobal
ca	# usermacro.updateglobal

en-us	### User macro values  To use CyberArk Vault for storing *Vault secret* user macro values, make sure that:  -   Zabbix server is [configured](/manual/config/secrets/cyberark#server_and_proxies) to work with CyberArk Vault; -   the *Vault provider* parameter in [*Administration → General → Other*](/manual/web_interface/frontend_sections/administration/general#other-parameters) is set to "CyberArk Vault".  ![](../../../../assets/en/manual/config/provider_cyberark.png)  :::noteclassic Only Zabbix server requires access to *Vault secret* macro values from the vault. Other Zabbix components (proxy, frontend) do not need such access. :::  The macro value should contain a query (as `query:key`).  See [*Vault secret macros*](/manual/config/macros/secret_macros#vault_secret) for detailed information on macro value processing by Zabbix.
ca	### Valors de macro d'usuari  Per emprar CyberArk Vault per emmagatzemar els valors de macro d'usuari *Vault secret*:  - Establiu el paràmetre *Proveïdor de Vault* a la interfície web *Administració -> General -> Altres* [secció](/manual/web_interface/frontend_sections/administration/general#other-parameters) a CyberArk Vault.  ![](../../../../assets/en/manual/config/provider_cyberark.png)  - Assegureu-vos que el servidor Zabbix sigui [configurat](/manual/config/secrets/cyberark#server_and_proxies) per treballar amb CyberArk Vault.  El valor de la macro ha de contindre una consulta (com a "consulta:clau").  Consulteu [Macros secretes de Vault](/manual/config/macros/secret_macros#vault_secret) per obtindre informació detallada sobre el processament de valors de macro per part de Zabbix.

en-us	### User macro values  To use HashiCorp Vault for storing *Vault secret* user macro values, make sure that:  - Zabbix server is [configured](/manual/config/secrets/hashicorp#server_and_proxies) to work with HashiCorp Vault; - the *Vault provider* parameter in [*Administration → General → Other*](/manual/web_interface/frontend_sections/administration/general#other-parameters) is set to "HashiCorp Vault" (default).  ![](../../../../assets/en/manual/config/provider_hashicorp.png)  :::noteclassic Only Zabbix server requires access to *Vault secret* macro values from the vault. Other Zabbix components (proxy, frontend) do not need such access. :::  The macro value should contain a reference path (as `path:key`, for example, `secret/zabbix:password`). The authentication token specified during Zabbix server configuration (by the `VaultToken` parameter) must provide read-only access to this path.  See [*Vault secret macros*](/manual/config/macros/secret_macros#vault_secret) for detailed information on macro value processing by Zabbix.
ca	### Valors de macro d'usuari  Per emprar HashiCorp Vault per emmagatzemar els valors de macro d'usuari *Vault secret*, assegureu-vos que:  - El servidor Zabbix sigui [configurat](/manual/config/secrets/hashicorp#server_and_proxies) per treballar amb HashiCorp Vault; - Establiu el paràmetre *Proveïdor de Vault* a la interfície web [*Administració -> General -> Altres*](/manual/web_interface/frontend_sections/administration/general#other-parameters) a "Hashi CorpVault" (per defecte).  ![](../../../../assets/en/manual/config/provider_hashicorp.png)  :::noteclassic Només el servidor de Zabbix necessita accés als valors de macro de *Vault secret* per al vault. Altres components de Zabbix (proxy, interfície) no l'han de menester pas. :::  El valor de la macro ha de contindre una ruta de referència (com ara `path:key`, per exemple, `secret/zabbix:password`). El token d'autenticació especificat durant la configuració del servidor Zabbix (per el paràmetre `VaultToken`) ha de donar accés de només lectura a la ruta.  Consulteu [Macros secretes de Vault](/manual/config/macros/secret_macros#vault_secret) per obtindre informació detallada sobre el processament de valors de macro per part de Zabbix.

en-us	#### User media  Once the email media type is configured, go to the *Users → Users* section and edit user profile to assign email media to the user. Steps for setting up user media, being common for all media types, are described on the [Media types](/manual/config/notifications/media#user_media) page.
ca	#### Suport d'usuari  Un cop configurat el tipus de suport de correu-e, aneu a la secció *Usuaris → Usuaris* i modifiqueu el perfil de l'usuari per assignar un suport de correu-e a l'usuari. Les passes de configuració dels suports d'usuari, comuns a tots els tipus de suport, es descriuen a la pàgina [tipus de suport](/manual/config/notifications/media#user_media).

en-us	 #### User media  Once the media type is configured, go to the *Users → Users* section and assign the webhook media to an existing user or create a new user to represent the webhook. Steps for setting up user media for an existing user, being common for all media types, are described on the [Media types](/manual/config/notifications/media#user_media) page.  If a webhook uses tags to store ticket\\message ID, avoid assigning the same webhook as a media to different users as doing so may cause webhook errors (applies to the majority of webhooks that utilize *Include event menu entry* option). In this case, the best practice is to create a dedicated user to represent the webhook:  1.  After configuring the webhook media type, go to the *Users →     Users* section and create a dedicated Zabbix user to represent the     webhook - for example, with a username *Slack* for the Slack     webhook. All settings, except media, can be left at their defaults     as this user will not be logging into Zabbix. 2.  In the user profile, go to a tab *Media* and [add a     webhook](/manual/config/notifications/media#user_media) with the     required contact information. If the webhook does not use a *Send     to* field, enter any combination of supported characters to bypass     validation requirements. 3.  Grant this user at least read     [permissions](/manual/config/users_and_usergroups/permissions#permissions_to_host_groups)     to all hosts for which it should send the alerts.  When configuring alert action, add this user in the *Send to users* field in Operation details - this will tell Zabbix to use the webhook for notifications from this action.
ca	#### Suport d'usuari  Un cop configurat el tipus de suport, aneu a *Administració → Usuaris* i assigneu el suport del webhook a un usuari existent o creeu un usuari nou per representar el webhook. Les passes per configurar els suports d'usuari per a un usuari existent, comunes a tots els tipus de suports, es descriuen a la pàgina [Tipus de suport](/manual/config/notifications/media#user_media).  Si un webhook empra etiquetes per emmagatzemar l'ID del bitllet\\missatge, eviteu assignar el mateix webhook com a suports a diferents usuaris, ja que això pot provocar errors de webhook (s'aplica a la majoria de webhooks que empren l'opció *Inclou l'entrada del menú d'esdeveniments*). En aquest cas, la millor pràctica és crear un usuari dedicat per representar el webhook:  1. Després de configurar el tipus de suport del webhook, aneu a la secció *Administració → Usuaris* i creeu un usuari Zabbix dedicat per representar el webhook, per exemple, amb un nom d'usuari *Slack* per al webhook Slack. Totes les configuracions, excepte els suports, es poden deixar amb els seus valors predeterminats, ja que aquest usuari no iniciarà sessió a Zabbix. 2. Al perfil d'usuari, navegueu a la pestanya *Suports* i [afegiu webhook](/manual/config/notifications/media#user_media) amb la informació de contacte necessària. Si el webhook no empra un camp *Envia a*, introduïu qualsevol combinació de caràcters admesos per ometre els requisits de validació. 3. Concediu a aquest usuari almenys [permisos](/manual/config/users_and_usergroups/permissions#permissions_to_host_groups) per llegir tots els equips dels quals hauria d'enviar alertes.  Quan configureu l'acció d'alerta, afegiu aquest usuari al camp *Envia als usuaris* als detalls de l'operació; això indicarà a Zabbix que empri el webhook per a les notificacions d'aquesta acció.

en-us	### User media  Once the media type is configured, go to the *Users → Users* section and edit a user profile by assigning this media type to the user. Steps for setting up user media, being common for all media types, are described on the [Media types](/manual/config/notifications/media#user_media) page.  Note that when defining the user media, the *Send to* field cannot be empty. If this field is not used in the alert script, enter any combination of supported characters to bypass validation requirements.
ca	### Suport de l'usuari  Un cop configurat el tipus de suport, aneu a la secció *Usuaris → Usuaris* i modifiqueu el perfil de l'usuari assignant-li aquest tipus de suport. Les passes de configuració dels mitjans d'usuari, comuns a tots els tipus de suports, es descriuen a la pàgina [tipus de suport](/manual/config/notifications/media#user_media).  Tingueu en compte que en definir els mitjans d'usuari, un camp *Envia a* no pot pas ésser buit. Si aquest camp no s'empra en un script d'alerta, introduïu qualsevol combinació de caràcters admesos per ometre els requisits de validació.

en-us	#### User media  Once the SMS media type is configured, go to the *Users → Users* section and edit user profile to assign SMS media to the user. Steps for setting up user media, being common for all media types, are described on the [Media types](/manual/config/notifications/media#user_media) page.
ca	#### Suport d'usuari  Un cop configurat el tipus de suport d'SMS, aneu a la secció *Usuaris → Usuaris* i modifiqueu el perfil de l'usuari per assignar un suport d'SMS a l'usuari. Les passes de configuració dels suports d'usuari, comuns a tots els tipus de suport, es descriuen a la pàgina [tipus de suport](/manual/config/notifications/media#user_media).

en-us	#### User media  The *Media* tab contains a listing of all media defined for the user. Media are used for sending notifications.   ![](../../../../assets/en/manual/config/user_media.png){width="600"}  Click on *Add* to assign media to the user.  If the media type has been disabled:  -   A yellow info icon is displayed after the name. -   *Disabled* is displayed in the Status column.  See the [Media types](/manual/config/notifications/media#user_media) section for details on configuring user media.
ca	#### Suport d'usuari  La pestanya *Suports* conté una llista de tots els suports definits per l'usuari. Els suports s'empren per enviar notificacions.  ![](../../../../assets/en/manual/config/user_media.png){width="600"}  Feu clic a *Afegir* per assignar contingut multimèdia a l'usuari.  Si el tipus de suport s'ha desactivat:  - Es mostra una icona d'informació groga després del nom. - *Desactivat* es mostra a la columna d'stat.  Consulteu la secció [Tipus de suport](/manual/config/notifications/media#user_media) per obtindre més informació sobre com configurar els suports d'usuari.

en-us	#### User media  To receive notifications of a media type, a medium (email address/phone number/webhook user ID etc) for this media type must be defined in the user profile. For example, an action sending messages to user "Admin" using webhook "X" will always fail to send anything if the webhook "X" medium is not defined in the user profile.  To define user media:  -   Go to your user profile, or go to *Users → Users* and open     the user properties form -   In the Media tab, click on     ![](../../../../assets/en/manual/config/add_link.png)  ![](../../../../assets/en/manual/config/notifications/media/user_media2.png)  User media attributes:  |Parameter|Description| |--|--------| |*Type*|The drop-down list contains the names of enabled media types.<br>Note that when editing a medium of a disabled media type, the type will be displayed in red.| |*Send to*|Provide required contact information where to send messages.<br><br>For an email media type it is possible to add several addresses by clicking on ![](../../../../assets/en/manual/config/add_link.png) below the address field. In this case, the notification will be sent to all email addresses provided. It is also possible to specify recipient name in the *Send to* field of the email recipient in a format 'Recipient name <address1\@company.com>'. Note, that if a recipient name is provided, an email address should be wrapped in angle brackets (<>). UTF-8 characters in the name are supported, quoted pairs and comments are not. For example: *John Abercroft <manager\@nycdatacenter.com>* and *manager\@nycdatacenter.com* are both valid formats. Incorrect examples: *John Doe zabbix\@company.com*, *%%"Zabbix\\@\\<H(comment)Q\\>" <zabbix@company.com> %%*.| |*When active*|You can limit the time when messages are sent, for example, set the working days only (1-5,09:00-18:00). Note that this limit is based on the user [time zone](/manual/web_interface/time_zone). If the user time zone is changed and is different from the system time zone this limit may need to be adjusted accordingly so as not to miss important messages.<br>See the [Time period specification](/manual/appendix/time_period) page for description of the format.| |*Use if severity*|Mark the checkboxes of trigger severities that you want to receive notifications for.<br>*Note* that the default severity ('Not classified') **must be** checked if you want to receive notifications for non-trigger [events](/manual/config/events).<br>After saving, the selected trigger severities will be displayed in the corresponding severity colors, while unselected ones will be grayed out.| |*Status*|Status of the user media.<br>**Enabled** - is in use.<br>**Disabled** - is not being used.|
ca	#### Suport d'usuari  Per rebre notificacions d'un tipus de suport, cal definir un suport (adreça-e/nombre de telèfon/identificador d'usuari del webhook, etc.) per a aquest tipus de suport al perfil de l'usuari. Per exemple, una acció que enviï missatges a l'usuari "Administrador" mitjançant el webhook "X" sempre fallarà en enviar res si el suport per al webhook "X" no és definit al perfil de l'usuari.  Per definir els suports d'usuari:  - Aneu al vostre perfil d'usuari o aneu a *Administració → Usuaris* i obriu el formulari de propietats d'usuari - A la pestanya Multimèdia, feu clic a      ![](../../../../assets/en/manual/config/add_link.png)  ![](../../../../assets/en/manual/config/notifications/media/user_media2.png)  Atributs del suport d'usuari:  |Paràmetre|Descripció| |--|---------| |*Tipus*|La llista desplegable conté els noms de tots els tipus de suports configurats.| |*Enviar a*|Proporcioneu les dades de contacte necessàries on enviar els missatges.<br><br>Per a un tipus de suport de correu electrònic, és possible afegir diverses adreces fent clic a ![](../../../../assets/en/manual/config/add_link.png) sota el camp d'adreça. En aquest cas, la notificació s'enviarà a totes les adreces de correu-e facilitades. També és possible especificar el nom del destinatari al camp *Enviar a* del destinatari del correu electrònic en el format 'Nom del destinatari <adreça1\@empresa.com>'. Tingueu en compte que si es proporciona un nom de destinatari, s'ha d'adjuntar una adreça de correu electrònic entre claudàtors (<>). Els caràcters UTF-8 del nom són compatibles, els parells entre cometes i els comentaris no ho són pas. Per exemple: *John Abercroft <manager\@nycdatacenter.com>* i *manager\@nycdatacenter.com* són tots dos formats vàlids. Exemples incorrectes: *John Doe zabbix\@company.com*, *%%"Zabbix\\@\\<H(comment)Q\\>" <zabbix@company.com> %%*.| |*Quan ha d'ésser actiu*|Podeu limitar el temps que s'envien els missatges, per exemple, establiu només els dies laborables (1-5.09:00-18:00). Tingueu en compte que aquest límit es basa en la [zona horària](/manual/web_interface/time_zone) de l'usuari. Si la zona horària de l'usuari canvia i és diferent de la zona horària del sistema, és possible que s'hagi d'ajustar aquest límit per tal de no perdre missatges importants.<br>Consulteu [Especificació de període](/manual/appendix/time_period) per a la descripció del format.| |*Feu servir segons la gravetat*|Marqueu les caselles de les gravetats del trigger per a les quals voleu rebre notificacions.<br>*Tingueu en compte* que la gravetat predeterminada ("Sense classificar") **ha d'ésser** marcada si voleu rebre notificacions per a [esdeveniments](/manual/config/events) no desencadenants.<br>Després de desar, les gravetats triades del trigger es mostraran amb els colors de gravetat corresponents, mentre que les no triades es mostraran en gris.| |*Estat*|Estat dels mitjans de l'usuari.<br>**Activat** - és en ús.<br>**Desactivat** - no és pas en ús.|

en-us	# > User object  The following objects are directly related to the `user` API.
ca	# > Objecte usuari  Els següents objectes són relacionats amb l'API `user`.

en-us	##### UserParameter  A user-defined parameter to monitor. There can be several user-defined parameters.<br>Format: UserParameter=<key>,<shell command><br>Note that the shell command must not return empty string or EOL only. Shell commands may have relative paths, if the UserParameterDir parameter is specified.  Example:      UserParameter=system.test,who|wc -l     UserParameter=check_cpu,./custom_script.sh
ca	##### UserParameter  Un paràmetre definit per l'usuari per monitorar. Hi pot haver diversos paràmetres definits per l'usuari.<br>Format: UserParameter=<key>,<shell command><br>Tingueu en compte que l'ordre shell no ha de retornar només una cadena buida o EOL. Les ordres de Shell poden tindre camins relatius, si s'especifica el paràmetre UserParameterDir.  Exemple:      UserParameter=system.test,who|wc -l     UserParameter=check_cpu,./custom_script.sh

en-us	##### UserParameter  A user-defined parameter to monitor. There can be several user-defined parameters.<br>Format: UserParameter=<key>,<shell command><br>Note that the shell command must not return empty string or EOL only. Shell commands may have relative paths, if the UserParameterDir parameter is specified.  Example:      UserParameter=system.test,who|wc -l     UserParameter=check_cpu,./custom_script.sh
ca	##### UserParameter  Un paràmetre definit per l'usuari per monitorar. Hi pot haver diversos paràmetres definits per l'usuari.<br>Format: UserParameter=<key>,<shell command><br>Tingueu en compte que l'ordre shell no ha de retornar només una cadena buida o EOL. Les ordres de Shell poden tindre camins relatius, si s'especifica el paràmetre UserParameterDir.  Exemple:      UserParameter=system.test,who|wc -l     UserParameter=check_cpu,./custom_script.sh

en-us	##### UserParameter  A user-defined parameter to monitor. There can be several user-defined parameters.<br>Format: UserParameter=<key>,<shell command><br>Note that the shell command must not return empty string or EOL only. Shell commands may have relative paths, if the UserParameterDir parameter is specified.  Example:      UserParameter=system.test,who|wc -l     UserParameter=check_cpu,./custom_script.sh
ca	##### UserParameter  Un paràmetre definit per l'usuari per monitorar. Hi pot haver diversos paràmetres definits per l'usuari.<br>Format: UserParameter=<key>,<shell command><br>Tingueu en compte que l'ordre shell no ha de retornar només una cadena buida o EOL. Les ordres de Shell poden tindre camins relatius, si s'especifica el paràmetre UserParameterDir.  Exemple:      UserParameter=system.test,who|wc -l     UserParameter=check_cpu,./custom_script.sh

en-us	##### UserParameter  A user-defined parameter to monitor. There can be several user-defined parameters.<br>Format: UserParameter=<key>,<shell command><br>Note that the shell command must not return empty string or EOL only. Shell commands may have relative paths, if the UserParameterDir parameter is specified.  Example:      UserParameter=system.test,who|wc -l     UserParameter=check_cpu,./custom_script.sh
ca	##### UserParameter  Un paràmetre definit per l'usuari per monitorar. Hi pot haver diversos paràmetres definits per l'usuari.<br>Format: UserParameter=<key>,<shell command><br>Tingueu en compte que l'ordre shell no ha de retornar només una cadena buida o EOL. Les ordres de Shell poden tindre camins relatius, si s'especifica el paràmetre UserParameterDir.  Exemple:      UserParameter=system.test,who|wc -l     UserParameter=check_cpu,./custom_script.sh

en-us	##### UserParameterDir  The default search path for UserParameter commands. If used, the agent will change its working directory to the one specified here before executing a command. Thereby, UserParameter commands can have a relative `./` prefix instead of a full path.<br>Only one entry is allowed.  Example:      UserParameterDir=/opt/myscripts
ca	##### UserParameterDir  El camí de cerca predeterminat per a les ordres UserParameter. Si s'empra, l'agent canviarà el seu directori de treball a l'especificat aquí abans d'executar una ordre. Per tant, les ordres UserParameter poden tindre un prefix relatiu `./` en lloc d'un camí complet.<br>Només es permet una entrada.  Exemple:      UserParameterDir=/opt/myscripts

en-us	##### UserParameterDir  The default search path for UserParameter commands. If used, the agent will change its working directory to the one specified here before executing a command. Thereby, UserParameter commands can have a relative `./` prefix instead of a full path.<br>Only one entry is allowed.  Example:      UserParameterDir=/opt/myscripts
ca	##### UserParameterDir  El camí de cerca predeterminat per a les ordres UserParameter. Si s'empra, l'agent canviarà el seu directori de treball a l'especificat aquí abans d'executar una ordre. Per tant, les ordres UserParameter poden tindre un prefix relatiu `./` en lloc d'un camí complet.<br>Només es permet una entrada.  Exemple:      UserParameterDir=/opt/myscripts

en-us	##### UserParameterDir  The default search path for UserParameter commands. If used, the agent will change its working directory to the one specified here before executing a command. Thereby, UserParameter commands can have a relative `./` prefix instead of a full path.<br>Only one entry is allowed.  Example:      UserParameterDir=/opt/myscripts
ca	##### UserParameterDir  El camí de cerca predeterminat per a les ordres UserParameter. Si s'empra, l'agent canviarà el seu directori de treball a l'especificat aquí abans d'executar una ordre. Per tant, les ordres UserParameter poden tindre un prefix relatiu `./` en lloc d'un camí complet.<br>Només es permet una entrada.  Exemple:      UserParameterDir=/opt/myscripts

en-us	##### UserParameterDir  The default search path for UserParameter commands. If used, the agent will change its working directory to the one specified here before executing a command. Thereby, UserParameter commands can have a relative `./` prefix instead of a full path. Only one entry is allowed.  Example:      UserParameterDir=/opt/myscripts
ca	##### UserParameterDir  El camí de cerca predeterminat per a les ordres UserParameter. Si s'empra, l'agent canviarà el seu directori de treball a l'especificat aquí abans d'executar una ordre. Per tant, les ordres UserParameter poden tindre un prefix relatiu `./` en lloc d'un camí complet. Només es permet una entrada.  Exemple:      UserParameterDir=/opt/myscripts

en-us	##### User parameters  A [user parameter](/manual/config/items/userparameters) is a user-defined command (associated with a user-defined key) that, when executed, can retrieve the data you need from the host where Zabbix agent is running. User parameters are useful for configuring agent or agent 2 items that are not predefined in Zabbix.
ca	##### Paràmetres d'usuari  Un [paràmetre d'usuari](/manual/config/items/userparameters) és una ordre definida per l'usuari (associada amb una clau definida per l'usuari) que, quan s'executa, pot recuperar les dades que necessiteu de l'equip on s'executa l'agent Zabbix. Els paràmetres d'usuari són útils per configurar elements d'agent o agent 2 que no són predefinits a Zabbix.

en-us	#### User permission check  Does the user have permission to write to hosts whose names begin with "MySQL" or "Linux" ?  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.get",     "params": {         "countOutput": true,         "search": {             "host": ["MySQL", "Linux"]         },         "editable": true,         "startSearch": true,         "searchByAny": true     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": "0",     "id": 1 } ```  ::: noteclassic Zero result means no hosts with read/write permissions. :::
ca	#### Verificació dels permisos d'usuari  Té permisos l'usuari per escriure als equips amb noms que comencen amb "MySQL" o "Linux"?  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.get",     "params": {         "countOutput": true,         "search": {             "host": ["MySQL", "Linux"]         },         "editable": true,         "startSearch": true,         "searchByAny": true     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": "0",     "id": 1 } ```  ::: noteclassic El resultat zero vol dir que no hi ha equips amb permisos de lectura/escriptura. :::

en-us	#### User profile  The **User profile** section provides options to set custom interface language, color theme, number of rows displayed in the lists, etc. The changes made here will be applied to the current user only.  The **User** tab allows you to set various user preferences.  ![profile.png](../../../assets/en/manual/web_interface/profile.png)  |Parameter|Description| |--|--------| |*Password*|Click on the *Change password* button to open three fields: *Old password*, *New password*, *New password (once again)*.<br>On a successful password change, the user will be logged out of all active sessions.<br>Note that the password can only be changed for users using Zabbix [internal authentication](/manual/web_interface/frontend_sections/users/authentication#default-authentication).| |*Language*|Select the interface language of your choice or select **System default** to use default system settings.<br>For more information, see [Installation of additional frontend languages](/manual/appendix/install/locales).| |*Time zone*|Select the time zone to override global [time zone](/manual/web_interface/time_zone#overview) on user level or select **System default** to use global time zone settings.| |*Theme*|Select a color theme specifically for your profile:<br>**System default** - use default system settings<br>**Blue** - standard blue theme<br>**Dark** - alternative dark theme<br>**High-contrast light** - light theme with high contrast<br>**High-contrast dark** - dark theme with high contrast| |*Auto-login*|Mark this checkbox to make Zabbix remember you and log you in automatically for 30 days. Browser cookies are used for this.| |*Auto-logout*|With this checkbox marked you will be logged out automatically, after the set amount of seconds (minimum 90 seconds, maximum 1 day).<br>[Time suffixes](/manual/appendix/suffixes) are supported, for example: 90s, 5m, 2h, 1d.<br>Note that this option will not work:<br>\* When Monitoring menu pages perform background information refreshes. In case pages refreshing data in a specific time interval (dashboards, graphs, latest data, etc.) are left open session lifetime is extended, respectively disabling auto-logout feature.<br>\* If logging in with the *Remember me for 30 days* option checked.<br>*Auto-logout* can also accept "0", meaning that auto-logout feature becomes disabled after profile settings update.| |*Refresh*|Set how often the information on the [*Monitoring*](/manual/web_interface/frontend_sections/monitoring) menu pages will be refreshed (minimum 0 seconds, maximum 1 hour).<br>[Time suffixes](/manual/appendix/suffixes) are supported, for example: 30s, 90s, 1m, 1h.| |*Rows per page*|You can set how many rows will be displayed per page in the lists. Fewer rows (and fewer records to display) mean faster loading times.| |*URL (after login)*|You can set a specific URL to be displayed after the login. Instead of the default *Dashboards* it can be, for example, the URL of *Monitoring* → *Triggers*.|  The **Media** tab allows you to specify the [media details](/manual/config/notifications/media#user_media) for the user, such as media types and addresses to use and when to use them to deliver notifications.  ![profile\_b.png](../../../assets/en/manual/web_interface/profile_b.png)  If the media type has been disabled:  -   A yellow info icon is displayed after the name. -   *Disabled* is displayed in the Status column.  ::: noteclassic Only [admin level](/manual/config/users_and_usergroups/permissions) users (*Admin* and *Super admin*) can change their own media details. :::  The **Messaging** tab allows you to set [global notifications](/manual/web_interface/user_profile/global_notifications).
ca	#### Perfil d'usuari  La secció **Perfil d'usuari** ofereix opcions per definir l'idioma de la interfície personalitzat, el tema del color, el nombre de files que es mostren a les llistes, etc. Els canvis fets aquí només s'aplicaran a l'usuari actual.  La pestanya **Usuari** us permet establir diverses preferències d'usuari.  ![profile.png](../../../assets/en/manual/web_interface/profile.png)  |Paràmetre|Descripció| |--|---------| |*Mot de pas*|Feu clic al botó *Canviar el mot de pas* per obrir tres camps: *Mot de pas antic*, *Mot de pas nou*, *Mot de pas nou (un cop més)*.<br>Si canvieu el mot de pas correctament, es tancaran totes les sessions actives de l'usuari.<br>Tingueu en compte que el mot de pas només es pot canviar per als usuaris que empren Zabbix [autenticació interna](/manual/web_interface/frontend_sections/users/authentication#default-authentication).| |*Idioma*|Trieu l'idioma de la interfície que trieu o trieu **Predeterminat del sistema** per emprar la configuració predeterminada del sistema.<br>Per obtindre més informació, consulteu [Instal·lació d'idiomes d'interfície addicionals](/manual/appendix/install/locales).| |*Zona horària*|Trieu la zona horària per substituir la [zona horària] global (/manual/web_interface/time_zone#overview) a nivell d'usuari o trieu **Sistema predeterminat** per emprar la configuració global de la zona horària.| |*Tema*|Trieu un tema de color específic per al vostre perfil:<br>**Per defecte del sistema** - empreu la configuració predeterminada del sistema<br>**Blau** - tema blau estàndard<br>**Fosc** - tema fosc alternatiu<br>**Llum d'alt contrast** - tema clar amb alt contrast<br>**Foscor d'alt contrast** - tema fosc amb alt contrast| |*Inici de sessió automàtica*|Marqueu aquesta casella de selecció perquè Zabbix us recordi i us iniciï sessió automàticament durant 30 dies. Per a això s'empren galetes del navegador.| |*Desconnexió automàtica*|Amb aquesta casella de selecció marcada, es tancarà la sessió automàticament després de la quantitat de segons establerta (mínim 90 segons, màxim 1 dia).<br>[Sufixos de temps](/manual/appendix/sufixos) són admesos, per exemple: 90s, 5m, 2h, 1d.<br>Tingueu en compte que aquesta opció no funcionarà:<br>\* Quan les pàgines del menú de monitoratge facin actualitzacions d'informació de fons. En cas que les pàgines que actualitzin dades en un interval de temps específic (taulers de control, gràfics, dades més recents, etc.) es deixin obertes, s'allarga la vida útil de la sessió, desactivant respectivament la funció de tancament automàtic.<br>\* Si inicieu sessió amb el *Recordeu-me per L'opció de 30 dies* està marcada.<br>*La tanda de sessió automàtica* també pot acceptar "0", el que significa que la funció de tancament de sessió automàtica es desactiva després de l'actualització de la configuració del perfil.| |*Actualització*|Podeu definir la freqüència amb què s'actualitzarà la informació de les pàgines al menú Monitoratge.<br>S'admeten [sufixos de temps](/manual/appendix/sufixos), per exemple: 30 s, 5 m, 2 h, 1d.| |*Fileres per pàgina*|Podeu definir quantes fileres es mostraran per pàgina a les llistes. Menys fileres (i menys registres per mostrar) signifiquen temps de càrrega més ràpids.| |*URL (després de l'inici de sessió)*|Podeu definir una URL específica que es mostrarà després de l'inici de sessió. En lloc dels *Taulers* per defecte, pot ser, per exemple, l'URL de *Monitoratge* → *Triggers*.|  La pestanya **Suports** us permet especificar els [detalls dels suports](/manual/config/notifications/media#user_media) per a l'usuari, com ara els tipus de suport i les adreces que cal emprar i quan emprar-los per enviar notificacions.  ![perfil\_b.png](../../../assets/en/manual/web_interface/profile_b.png)  Si el tipus de suport s'ha desactivat:  - Es mostra una icona d'informació groga després del nom. - *Desactivat* es mostra a la columna Estat.  ::: noteclassic Només els usuaris de [nivell d'administració](/manual/config/users_and_usergroups/permissions) (*Admin* i *Super admin*) poden canviar els seus propis detalls multimèdia. :::  La pestanya **Missatgeria** us permet configurar [notificacions globals](/manual/web_interface/user_profile/global_notifications).

en-us	# user.provision
ca	# user.provision

en-us	 #### User provisioning  It is possible to configure JIT (just-in-time) **user provisioning** for LDAP users. In this case,  it is not required that a user already exists in Zabbix. The user account can be created when  the user logs into Zabbix for the first time.  When an LDAP user enters their LDAP login and password, Zabbix checks the *default* LDAP server if this user exists. If the user exists and does not have an account in Zabbix yet, a new user is created in Zabbix and the user is able to log in.  :::noteimportant If JIT provisioning is enabled, a user group for deprovisioned users must be specified in the *Authentication* tab. :::  JIT provisioning also allows to update provisioned user accounts based on changes in LDAP. For example, if a user is moved from one LDAP group to another, the user will also be moved from one group to another in Zabbix; if a user is removed from an LDAP group, the user will also be removed from the group in Zabbix and, if not belonging to any other group, added to the user group for deprovisioned users. Note that provisioned user accounts are updated based on the configured [provisioning period](#configuration) or when the user logs into Zabbix.  LDAP JIT provisioning is available only when LDAP is configured to use "anonymous" or "special user" for binding. For direct user binding, provisioning will be made only for user login action, because logging in user password is used for such type of binding.
ca	 #### Aprovisionament d'usuaris  És possible configurar l'**aprovisionament d'usuaris** JIT (just a temps) per als usuaris LDAP. En aquest cas, no és necessari que existeixi un usuari a Zabbix. El compte d'usuari es pot crear quan l'usuari inicia sessió a Zabbix per primer cop.  Quan un usuari LDAP introdueix el seu inici de sessió i la seva contrasenya LDAP, Zabbix comprova al servidor LDAP *predeterminat* si aquest usuari existeix. Si l'usuari existeix i encara no té un compte a Zabbix, es crea un usuari nou a Zabbix i l'usuari podrà iniciar la sessió.  :::noteimportant Si l'aprovisionament JIT és habilitat, s'ha d'especificar un grup d'usuaris per als usuaris desaprovisionats a la pestanya *Autenticació*. :::  El subministrament JIT també permet actualitzar els comptes d'usuari subministrats en funció dels canvis a LDAP. Per exemple, si un usuari es mou d'un grup LDAP a un altre, l'usuari també es mourà d'un grup a un altre a Zabbix; si s'esborra un usuari d'un grup LDAP, l'usuari també s'esborrarà del grup a Zabbix i, si no pertany a cap altre grup, s'afegirà al grup d'usuaris per als usuaris desaprovisionats. Tingueu en compte que els comptes d'usuari subministrats s'actualitzen en funció del [període d'aprovisionament](#configuration) configurat o quan l'usuari inicia sessió a Zabbix.  El subministrament LDAP JIT només és disponible quan LDAP és configurat per emprar "anònim" o "usuari especial" per a l'enllaç. Per a l'enllaç directe d'usuari, el subministrament es farà només per a l'acció d'inici de sessió de l'usuari, perquè el mot de pas d'inici de sessió s'empra per a aquest tipus d'enllaç.

en-us	 #### User provisioning  It is possible to configure JIT (just-in-time) **user provisioning** for SAML users. In this case,  it is not required that a user already exists in Zabbix. The user account can be created when  the user logs into Zabbix for the first time.  :::noteimportant If JIT provisioning is enabled, a user group for deprovisioned users must be specified in the *Authentication* tab. :::  On top of JIT provisioning it is also possible to enable and configure SCIM (System for Cross-domain Identity Management) provisioning - *continuous* user account management for those users that have been created by user provisioning. SCIM provisioning requires a Zabbix [API token](/manual/web_interface/frontend_sections/users/api_tokens) (with Super admin permissions) for authentication into Zabbix.  For example, if a user is moved from one SAML group to another, the user will also be moved from one group to another in Zabbix; if a user is removed from a SAML group, the user will also be removed from the group in Zabbix and, if not belonging to any other group, added to the user group for deprovisioned users.  If SCIM is enabled and configured, a SAML user will be provisioned at the moment the user logs into Zabbix and continuously updated based on changes in SAML. Already existing SAML users will not be provisioned, and only provisioned users will be updated. Note that only valid media will be added to a user when the user is provisioned or updated.  If SCIM is not enabled, a SAML user will be provisioned (and later updated) at the moment the user logs into Zabbix.  ::: noteclassic  If SAML authentication is enabled, users will be able to choose between logging in locally or via SAML single sign-on. If  JIT provisioning is used, then only single sign-on is possible. :::
ca	 #### Aprovisionament d'usuaris  És possible configurar l'**aprovisionament d'usuaris** JIT (just a temps) per als usuaris de SAML. En aquest cas, no és necessari que ja existeixi un usuari a Zabbix. El compte d'usuari es pot crear quan l'usuari inicia sessió a Zabbix per primer cop.  :::noteimportant Si l'aprovisionament JIT és habilitat, s'ha d'especificar un grup d'usuaris per als usuaris desaprovisionats a la pestanya *Autenticació*. :::  A més de l'aprovisionament JIT, també és possible habilitar i configurar l'aprovisionament SCIM (Sistema per a la gestió d'identitats entre dominis) - gestió de comptes d'usuari *continuar* per a aquells usuaris que s'han creat mitjançant l'aprovisionament d'usuaris. El subministrament SCIM requereix un [token API](/manual/web_interface/frontend_sections/users/api_tokens) de Zabbix (amb permisos de superadministrador) per autenticar-se a Zabbix.  Per exemple, si un usuari es mou d'un grup SAML a un altre, l'usuari també es mourà d'un grup a un altre a Zabbix; si s'esborra un usuari d'un grup SAML, l'usuari també s'esborrarà del grup a Zabbix i, si no pertany a cap altre grup, s'afegirà al grup d'usuaris per als usuaris desprovisionats.  Si SCIM és habilitat i configurat, s'aprovisionarà un usuari SAML en el moment que l'usuari iniciï sessió a Zabbix i s'actualitzarà contínuament en funció dels canvis a SAML. Els usuaris SAML existents no s'aprovisionaran i només s'actualitzaran els usuaris donats. Tingueu en compte que només s'afegiran suports vàlids a un usuari quan l'usuari s'aprovisioni o s'actualitzi.  Si SCIM no és habilitat, s'aprovisionarà un usuari SAML (i s'actualitzarà posteriorment) en el moment que l'usuari iniciï sessió a Zabbix.  ::: noteclassic   Si l'autenticació SAML és activada, els usuaris podran triar entre iniciar sessió localment o mitjançant l'inici de sessió únic SAML. Si s'empra el subministrament JIT, només és possible l'inici de sessió únic. :::

en-us	 #### User roles  User roles allow to make custom adjustments to the permissions defined by the user type.  While no permissions can be added (that would exceed those of the user type), some permissions can be revoked.  Furthermore, a user role determines access not only to menu sections, but also to services, modules, API methods and  various actions in the frontend.  [User roles](/manual/web_interface/frontend_sections/users/user_roles) are configured in the *Users → User roles* section by Super admin  users.  User roles are assigned to users in the user configuration form, *Permissions* tab, by Super admin users.  ![user\_permissions.png](../../../../assets/en/manual/config/user_permissions.png)
ca	#### Rol d'usuari  Els rols d'usuari permeten fer ajustaments personalitzats als permisos definits pel tipus d'usuari. Tot i que no es poden afegir permisos (que superarien els del tipus d'usuari), alguns permisos es poden revocar.  A més, un rol d'usuari determina l'accés no només a les seccions del menú, sinó també als serveis, mòduls, mètodes API i diverses accions al frontend.  Els [rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles) es configuren a la secció *Usuaris → Rols d'usuari* per usuaris Super Admin.  Els usuaris superadministradors assignen els rols d'usuari al formulari de configuració d'usuari, pestanya *Permisos*.  ![user\_permissions.png](../../../../assets/en/manual/config/user_permissions.png)

en-us	#### Users  A listing of existing users with their details is displayed.  ![](../../../../../assets/en/manual/web_interface/users.png){width="600"}  Displayed data:  |Column|Description| |--|--------| |*Username*|Username for logging into Zabbix. Clicking on the username opens the user [configuration form](/manual/config/users_and_usergroups/user).| |*Name*|First name of the user.| |*Last name*|Second name of the user.| |*User role*|[User role](/manual/web_interface/frontend_sections/users/user_roles) is displayed.| |*Groups*|Groups that the user is a member of are listed. Clicking on the user group name opens the user group configuration form. Disabled groups are displayed in red.| |*Is online?*|The on-line status of the user is displayed - *Yes* or *No*. The time of last user activity is displayed in parentheses.| |*Login*|The login status of the user is displayed - *Ok* or *Blocked*. A user can become temporarily blocked upon exceeding the number of unsuccessful login attempts set in the *[Administration → General → Other](/manual/web_interface/frontend_sections/administration/general#other_parameters)* section (five by default). By clicking on *Blocked* you can unblock the user.| |*Frontend access*|Frontend access level is displayed - *System default*, *Internal*, *LDAP*, or *Disabled*, depending on the one set for the whole user group.| |*API access*|API access status is displayed - *Enabled* or *Disabled*, depending on the one set for the user role.| |*Debug mode*|Debug mode status is displayed - *Enabled* or *Disabled*, depending on the one set for the whole user group.| |*Status*|User status is displayed - *Enabled* or *Disabled*, depending on the one set for the whole user group.| |*Provisioned*|The date when the user was last provisioned is displayed.<br>Used for users created by JIT provisioning from LDAP/SAML.| |*Info*|Information about errors is displayed.<br>A yellow warning is displayed for users without user groups.<br>A red warning is displayed for users without roles, and for users without roles and user groups.|  To configure a new user, click on the *Create user* button in the top right-hand corner.
ca	#### Usuaris  Es mostra una llista dels usuaris existents amb les seves dades.  ![](../../../../../assets/en/manual/web_interface/users.png){width="600"}  Dades mostrades:  |Columna|Descripció| |--|---------| |*Nom d'usuari*|Nom d'usuari per iniciar sessió a Zabbix. En fer clic al nom d'usuari s'obre el [formulari de configuració](/manual/config/users_and_usergroups/user) de l'usuari.| |*Nom*|Nom de l'usuari.| |*Cognom*|Cognom de l'usuari.| |*Rol d'usuari*|[Rol d'usuari](/manual/web_interface/frontend_sections/users/user_roles).| |*Grups*|Llistat de grups dels quals l'usuari n'és membre. Si feu clic al nom del grup d'usuaris, s'obre el formulari de configuració del grup d'usuaris. Els grups desactivats es veuen en vermell.| |*És en línia?*|Es veu l'estat en línia de l'usuari - *Sí* o *No*. L'hora de la darrera activitat de l'usuari es mostra entre parèntesis.| |*Inici de sessió*|Estat d'inici de sessió de l'usuari - *Correcte* o *Bloquejat*. Un usuari es pot bloquejar temporalment en superar el nombre d'intents d'inici de sessió infructuosos establert a la secció *[Administració → General → Altres](/manual/web_interface/frontend_sections/administration/general#other_parameters)* (cinc per defecte). Fent clic a *Blocat* pots desblocar l'usuari.| |*Accés a la interfície*|Es mostra el nivell d'accés a la interfície - *Predeterminat del sistema*, *Intern*, *LDAP* o *Desactivat*, depenent del definit per a tot el grup d'usuaris.| |*Accés a l'API*|Es mostra l'estat d'accés a l'API - *Activat* o *Desactivat*, depenent de l'establert per a la funció d'usuari.| |*Mode de depuració*|Es mostra l'estat del mode de depuració - *Activat* o *Desactivat*, depenent del definit per a tot el grup d'usuaris.| |*Estat*|Es mostra l'estat de l'usuari - *Activat* o *Desactivat*, depenent del definit per a tot el grup d'usuaris.| |*Aprovisionat*|Es mostra la data en què es va subministrar l'usuari per darrera vegada.<br>S'empra per als usuaris creats per l'aprovisionament JIT des de LDAP/SAML.| |*Informació*|Es mostra informació sobre errors.<br>Es mostra un avís groc per als usuaris sense grups d'usuaris.<br>Es mostra un avís vermell per als usuaris sense rols i per als usuaris sense rols i grups d'usuaris.|  Per configurar un usuari nou, feu clic al botó *Crear usuari* a l'extrem superior dret.

en-us	#### Users and user groups  Add users that will have access to Zabbix, assign them to user groups and grant permissions. Make roles for granular management of user rights.  [User API](/manual/api/reference/user) | [User group API](/manual/api/reference/usergroup) | [User directory API](/manual/api/reference/userdirectory) | [User role API](/manual/api/reference/role)
ca	#### Usuaris  Afegir usuaris que tindran accés a Zabbix, assignar-los a grups d'usuaris o donar permisos. Fer rols per gestió granular dels drets d'usuaris. Veure els canvis de configuració fets per cada usuari. Configurar els tipus de suport i diverses maneres en que els usuaris rebran les alertes.  [API Usuari](/manual/api/reference/user) | [API Grup d'usuaris](/manual/api/reference/usergroup) | [API Rols dels usuaris](/manual/api/reference/role) | [API Tipus de suport](/manual/api/reference/mediatype) | [API Registre d'auditoria](/manual/api/reference/auditlog)

en-us	 ### Users  |Macro|Supported in|Description| |--|--------|--------| |{USER.FULLNAME}|→ Problem update notifications and commands<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)|*Name, surname and username of the user* who added event acknowledgment or started the script.<br>Supported for problem updates since 3.4.0, for global scripts since 5.0.2| |{USER.NAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)|*Name of the user* who started the script.<br>Supported since 5.0.2.| |{USER.SURNAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)|*Surname of the user* who started the script.<br>Supported since 5.0.2.| |{USER.USERNAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)|*Username of the user* who started the script.<br>Supported since 5.0.2.<br>{USER.ALIAS}, supported before Zabbix 5.4.0, is now deprecated.|
ca	### Usuaris  |Macro|Admesa a|Descripció| |--|------|------| |{USER.FULLNAME}|→ Notificacions i ordres d'actualització de problemes<br>→ Acció manual de l'equip [scripts](/manual/web_interface/frontend_sections/administration/scripts) (inclòs el text de confirmació)<br>→ Acció manual de l'esdeveniment [scripts] (/manual/web_interface/frontend_sections/administration/scripts) (inclòs el text de confirmació)|*Nom, cognoms i nom d'usuari de l'usuari* que va afegir el reconeixement d'esdeveniments o va iniciar l'script.<br>S'admet per a actualitzacions de problemes des de la 3.4.0, per a scripts globals des de la 5.0.2| |{USER.NAME}|→ Acció manual de l'equip [scripts](/manual/web_interface/frontend_sections/administration/scripts) (inclòs el text de confirmació)<br>→ Acció d'esdeveniment manual [scripts](/manual/web_interface/frontend_sections/administration/scripts) (inclòs el text de confirmació)|*Nom de l'usuari* que va iniciar l'script.<br>Admès des de la 5.0.2.| |{USER.SURNAME}|→ Acció manual de l'equip [scripts](/manual/web_interface/frontend_sections/administration/scripts) (inclòs el text de confirmació)<br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration /scripts) (inclòs el text de confirmació)|*Cognom de l'usuari* que va iniciar l'script.<br>Admès des de 5.0.2.| |{USER.USERNAME}|→ Acció manual de l'equip [scripts](/manual/web_interface/frontend_sections/administration/scripts) (inclòs el text de confirmació)<br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration /scripts) (inclòs el text de confirmació)|*Nom d'usuari de l'usuari* que va iniciar l'script.<br>Admès des de 5.0.2.<br>{USER.ALIAS}, compatible abans de Zabbix 5.4.0, ara és obsolet.|

en-us	#### Users of Zabbix  Many organizations of different size around the world rely on Zabbix as a primary monitoring platform.
ca	#### Usuaris de Zabbix  Empreses de diferent mida de tot el món empren Zabbix com a principal plataforma de monitoratge.

en-us	### Users  The users object has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |userid|string|ID of user to send the report to.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |access\_userid|string|ID of user on whose behalf the report will be generated.<br><br>0 - *(default)* Generate report by recipient.| |exclude|integer|Whether to exclude the user from mailing list.<br><br>Possible values:<br>0 - *(default)* Include;<br>1 - Exclude.|
ca	### Usuaris  L'objecte té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |userid|cadena|ID de l'usuari a qui enviar l'informe.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |access\_userid|cadena|ID de l'usuari en nom del qual es generarà l'informe.<br><br>0 - *(per defecte)* Genereu un informe per destinatari.| |exclude|enter|Indica si s'ha d'excloure l'usuari de la llista de correu.<br><br>Valors possibles:<br>0 - *(per defecte)* Incloure;<br>1 - Excloure.|

en-us	## Users  The Zabbix API allows you to manage users of your monitoring system.
ca	## Usuaris  L'API de Zabbix us permet gestionar els usuaris del vostre sistema de monitoratge.

en-us	### User  The user object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |userid|string|ID of the user.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |username|string|User's name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for [provisioned users](/manual/web_interface/frontend_sections/users/authentication#default-authentication) if the user is linked to a [user directory](/manual/api/reference/userdirectory/object) (`userdirectoryid` is set to a valid value that is not "0"), and user directory provisioning status is enabled (`provision_status` of [User directory object](/manual/api/reference/userdirectory/object#userdirectory) is set to "1"), and authentication status of all LDAP or SAML provisioning is enabled (`ldap_jit_status` of [Authentication object](/manual/api/reference/authentication/object#authentication) is set to "Enabled for configured LDAP IdPs" or `saml_jit_status` of [Authentication object](/manual/api/reference/authentication/object#authentication) is set to "Enabled for configured SAML IdPs")| |passwd|string|User's password.<br><br>The value of this parameter can be an empty string if the user is linked to a [user directory](/manual/api/reference/userdirectory/object).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*| |roleid|string|Role ID of the user.<br><br>Note that users without a role can log into Zabbix only using [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap) or [SAML](/manual/web_interface/frontend_sections/users/authentication/saml) authentication, provided their LDAP/SAML information matches the user group mappings configured in Zabbix.| |attempt\_clock|timestamp|Time of the last unsuccessful login attempt.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |attempt\_failed|integer|Recent failed login attempt count.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |attempt\_ip|string|IP address from where the last unsuccessful login attempt came from.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |autologin|integer|Whether to enable auto-login.<br><br>Possible values:<br>0 - *(default)* auto-login disabled;<br>1 - auto-login enabled.| |autologout|string|User session life time. Accepts seconds and time unit with suffix. If set to 0s, the session will never expire.<br><br>Default: 15m.| |lang|string|Language code of the user's language, for example, `en_GB`.<br><br>Default: `default` - system default.| |name|string|Name of the user.| |refresh|string|Automatic refresh period. Accepts seconds or time unit with suffix (e.g., 30s, 90s, 1m, 1h).<br><br>Default: 30s.| |rows\_per\_page|integer|Amount of object rows to show per page.<br><br>Default: 50.| |surname|string|Surname of the user.| |theme|string|User's theme.<br><br>Possible values:<br>`default` - *(default)* system default;<br>`blue-theme` - Blue;<br>`dark-theme` - Dark.| |ts_provisioned|timestamp|Time when the latest [provisioning](/manual/api/reference/user/provision) operation was made.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |url|string|URL of the page to redirect the user to after logging in.| |userdirectoryid|string|ID of the [user directory](/manual/api/reference/userdirectory/object) that the user in linked to.<br><br>Used for provisioning (creating or updating), as well as to login a user that is linked to a user directory.<br><br>For login operations the value of this property will have priority over the `userdirectoryid` property of [user groups](/manual/api/reference/usergroup/object#user-group) that the user belongs to.<br><br>Default: 0.| |timezone|string|User's time zone, for example, `Europe/London`, `UTC`.<br><br>Default: `default` - system default.<br><br>For the full list of supported time zones please refer to [PHP documentation](https://www.php.net/manual/en/timezones.php).|
ca	### Usuari  L'objecte usuari té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |userid|cadena|ID de l'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |username|cadena|Nom de l'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per a operacions de creació<br>- *només lectura* per a [usuaris subministrats](/manual/web_interface/frontend_sections/users/authentication#default-authentication) si l'usuari és vinculat a un [directori d'usuari](/manual/api/reference/userdirectory/object) ('userdirectoryid' és establert a un valor vàlid que no sigui "0"), i l'estat de subministrament del directori d'usuari és habilitat ('provision_status' de l'[objecte de directori d'usuari](/manual/api/reference/userdirectory/object#userdirectory) s'estableix a "1"), i l'estat d'autenticació de tot l'aprovisionament LDAP o SAML és habilitat (`ldap_jit_status` de [Authentication object](/manual/api/reference/authentication/object#authentication) s'estableix a "Actiu per LDAP IdPs configurades" o `saml_jit_status` d'[objecte d'autenticació](/manual/api/reference/authentication/object#authentication) s'ha establert a "Activat per a identificadors SAML configurats")| |passwd|cadena|Mot de pas de l'usuari.<br><br>El valor d'aquest paràmetre pot ser una cadena buida si l'usuari és vinculat a un [directori d'usuari](/manual/api/reference/userdirectory/object).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només escriptura*| |roleid|cadena|ID de rol de l'usuari.<br><br>Fixeu-vos que els usuaris sense cap rol poden entrar a Zabbix només emprant autenticació [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap) o [SAML](/manual/web_interface/frontend_sections/users/authentication/saml), indicant que la informació d'LDAP/SAML coincideixi amb els mapatges de grup d'usuari configurats a Zabbix.| |attempt\_clock|timestamp|Hora del darrer intent d'inici de sessió sense èxit.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |attempt\_failed|enter|Recompte d'intents d'inici de sessió fallits recents.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |attempt\_ip|cadena|Adreça IP d'on prové el darrer intent d'inici de sessió infructuós.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura *| |autologin|enter|Si s'ha d'activar l'inici de sessió automàtic.<br><br>Valors possibles:<br>0 - *(per defecte)* inici de sessió automàtic desactivat;<br>1 - inici de sessió automàtic activat.| |autologout|cadena|Vida útil de la sessió d'usuari. Admet segons i unitat de temps amb sufix. Si s'estableix en 0, la sessió no caducarà mai.<br><br>Per defecte: 15 m.| |lang|cadena|Codi d'idioma de l'idioma de l'usuari, per exemple, `ca_GB`.<br><br>Per defecte: `default` - predeterminat del sistema.| |name|cadena|Nom de l'usuari.| |refresh|cadena|Període d'actualització automàtica. Admet segons i unitat de temps amb sufix.<br><br>Per defecte: 30s.| |files\_per\_page|enter|Quantitat de files d'objectes per mostrar per pàgina.<br><br>Per defecte: 50.| |surname|cadena|Cognom de l'usuari.| |theme|cadena|Tema de l'usuari.<br><br>Valors possibles:<br>`default` - *(default)* per defecte;<br>`blue-theme` - Blau;<br>`dark-theme` ` - Fosc.| |ts_provisioned|timestamp|Hora en què s'ha fet la darrera operació de [provisionament](/manual/api/reference/user/provision).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior) :<br>- *només lectura*| |url|cadena|URL de la pàgina per redirigir l'usuari després d'iniciar sessió.| |userdirectoryid|cadena|ID del [directori d'usuari](/manual/api/reference/userdirectory/object) al qual l'usuari és enllaçat.<br><br>S'empra per al subministrament (creació o actualització), així com per iniciar la sessió a un usuari que sigui vinculat a un directori d'usuaris.<br><br>Per a les operacions d'inici de sessió, el valor d'aquesta propietat tindrà prioritat sobre la propietat `userdirectoryid` de [grups d'usuaris](/manual/api/reference/usergroup/object #user-group) al qual pertany l'usuari.<br><br>Per defecte: 0.| |timezone|cadena|La zona horària de l'usuari, per exemple, `Europe/London`, `UTC`.<br><br>Per defecte: `default` - per defecte del sistema.<br><br>Per a la llista completa de l'hora compatible zones si us plau, consulteu [documentació PHP](https://www.php.net/manual/en/timezones.php).|

en-us	# User  This class is designed to work with users.  Object references:\  -   [User](/manual/api/reference/user/object#user)  Available methods:\  -   [user.checkauthentication](/manual/api/reference/user/checkauthentication) -     checking and prolonging user sessions -   [user.create](/manual/api/reference/user/create) - creating new     users -   [user.delete](/manual/api/reference/user/delete) - deleting users -   [user.get](/manual/api/reference/user/get) - retrieving users -   [user.login](/manual/api/reference/user/login) - logging in to the     API -   [user.logout](/manual/api/reference/user/logout) - logging out of     the API -   [user.unblock](/manual/api/reference/user/unblock) - unblocking     users -   [user.update](/manual/api/reference/user/update) - updating users
ca	# Usuari  Aquesta classe és dissenyada per treballar amb usuaris.  Referències d'objectes:\  -   [Usuari](/manual/api/reference/user/object#user)  Mètodes disponibles:\  -   [user.checkauthentication](/manual/api/reference/user/checkauthentication) - testar i perllongar les sessions d'usuari -   [user.create](/manual/api/reference/user/create) - crear nou usuari -   [user.delete](/manual/api/reference/user/delete) - esborrar usuaris -   [user.get](/manual/api/reference/user/get) - recuperar usuaris -   [user.login](/manual/api/reference/user/login) - connectar a l'API -   [user.logout](/manual/api/reference/user/logout) - desconnectar de l'API -   [user.unblock](/manual/api/reference/user/unblock) - desblocar usuaris -   [user.update](/manual/api/reference/user/update) - actualitzar usuaris

en-us	 #### User types  Permissions in Zabbix depend, primarily, on the user type:     - *User* - has limited access rights to menu sections (see below) and no access to any resources by default. Any permissions to host or template groups must be explicitly assigned;    - *Admin* - has incomplete access rights to menu sections (see below). The user has no access to any host groups by default. Any permissions to host or template groups must be explicitly given;    - *Super admin* - has access to all menu sections. The user has a read-write access to all host and template groups. Permissions cannot be revoked by denying access to specific groups.  **Menu access**  The following table illustrates access to Zabbix menu sections per user type:  |Menu section|<|User|Admin|Super admin| |-|-------------|------|------|------| |**Dashboards**|<|+|+|+| |**Monitoring**|<|+|+|+| | |*Problems*|+|+|+| |^|*Hosts*|+|+|+| |^|*Latest data*|+|+|+| |^|*Maps*|+|+|+| |^|*Discovery*| |+|+| |**Services**|<|+|+|+| | |*Services*|+|+|+| |^|*SLA*| |+|+| |^|*SLA report*|+|+|+| |**Inventory**|<|+|+|+| | |*Overview*|+|+|+| |^|*Hosts*|+|+|+| |**Reports**|<|+|+|+| | |*System information*| | |+| |^|*Scheduled reports*| |+|+| |^|*Availability report*|+|+|+| |^|*Triggers top 100*|+|+|+| |^|*Audit log*| | |+| |^|*Action log*| | |+| |^|*Notifications*| |+|+| |**Data collection**|<| |+|+| | |*Template groups*| |+|+| |^|*Host groups*| |+|+| |^|*Templates*| |+|+| |^|*Hosts*| |+|+| |^|*Maintenance*| |+|+| |^|*Event correlation*| | |+| |^|*Discovery*| |+|+| |**Alerts**|<| |+|+| | |*Trigger actions*| |+|+| | |*Service actions*| |+|+| | |*Discovery actions*| |+|+| | |*Autoregistration actions*| |+|+| | |*Internal actions*| |+|+| |^|*Media types*| | |+| |^|*Scripts*| | |+| |**Users**|<| | |+| | |*User groups*| | |+| |^|*User roles*| | |+| |^|*Users*| | |+| |^|*API tokens*| | |+| |^|*Authentication*| | |+| |**Administration**|<| | |+| | |*General*| | |+| |^|*Audit log*| | |+| |^|*Housekeeping*| | |+| |^|*Proxies*| | |+| |^|*Macros*| | |+| |^|*Queue*| | |+|
ca	 #### Tipus d'usuari  Els permisos a Zabbix depenen, principalment, del tipus d'usuari:      - *Usuari* - té drets d'accés limitats a les seccions del menú (veieu més avall) i no té accés a cap recurs per defecte. Qualsevol permís per allotjar o grups de plantilles s'ha d'assignar explícitament;     - *Administrador* - té drets d'accés incomplets a les seccions del menú (veieu més avall). L'usuari no té accés a cap grup d'equips per defecte. Qualsevol permís per allotjar o grups de plantilles s'ha de donar explícitament;     - *Super administrador* - té accés a totes les seccions del menú. L'usuari té accés de lectura i escriptura a tots els grups d'equips i plantilles. Els permisos no es poden revocar negant l'accés a grups específics.  **Accés al menú**  La taula següent il·lustra l'accés a les seccions del menú Zabbix per tipus d'usuari:  |Secció de menús|<|Usuari|Administrador|Super administrador| |-|--------------|------|-------|------| |**Taulers**|<|+|+|+| |**Monitoratge**|<|+|+|+| | |*Problemes*|+|+|+| |^|*Equips*|+|+|+| |^|*Darreres dades*|+|+|+| |^|*Mapes*|+|+|+| |^|*Descoberta*| |+|+| |**Serveis**|<|+|+|+| | |*Serveis*|+|+|+| |^|*SLA*| |+|+| |^|*Informe SLA*|+|+|+| |**Inventari**|<|+|+|+| | |*Visió general*|+|+|+| |^|*Equips*|+|+|+| |**Informes**|<|+|+|+| | |*Informació del sistema*| | |+| |^|*Informes programats*| |+|+| |^|*Informe de disponibilitat*|+|+|+| |^|*Activa els 100 primers*|+|+|+| |^|*Registre d'auditoria*| | |+| |^|*Registre d'accions*| | |+| |^|*Notificacions*| |+|+| |**Recollida de dades**|<| |+|+| | |*Grups de plantilles*| |+|+| |^|*Grups d'equips*| |+|+| |^|*Plantilles*| |+|+| |^|*Equips*| |+|+| |^|*Manteniment*| |+|+| |^|*Correlació d'esdeveniments*| | |+| |^|*Descoberta*| |+|+| |**Alertes**|<| |+|+| | |*Activar accions*| |+|+| | |*Accions de servei*| |+|+| | |*Accions de descoberta*| |+|+| | |*Accions d'autoregistre*| |+|+| | |*Accions internes*| |+|+| |^|*Tipus de Suport*| | |+| |^|*Scripts*| | |+| |**Usuaris**|<| | |+| | |*Grups d'usuaris*| | |+| |^|*Rols d'usuari*| | |+| |^|*Usuaris*| | |+| |^|*Fitxa API*| | |+| |^|*Autenticació*| | |+| |**Administració**|<| | |+| | |*General*| | |+| |^|*Registre d'auditoria*| | |+| |^|*Neteja*| | |+| |^|*Proxies*| | |+| |^|*Macros*| | |+| |^|*Cua*| | |+|

en-us	# user.unblock
ca	# user.unblock

en-us	# user.update
ca	# user.update

en-us	#### user  [ZBXNEXT-8012](https://support.zabbix.com/browse/ZBXNEXT-8012) `user.checkAuthentication`: Added new parameter `token`.\
ca	#### Usuari  [ZBXNEXT-8012](https://support.zabbix.com/browse/ZBXNEXT-8012) `user.checkAuthentication`: Afegit el nou paràmetre `token`.\

en-us	#### user  [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) Removed support for deprecated property `alias`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Property `roleid` is no longer mandatory.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Added new properties `userdirectoryid`, `ts_provisioned`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Added new method `user.provision`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `user.create`: Parameter `usrgrps` is no longer mandatory.\ [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) `user.create`, `user.update`: Removed support for deprecated parameter `user_medias`.\ [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) `user.login`: Removed support for deprecated parameter `user`.\ [ZBXNEXT-3100](https://support.zabbix.com/browse/ZBXNEXT-3100) `user.update`: Added new parameter `current_passwd`.\
ca	#### usuari  [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) S'ha tret el suport per a la propietat obsoleta `alias`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) La propietat `roleid` ja no és obligatòria.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) S'han afegit les noves propietats `userdirectoryid`, `ts_provisioned`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) S'ha afegit el mètode `user.provision`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `user.create`: el paràmetre `usrgrps` ja no és obligatori.\ [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) `user.create`, `user.update`: s'ha tret el suport per al paràmetre obsolet `user_medias`.\ [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) `user.login`: s'ha tret el suport per al paràmetre obsolet `user`.\ [ZBXNEXT-3100](https://support.zabbix.com/browse/ZBXNEXT-3100) `user.update`: s'ha afegit un nou paràmetre `current_passwd`.\

en-us	#### Using a custom expression filter  Create a correlation that will use a custom filter condition. The formula IDs "A" or "B" have been chosen arbitrarily. Condition type will be "Host group" with operator "<>".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "correlation.create",     "params": {         "name": "new host group correlation",         "description": "a custom description",         "status": 0,         "filter": {             "evaltype": 3,             "formula": "A or B",             "conditions": [                 {                     "type": 2,                     "operator": 1,                     "formulaid": "A"                 },                 {                     "type": 2,                     "operator": 1,                     "formulaid": "B"                 }             ]         },         "operations": [             {                 "type": 1             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "correlationids": [             "2"         ]     },     "id": 1 } ```
ca	#### Emprar una expressió de filtre a mida  Crear una correlació que emprarà una condició de filtre a mida. Els IDs de fórmula "A" o "B" han de ser escollits arbitràriament. El tipus de condició serà "Grup d'equips" amb l'operador "<>".  Petició:  ```json {     "jsonrpc": "2.0",     "method": "correlation.create",     "params": {         "name": "new host group correlation",         "description": "a custom description",         "status": 0,         "filter": {             "evaltype": 3,             "formula": "A or B",             "conditions": [                 {                     "type": 2,                     "operator": 1,                     "formulaid": "A"                 },                 {                     "type": 2,                     "operator": 1,                     "formulaid": "B"                 }             ]         },         "operations": [             {                 "type": 1             }         ]     },     "auth": "343baad4f88b4106b9b5961e77437688",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "correlationids": [             "2"         ]     },     "id": 1 } ```

en-us	#### Using a custom expression filter  Create an LLD rule with a filter that will use a custom expression to evaluate the conditions. The LLD rule must only discover objects the "{\#MACRO1}" macro value of which matches both regular expression "regex1" and "regex2", and the value of "{\#MACRO2}" matches either "regex3" or "regex4". The formula IDs "A", "B", "C" and "D" have been chosen arbitrarily.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Filtered LLD rule",         "key_": "lld",         "hostid": "10116",         "type": 0,         "interfaceid": "13",         "delay": "30s",         "filter": {             "evaltype": 3,             "formula": "(A and B) and (C or D)",             "conditions": [                 {                     "macro": "{#MACRO1}",                     "value": "@regex1",                     "formulaid": "A"                 },                 {                     "macro": "{#MACRO1}",                     "value": "@regex2",                     "formulaid": "B"                 },                 {                     "macro": "{#MACRO2}",                     "value": "@regex3",                     "formulaid": "C"                 },                 {                     "macro": "{#MACRO2}",                     "value": "@regex4",                     "formulaid": "D"                 }             ]         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```
ca	#### Emprant un filtre d'expressió a mida  Crear una regla de descoberta de baix nivell (LLD) amb un filtre que emprarà una expressió a mida per avaluar les condicions. La regla haurà de trobar només els objectes de la macro "{\#MACRO1}" que corresponguin a l'expressió regular "regex1" i "regex2", i el valor de la "{\#MACRO2}" correspongui a "regex3" o "regex4". Els ID de fórmules "A", "B", "C" i "D" s'escolliran arbitràriament.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Regla LLD filtrada ",         "key_": "lld",         "hostid": "10116",         "type": 0,         "interfaceid": "13",         "delay": "30s",         "filter": {             "evaltype": 3,             "formula": "(A and B) and (C or D)",             "conditions": [                 {                     "macro": "{#MACRO1}",                     "value": "@regex1",                     "formulaid": "A"                 },                 {                     "macro": "{#MACRO1}",                     "value": "@regex2",                     "formulaid": "B"                 },                 {                     "macro": "{#MACRO2}",                     "value": "@regex3",                     "formulaid": "C"                 },                 {                     "macro": "{#MACRO2}",                     "value": "@regex4",                     "formulaid": "D"                 }             ]         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```

en-us	#### Using a custom expression filter  Create a trigger action that uses a custom expression - "A and (B or C)" - for evaluating action conditions. Once a trigger with a severity higher or equal to "Warning" from host "10084" or host "10106" goes into a PROBLEM state, the action will send a message to all users in user group "7" via media type "1". The formula IDs "A", "B" and "C" have been chosen arbitrarily.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "action.create",     "params": {         "name": "Trigger action",         "eventsource": 0,         "esc_period": "15m",         "filter": {             "evaltype": 3,             "formula": "A and (B or C)",             "conditions": [                 {                     "conditiontype": 4,                     "operator": 5,                     "value": "2",                     "formulaid": "A"                 },                 {                     "conditiontype": 1,                     "operator": 0,                     "value": "10084",                     "formulaid": "B"                 },                 {                     "conditiontype": 1,                     "operator": 0,                     "value": "10106",                     "formulaid": "C"                 }             ]         },         "operations": [             {                 "operationtype": 0,                 "esc_step_from": 1,                 "esc_step_to": 1,                 "opmessage_grp": [                     {                         "usrgrpid": "7"                     }                 ],                 "opmessage": {                     "default_msg": 1,                     "mediatypeid": "1"                 }             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "actionids": [             "18"         ]     },     "id": 1 } ```
ca	#### Emprant un filtre d'expressió personalitzat  Crear un trigger que farà ús d'una expressió personalitzada - "A i (B o C)" - per avaluar les condicions d'acció. Quan el trigger amb una gravetat més alta o igual a "Avís" dels equips "10084" i "10106" assoleixin un estat PROBLEMA, l'acció enviarà un missatge a tots els usuaris del grup d'usuaris "7" via el tipus de suport "1". Els IDS de fòrmula "A", "B" i "C" s'han triat arbitràriament.  Petició:  ```json {  · "jsonrpc": "2.0",  · "method": "action.create",  · "params": {  · "name": "Acció de trigger",  · "eventsource": 0,  · "esc_period": "15m",  · "filter": {  · "evaltype": 3,  · "formula": "A i (B o C)",  · "conditions": [  · {  · "conditiontype": 4,  · "operator": 5,  · "value": "2",  · "formulaid": "A"  · },  · {  · "conditiontype": 1,  · "operator": 0,  · "value": "10084",  · "formulaid": "B"  · },  · {  · "conditiontype": 1,  · "operator": 0,  · "value": "10106",  · "formulaid": "C"  · }  · ]  · },  · "operations": [  · {  · "operationtype": 0,  · "esc_step_from": 1,  · "esc_step_to": 1,  · "opmessage_grp": [  · {  · "usrgrpid": "7"  · }  · ],  · "opmessage": {  · "default_msg": 1,  · "mediatypeid": "1"  · }  · }  · ]  · },  · "auth": "038e1d7b1735c6a5436ee9eae095879e",  · "id": 1 } ```  Resposta:  ```json {  · "jsonrpc": "2.0",  · "result": {  · "actionids": [  · "18"  · ]  · },  · "id": 1 } ```

en-us	##### Using a custom tile service provider  The Geomap widget is capable to load raster tile images from a custom self-hosted or a third-party tile provider service. To use a custom third-party tile provider service or a self-hosted tile folder or server, select *Other* in the *Tile provider* field and specify the custom URL in the *Tile URL* field using proper placeholders.
ca	##### Ús d'un proveïdor de serveis de mosaic personalitzats  El giny Geomap és capaç de carregar imatges de mosaic des d'un servei personalitzat autoallotjat o d'un proveïdor de mosaic de tercers. Per emprar un servei de proveïdor de mosaic personalitzat de tercers o una carpeta o un servidor de mosaic autoallotjats, seleccioneu *Altres* al camp *Proveïdor de mosaic* i especifiqueu l'URL personalitzada al camp *URL de mosaic* amb els marcadors de posició adequats.

en-us	#### Using a filter  Create an LLD rule with a set of conditions to filter the results by. The conditions will be grouped together using the logical "and" operator.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Filtered LLD rule",         "key_": "lld",         "hostid": "10116",         "type": 0,         "interfaceid": "13",         "delay": "30s",         "filter": {             "evaltype": 1,             "conditions": [                 {                     "macro": "{#MACRO1}",                     "value": "@regex1"                 },                 {                     "macro": "{#MACRO2}",                     "value": "@regex2",                     "operator": "9"                 },                 {                     "macro": "{#MACRO3}",                     "value": "",                     "operator": "12"                 },                 {                     "macro": "{#MACRO4}",                     "value": "",                     "operator": "13"                 }             ]         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```
ca	#### Emprant un filtre  Crear una regla de descoberta de baix nivell amb un conjunt de condicions per filtrar els resultats. Les condicions seran reagrupades emprant l'operador lògic "i".  Petició:  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Regla LLD filtrada",         "key_": "lld",         "hostid": "10116",         "type": 0,         "interfaceid": "13",         "delay": "30s",         "filter": {             "evaltype": 1,             "conditions": [                 {                     "macro": "{#MACRO1}",                     "value": "@regex1"                 },                 {                     "macro": "{#MACRO2}",                     "value": "@regex2",                     "operator": "9"                 },                 {                     "macro": "{#MACRO3}",                     "value": "",                     "operator": "12"                 },                 {                     "macro": "{#MACRO4}",                     "value": "",                     "operator": "13"                 }             ]         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```

en-us	##### - Using a static IP address  By default the appliance uses DHCP to obtain the IP address. To specify a static IP address:  -   Log in as root user; -   Open */etc/sysconfig/network-scripts/ifcfg-eth0* file; -   Replace *BOOTPROTO=dhcp* with *BOOTPROTO=none* -   Add the following lines:     -   *IPADDR=<IP address of the appliance>*     -   *PREFIX=<CIDR prefix>*     -   *GATEWAY=<gateway IP address>*     -   *DNS1=<DNS server IP address>* -   Run **systemctl restart network** command.  Consult the official Red Hat [documentation](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/s1-networkscripts-interfaces) if needed.
ca	##### - Emprar una adreça IP estàtica  Per defecte, s'empra DHCP per obtindre l'adreça IP. Per especificar-ne una de fixa:  -   Connecteu com a usuari root; -   Obriu l'arxiu */etc/sysconfig/network-scripts/ifcfg-eth0* ; -   Substituïu *BOOTPROTO=dhcp* per *BOOTPROTO=none* -   Afegiu-hi les següents línies:     -   *IPADDR=<Adreça IP>*     -   *PREFIX=<prefix CIDR>*     -   *GATEWAY=<adreça IP de la passarel·la>*     -   *DNS1=<Adreça IP del servidor DNS>* -   Executeu la comanda **systemctl restart network**.  Si fos necessari, consulteu la [documentació](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/s1-networkscripts-interfaces) oficial de Red Hat.

en-us	#### Using custom endpoint with JBoss EAP 6.4  Custom endpoints allow working with different transport protocols other than the default RMI.  To illustrate this possibility, let's try to configure JBoss EAP 6.4 monitoring as an example. First, let's make some assumptions:  -   You have already installed Zabbix Java gateway. If not, then you can     do it in accordance with the [documentation](/manual/concepts/java). -   Zabbix server and Java gateway are installed with the prefix     `/usr/local/` -   JBoss is already installed in `/opt/jboss-eap-6.4/` and is running in     standalone mode -   We shall assume that all these components work on the same host -   Firewall and SELinux are disabled (or configured accordingly)  Let's make some simple settings in zabbix\_server.conf:      JavaGateway=127.0.0.1     StartJavaPollers=5  And in the `zabbix_java/settings.sh` configuration file (or `zabbix_java_gateway.conf`):      START_POLLERS=5  Check that JBoss listens to its standard management port:      $ netstat -natp | grep 9999     tcp        0      0 127.0.0.1:9999          0.0.0.0:*               LISTEN      10148/java  Now let's create a host with JMX interface 127.0.0.1:9999 in Zabbix.  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_jboss_example.png){width="600"}  As we know that this version of JBoss uses the JBoss Remoting protocol instead of RMI, we may mass update the JMX endpoint parameter for items in our JMX template accordingly:      service:jmx:remoting-jmx://{HOST.CONN}:{HOST.PORT}  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_jboss_example_b.png)  Let's update the configuration cache:      $ /usr/local/sbin/zabbix_server -R config_cache_reload  Note that you may encounter an error first.  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_jboss_example4.png){width="600"}  "Unsupported protocol: remoting-jmx" means that Java gateway does not know how to work with the specified protocol. That can be fixed by creating a `~/needed_modules.txt` file with the following content:      jboss-as-remoting     jboss-logging     jboss-logmanager     jboss-marshalling     jboss-remoting     jboss-sasl     jcl-over-slf4j     jul-to-slf4j-stub     log4j-jboss-logmanager     remoting-jmx     slf4j-api     xnio-api     xnio-nio  and then executing the command:      $ for i in $(cat ~/needed_modules.txt); do find /opt/jboss-eap-6.4 -iname "${i}*.jar" -exec cp '{}' /usr/local/sbin/zabbix_java/lib/ \; ; done  Thus, Java gateway will have all the necessary modules for working with jmx-remoting. What's left is to restart the Java gateway, wait a bit and if you did everything right, see that JMX monitoring data begin to arrive in Zabbix (see also: [Latest data](/manual/web_interface/frontend_sections/monitoring/latest_data)).
ca	#### Ús de les terminacions JMX personalitzades amb JBoss EAP 6.4  Els punts finals JMX personalitzats permeten treballar amb diferents protocols de transport diferents del RMI predeterminat.  Per il·lustrar aquesta possibilitat, provem de configurar el monitoratge JBoss EAP 6.4 com a exemple. Primer, fem algunes suposicions:  - Ja heu instal·lat la passarel·la Zabbix Java. Si no, podeu fer-ho segons [documentació](/manual/concepts/java). - El servidor Zabbix i la passarel·la Java s'instal·len amb el prefix `/usr/local/` - JBoss ja és instal·lat a `/opt/jboss-eap-6.4/` i funciona en mode autònom - Suposarem que tots aquests components s'executen al mateix equip - El tallafoc i SELinux són desactivats (o configurats en conseqüència)  Fem algunes configuracions senzilles a zabbix\_server.conf:       JavaGateway=127.0.0.1      StartJavaPollers=5  I al fitxer de configuració `zabbix\_java/settings.sh` (o `zabbix\_java\_gateway.conf`):       START_POLLERS=5  Verifiqueu que JBoss escolti per el seu port predeterminat:       $ netstat -natp | grep 9999      tcp 0 0 127.0.0.1:9999 0.0.0.0:* LISTEN 10148/java  Ara creem un equip amb la interfície JMX 127.0.0.1:9999 a Zabbix.  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_jboss_example.png){width="600"}  Com que sabem que aquesta versió de JBoss empra el protocol JBoss Remoting en lloc de RMI, podem actualitzar de manera massiva la configuració de l'equip destí JMX per als elements del nostre model JMX en conseqüència:       service:jmx:remoting-jmx://{HOST.CONN}:{HOST.PORT}  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_jboss_example_b.png)  Actualitzem la memòria cau de configuració:       $ /usr/local/sbin/zabbix_server -R config_cache_reload  Tingueu en compte que és possible que trobeu una errada la primera vegada.  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_jboss_example4.png){width="600"}  "Protocol no compatible: remoting-jmx" vol dir que la passarel·la Java no sap com treballar amb aquest protocol. Això es pot solucionar creant un fitxer \~/needed\_modules.txt amb el contingut següent:       jboss-com-remoting      jboss-logging      jboss-logmanager      jboss-marshalling      jboss-remoting      jboss-sasl      jcl-over-slf4j      jul-a-slf4j-estub      log4j-jboss-logmanager      remoting-jmx      slf4j-api      xnio-api      xnio-nio</pre>  i després executeu l'ordre:       $ for i in $(cat ~/needed_modules.txt); do find /opt/jboss-eap-6.4 -iname ${i}*.jar -exec cp {} /usr/local/sbin/zabbix_java/lib/ \; ; done  Així, la passarel·la Java disposarà de tots els mòduls necessaris per treballar amb JMX-Remoting. Queda per reiniciar la passarel·la Java, espereu una mica i si ho heu fet tot correctament, podreu veure que les dades de monitoratge de JMX comencen a arribar a Zabbix (veieu també: [darreres dades](/[[/manual/web_interface/frontend_sections/monitoring/latest_data)).

en-us	#### Using custom MIB files  There are standard MIB files coming with every GNU/Linux distribution. But some device vendors provide their own.  Let's say, you would like to use [CISCO-SMI](ftp://ftp.cisco.com/pub/mibs/v2/CISCO-SMI.my) MIB file. The following instructions will download and install it:      # wget ftp://ftp.cisco.com/pub/mibs/v2/CISCO-SMI.my -P /tmp     # mkdir -p /usr/local/share/snmp/mibs     # grep -q '^mibdirs +/usr/local/share/snmp/mibs' /etc/snmp/snmp.conf 2>/dev/null || echo "mibdirs +/usr/local/share/snmp/mibs" >> /etc/snmp/snmp.conf     # cp /tmp/CISCO-SMI.my /usr/local/share/snmp/mibs  Now you should be able to use it. Try to translate the name of the object *ciscoProducts* from the MIB file to OID:      # snmptranslate -IR -On CISCO-SMI::ciscoProducts     .1.3.6.1.4.1.9.1  If you receive errors instead of the OID, ensure all the previous commands did not return any errors.  The object name translation worked, you are ready to use custom MIB file. Note the MIB name prefix (*CISCO-SMI::*) used in the query. You will need this when using command-line tools as well as Zabbix.  Don't forget to restart Zabbix server/proxy before using this MIB file in Zabbix.  ::: noteimportant Keep in mind that MIB files can have dependencies. That is, one MIB may require another. In order to satisfy these dependencies you have to install all the affected MIB files. :::
ca	#### Ús d'arxius MIB a mida  Els arxius MIB estàndard vénen amb cada distribució GNU/Linux. Però alguns fabricants de perifèrics proporcionen els seus propis.  Suposem que ens cal emprar l'arxiu MIB de [CISCO-SMI](ftp://ftp.cisco.com/pub/mibs/v2/CISCO-SMI.my). Les instruccions següents el descarregaran i instal·laran:      # wget ftp://ftp.cisco.com/pub/mibs/v2/CISCO-SMI.my -P /tmp     # mkdir -p /usr/local/share/snmp/mibs     # grep -q '^mibdirs +/usr/local/share/snmp/mibs' /etc/snmp/snmp.conf 2>/dev/null || echo "mibdirs +/usr/local/share/snmp/mibs" >> /etc/snmp/snmp.conf     # cp /tmp/CISCO-SMI.my /usr/local/share/snmp/mibs  Ara l'hauríem de poder emprar. Provem a traduir el nom de l'objecte *ciscoProducts* de l'arxiu MIB a OID:      # snmptranslate -IR -On CISCO-SMI::ciscoProducts     .1.3.6.1.4.1.9.1  Si reben errors a l'enllaç de l'OID, assegurem-nos que totes les comandes precedents no retornen cap error.  La traducció del nom d'objecte ha funcionat, ara podem emprar l'arxiu MIB a mida. Veieu que s'empra el prefixe del nom MIB (*CISCO-SMI::*) a la consulta. Ens caldrà això quan emprem tant la línia de comandes com Zabbix.  No oblideu pas reiniciar el servidor/proxy Zabbix abans d'emprar l'arxiu MIB a Zabbix.  ::: noteimportant Penseu que els arxius MIB poden tindre dependències. És a dir, que un MIB pot haver-ne de menester un altre. Per complir les dependències, haurem d'instal·lar tots els arxius MIB afectats. :::

en-us	#### Using custom query fields and headers  Create LLD rule with custom query fields and headers.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "hostid": "10257",         "interfaceid": "5",         "type": 19,         "name": "API HTTP agent",         "key_": "api_discovery_rule",         "value_type": 3,         "delay": "5s",         "url": "http://127.0.0.1?discoverer.php",         "query_fields": [             {                 "mode": "json"             },             {                 "elements": "2"             }         ],         "headers": {             "X-Type": "api",             "Authorization": "Bearer mF_A.B5f-2.1JcM"         },         "allow_traps": 1,         "trapper_hosts": "127.0.0.1"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "28336"         ]     },     "id": 1 } ```
ca	#### emprant camps de consulta i capçaleres personalitzades  Crea una regla de descoberta de baix nivell (LLD) amb camps de consulta i de capçalera a mida.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "hostid": "10257",         "interfaceid": "5",         "type": 19,         "name": "API HTTP agent",         "key_": "api_discovery_rule",         "value_type": 3,         "delay": "5s",         "url": "http://127.0.0.1?discoverer.php",         "query_fields": [             {                 "mode": "json"             },             {                 "elements": "2"             }         ],         "headers": {             "X-Type": "api",             "Authorization": "Bearer mF_A.B5f-2.1JcM"         },         "allow_traps": 1,         "trapper_hosts": "127.0.0.1"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "28336"         ]     },     "id": 1 } ```

en-us	#### Using db.odbc.discovery  As a practical example to illustrate how the SQL query is transformed into JSON, let us consider low-level discovery of Zabbix proxies by performing an ODBC query on Zabbix database. This is useful for automatic creation of "zabbix\[proxy,<name>,lastaccess\]" [internal items](/manual/config/items/itemtypes/internal) to monitor which proxies are alive.  Let us start with discovery rule configuration:  ![lld\_rule\_odbc.png](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rule_odbc.png)  All mandatory input fields are marked with a red asterisk.  Here, the following direct query on Zabbix database is used to select all Zabbix proxies, together with the number of hosts they are monitoring. The number of hosts can be used, for instance, to filter out empty proxies:      mysql> SELECT h1.host, COUNT(h2.host) AS count FROM hosts h1 LEFT JOIN hosts h2 ON h1.hostid = h2.proxy_hostid WHERE h1.status IN (5, 6) GROUP BY h1.host;     +---------+-------+     | host    | count |     +---------+-------+     | Japan 1 |     5 |     | Japan 2 |    12 |     | Latvia  |     3 |     +---------+-------+     3 rows in set (0.01 sec)  By the internal workings of "db.odbc.discovery\[,{$DSN}\]" item, the result of this query gets automatically transformed into the following JSON:  ``` {.java} [     {         "{#HOST}": "Japan 1",         "{#COUNT}": "5"     },     {         "{#HOST}": "Japan 2",         "{#COUNT}": "12"     },     {         "{#HOST}": "Latvia",         "{#COUNT}": "3"     } ] ```  It can be seen that column names become macro names and selected rows become the values of these macros.  ::: noteclassic  If it is not obvious how a column name would be transformed into a macro name, it is suggested to use column aliases like "COUNT(h2.host) AS count" in the example above.  In case a column name cannot be converted into a valid macro name, the discovery rule becomes not supported, with the error message detailing the offending column number. If additional help is desired, the obtained column names are provided under DebugLevel=4 in Zabbix server log file:      $ grep db.odbc.discovery /tmp/zabbix_server.log      ...      23876:20150114:153410.856 In db_odbc_discovery() query:'SELECT h1.host, COUNT(h2.host) FROM hosts h1 LEFT JOIN hosts h2 ON h1.hostid = h2.proxy_hostid WHERE h1.status IN (5, 6) GROUP BY h1.host;'      23876:20150114:153410.860 db_odbc_discovery() column[1]:'host'      23876:20150114:153410.860 db_odbc_discovery() column[2]:'COUNT(h2.host)'      23876:20150114:153410.860 End of db_odbc_discovery():NOTSUPPORTED      23876:20150114:153410.860 Item [Zabbix server:db.odbc.discovery[proxies,{$DSN}]] error: Cannot convert column #2 name to macro.   :::  Now that we understand how a SQL query is transformed into a JSON object, we can use {\#HOST} macro in item prototypes:  ![item\_prototype\_odbc.png](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototype_odbc.png)  Once discovery is performed, an item will be created for each proxy:  ![discovered\_items\_odbc1.png](../../../../../assets/en/manual/discovery/low_level_discovery/discovered_items_odbc1.png)
ca	#### Emprant db.odbc.discovery  Com a exemple pràctic per il·lustrar com la consulta SQL es transforma en JSON, considereu la descoberta de baix nivell dels proxys Zabbix mitjançant la realització d'una consulta ODBC a la base de dades Zabbix. Això és útil per a la creació automàtica d'[elements interns](/manual/config/items/itemtypes/internal) "zabbix\[proxy,<nom>,lastaccess\]" per monitorar quins proxys són actius.  Comencem amb la configuració de la regla de descoberta:  ![lld\_rule\_odbc.png](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rule_odbc.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Aquí, la següent consulta directa a la base de dades Zabbix s'empra per triar tots els proxys Zabbix, juntament amb el nombre d'equips que monitoren. El nombre d'equips es pot emprar, per exemple, per filtrar els proxys buits:  ``` mysql> SELECT h1.host, COUNT(h2.host) AS count FROM hosts h1 LEFT JOIN hosts h2 ON h1.hostid = h2.proxy_hostid WHERE h1.status IN (5, 6) GROUP BY h1.host;      +---------+-------+      | equip | recompte |      +---------+-------+      | Japonès 1 | 5 |      | Japonès 2 | 12 |      | Letònia | 3 |      +---------+-------+      3 files en conjunt (0,01 segons) ```  Gràcies al funcionament intern de l'element “db.odbc.discovery[,{$DSN}]”, el resultat d'aquesta consulta es transforma automàticament en el següent JSON:  ``` {.java} [      {          "{#HOST}": "Japó1",          "{#COUNT}": "5"      },      {          "{#HOST}": "Japó 2",          "{#COUNT}": "12"      },      {          "{#HOST}": "Letònia",          "{#COUNT}": "3"      } ] ```  Podem veure que els noms de les columnes es converteixen en noms de macro i les fileres triades es converteixen en els valors d'aquestes macros.  :::noteclassic Si no és obvi com convertir un nom de columna en un nom de macro, es recomana emprar àlies de columna com ara "COUNT(h2.host) AS count" a l'exemple anterior. Si un nom de columna no es pot convertir en un nom de macro vàlid, la regla de descoberta no s'admet, amb el missatge d'error que detalla el nombre de columna ofensiu. Si cal més ajuda, els noms de columnes obtinguts es proporcionen a DebugLevel=4 al fitxer de registre del servidor Zabbix: ```      $ grep db.odbc.discovery /tmp/zabbix_server.log       ...       23876:20150114:153410.856 A la consulta db_odbc_discovery(): 'SELECT h1.host, COUNT(h2.host) FROM hosts h1 LEFT JOIN hosts h2 ON h1.hostid = h2.proxy_hostid WHERE h1.BY6 GROUP IN (GRUP) h1.host;'       23876:20150114:153410.860 db_odbc_discovery() columna[1]:'amfitrió'       23876:20150114:153410.860 db_odbc_discovery() column[2]:'COUNT(h2.host)'       23876:20150114:153410.860 Final de db_odbc_discovery():NOTSUPPORTED       23876:20150114:153410.860 Error de l'element [Servidor Zabbix:db.odbc.discovery[proxies,{$DSN}]]: no es pot convertir el nom de la columna 2 a macro. ``` :::  Ara que entenem com es transforma una consulta SQL en un objecte JSON, podem emprar la macro {#HOST} als prototips d'elements:  ![item\_prototype\_odbc.png](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototype_odbc.png)  Un cop descobert, es crearà un element per a cada proxy:  ![discovered\_items\_odbc1.png](../../../../../assets/en/manual/discovery/low_level_discovery/discovered_items_odbc1.png)

en-us	#### Using db.odbc.get  Using `db.odbc.get[,{$DSN}]` and the following SQL example:      mysql> SELECT h1.host, COUNT(h2.host) AS count FROM hosts h1 LEFT JOIN hosts h2 ON h1.hostid = h2.proxy_hostid WHERE h1.status IN (5, 6) GROUP BY h1.host;     +---------+-------+     | host    | count |     +---------+-------+     | Japan 1 |     5 |     | Japan 2 |    12 |     | Latvia  |     3 |     +---------+-------+     3 rows in set (0.01 sec)  this JSON will be returned:  ``` {.java} [     {         "host": "Japan 1",         "count": "5"     },     {         "host": "Japan 2",         "count": "12"     },     {         "host": "Latvia",         "count": "3"     } ] ```  As you can see, there are no low-level discovery macros there. However, custom low-level discovery macros can be created in the [LLD macros](/manual/discovery/low_level_discovery#custom_macros) tab of a discovery rule using JSONPath, for example:      {#HOST} → $.host  Now this {\#HOST} macro may be used in item prototypes:  ![item\_prototype\_odbc.png](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototype_odbc.png)
ca	#### Emprant db.odbc.get  Emprant `db.odbc.get[,{$DSN}]` i el següent exemple: ```     mysql> SELECT h1.host, COUNT(h2.host) AS count FROM hosts h1 LEFT JOIN hosts h2 ON h1.hostid = h2.proxy_hostid WHERE h1.status IN (5, 6) GROUP BY h1.host;     +---------+-------+     | equip | recompte |     +---------+-------+     | Japan 1 |     5 |     | Japan 2 |    12 |     | Latvia  |     3 |     +---------+-------+     3 rows in set (0.01 sec) ``` el JSON que retornarà:  ``` {.java} [     {         "host": "Japan 1",         "count": "5"     },     {         "host": "Japan 2",         "count": "12"     },     {         "host": "Latvia",         "count": "3"     } ] ```  Com podeu veure, no hi ha macros de descoberta de baix nivell. Tanmateix, es poden crear macros de descoberta personalitzades de baix nivell a la pestanya [LLD Macros](/manual/discovery/low_level_discovery#custom_macros) d'una regla de descoberta mitjançant JSONPath, per exemple: ```      {#HOST} → $.host ``` Ara aquesta macro {\#HOST} es pot emprar a prototips d'elements:  ![item\_prototype\_odbc.png](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototype_odbc.png)

en-us	#### Using DNS as default interface  HostInterface and HostInterfaceItem [configuration parameters](/manual/appendix/config/zabbix_agentd) allow to specify a custom value for the host interface during autoregistration.  More specifically, they are useful if the host should be autoregistered with a DNS name as the default agent interface rather than its IP address. In that case the DNS name should be specified or returned as the value of either HostInterface or HostInterfaceItem parameters. Note that if the value of one of the two parameters changes, the autoregistered host interface is updated. So it is possible to update the default interface to another DNS name or update it to an IP address. For the changes to take effect though, the agent has to be restarted.  ::: noteclassic If HostInterface or HostInterfaceItem parameters are not configured, the listen\_dns parameter is resolved from the IP address. If such resolving is configured incorrectly, it may break autoregistration because of invalid hostname. :::
ca	#### Emprar DNS com a interfície per defecte  Els valors de [configuració](/manual/appendix/config/zabbix_agentd) HostInterface i HostInterfaceItem permeten especificar un valor personalitzat per a la interfície de l'equip durant el registre automàtic.   Concretament, són útils si l'equip s'ha de registrar automàticament amb un nom DNS com a interfície d'agent predeterminada en lloc de la seva adreça IP. En aquest cas, el nom DNS s'ha d'especificar o retornar com a valor dels paràmetres HostInterface o HostInterfaceItem. Tingueu en compte que si el valor d'un paràmetre canvia, la interfície de l'equip registrada automàticament s'actualitza. Per tant, és possible actualitzar la interfície predeterminada a un altre nom DNS o actualitzar-la a una adreça IP. Perquè els canvis tinguin efecte, s'ha de reiniciar l'agent.  :::noteclassic Si els paràmetres HostInterface o HostInterfaceItem no són configurats, el paràmetre listen\_dns es resol des de l'adreça IP. Si aquesta resolució no es configura correctament, pot trencar el registre automàtic a causa d'un nom d'equip no vàlid. :::

en-us	#### Using filter  The filter can help narrow down the number of hosts and/or triggers displayed. For better search performance, data is searched with macros unresolved.  The filter is located below the *Availability report* bar. It can be opened and collapsed by clicking on the *Filter* tab on the right.
ca	#### Ús de filtres  El filtre pot ajudar a reduir el nombre d'equips i/o triggers que es mostren. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.  El filtre es troba a la barra *Informes de disponibilitat*. Es pot obrir i replegar fent clic a la pestanya *Filtre* de la dreta.

en-us	#### Using filter  The filter is located below the *Action log* bar. It can be opened and collapsed by clicking on the *Filter* tab at the top right corner of the page.  ![](../../../../../assets/en/manual/web_interface/action_log_filter.png){width="600"}  You may use the filter to narrow down the records by notification recipients, actions, media types, status, or by the message/remote command content (*Search string*). For better search performance, data is searched with macros unresolved.
ca	#### Ús de filtres  El filtre es troba sota la barra *Registre d'acció*. Es pot obrir i replegar fent clic a la pestanya *Filtre* a la cantonada superior dreta.  ![](../../../../../assets/en/manual/web_interface/action_log_filter.png){width="600"}  Podeu emprar el filtre per restringir els registres per notificació de destinataris, accions, tipus de suport, estat o per el contingut del missatge/comanda remota (*Cadena de cerda*).  Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.

en-us	 #### Using filter  The filter is located below the *Audit log* bar. It can be opened and collapsed by clicking on the *Filter* tab in the upper right corner.  ![](../../../../../assets/en/manual/web_interface/audit_log_filter.png){width="600"}  You may use the filter to narrow down the records by user, affected resource, resource ID and  performed operation (*Recordset ID*). Depending on the resource, one or more specific actions can be selected in the filter.  For better search performance, all data is searched with macros unresolved.
ca	#### Ús de filtres  El filtre es troba sota la barra *Registre d'auditoria*. Es pot obrir i replegar fent clic a la pestanya *Filtre* a la cantonada superior dreta.  ![](../../../../../assets/en/manual/web_interface/audit_log_filter.png){width="600"}  Podeu emprar el filtre per restringir els registres per usuari, recursos assignats, identificador de recurs i operació de la interfície web (*ID del conjunt de registres*). Depenent del recurs, es poden triar una o més accions al filtre.  Per obtindre un millor rendiment de la cerca, es cerquen totes les dades amb macros no resoltes.

en-us	##### Using filter  The item list may contain a lot of items. By using the filter, you can filter out some of them to quickly locate the items you'ŗe looking for. For better search performance, data is searched with macros unresolved.  The *Filter* icon is available at the top right corner. Clicking on it will open a filter where you can specify the desired filtering criteria.  ![](../../../../../../assets/en/manual/web_interface/template_item_filter.png){width="600"}  |Parameter|Description| |--|--------| |*Template groups*|Filter by one or more template groups.<br>Specifying a parent template group implicitly selects all nested groups.| |*Templates*|Filter by one or more templates.| |*Name*|Filter by item name.| |*Key*|Filter by item key.| |*Value mapping*|Filter by the value map used.<br>This parameter is not displayed if the *Templates* option is empty.| |*Type*|Filter by item type (Zabbix agent, SNMP agent, etc.).| |*Type of information*|Filter by type of information (Numeric unsigned, float, etc.).| |*History*|Filter by how long item history is kept.| |*Trends*|Filter by how long item trends are kept.| |*Update interval*|Filter by item update interval.| |*Tags*|Specify tags to limit the number of items displayed. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met| |*Status*|Filter by item status - *Enabled* or *Disabled*.| |*Triggers*|Filter items with (or without) triggers.| |*Inherited*|Filter items inherited (or not inherited) from linked templates.|  The **Subfilter** below the filter offers further filtering options (for the data already filtered). You can select groups of items with a common parameter value. Upon clicking on a group, it gets highlighted and only the items with this parameter value remain in the list.
ca	##### Emprant filtres  El llistat d'elements pot contindre molts elements. Mitjançant el filtre, podeu filtrar-ne alguns per localitzar ràpidament els elements que sou cercant. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros sense resoldre.  La icona *Filtre* és disponible a l'extrem superior dret. En fer-hi clic s'obrirà un filtre on podreu especificar els criteris de filtrat desitjats.  ![](../../../../../../assets/en/manual/web_interface/template_item_filter.png){width="600"}  |Paràmetre|Descripció| |--|---------| |*Grups de plantilles*|Filtra per un o més grups de plantilles.<br>Especificar un grup de plantilles pare selecciona implícitament tots els grups heretats.| |*Plantilles*|Filtra per una o més plantilles.| |*Nom*|Filtra per nom de l'element.| |*Clau*|Filtra per clau d'element.| |*Mapatge de valors*|Filtreu pel mapa de valors emprat.<br>Aquest paràmetre no es mostra si l'opció *Plantilles* és buida.| |*Tipus*|Filtra per tipus d'element (agent Zabbix, agent SNMP, etc.).| |*Tipus d'informació*|Filtra per tipus d'informació (numèric sense signe, flotant, etc.).| |*Historial*|Filtra per quant de temps es conserva l'historial d'elements.| |*Tendències*|Filtra per quant de temps es mantenen les tendències dels articles.| |*Interval d'actualització*|Filtra per interval d'actualització d'elements.| |*Etiquetes*|Especifiqueu etiquetes per limitar el nombre d'elements que es mostren. És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden establir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats<br>**Igual** - inclou els noms d'etiquetes especificats i valors (distingeix entre majúscules i minúscules)<br>**Conté** - inclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>**No existeix** - exclou l'especificat noms d'etiquetes<br>**No és igual** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules)<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta continguin la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions que tinguin el mateix nom d'etiqueta s'agruparan per la condició O<br>**O** - prou si es compleix una condició| |*Estat*|Filtra per estat de l'element - *Activat* o *Desactivat*.| |*Triggers*|Filtra elements amb (o sense) triggers.| |*Heretat*|Filtra els elements heretats (o no heretats) de plantilles enllaçades.|  El **subfiltre** que hi ha a sota del filtre ofereix més opcions de filtrat (per a les dades ja filtrades). Podeu triar grups d'elements amb un valor de paràmetre comú. En fer clic en un grup, es ressalta i només els elements amb aquest valor de paràmetre romanen a la llista.

en-us	##### Using filter  The page shows a list of all web scenarios of the selected host. To view web scenarios for another host or host group without returning to the *Monitoring → Hosts* page, select that host or group in the filter. You may also filter scenarios based on tags.
ca	##### Ús de filtres  La pàgina mostra una llista de tots els escenaris web per a l'equip seleccionat. Per veure escenaris web per a un altre equip o grup d'equips sense tornar a la pàgina *Monitoratge → Equips*, trieu aquest equip o grup al filtre. També podeu filtrar escenaris basats en etiquetes.

en-us	##### Using filter  To view a specific graph, select it in the filter. The filter allows to specify the host, the graph name and the *Show* option (all/host graphs/simple graphs).  ![](../../../../../../assets/en/manual/web_interface/graph_filter.png){width="600"}  If no host is selected in the filter, no graphs are displayed.
ca	##### Ús de filtres  Per veure un gràfic específic, seleccioneu-lo al filtre. El filtre permet especificar l'equip, el nom del gràfic i l'opció *Veure* (all/host graphs/simple graphs).  ![](../../../../../../assets/en/manual/web_interface/graph_filter.png){width="600"}  Si no es tria cap equip al filtre, no es veurà pas cap gràfic.

en-us	##### Using filter  You can filter graphs by host group and host. For better search performance, data is searched with macros unresolved.
ca	##### Ús de filtres  Podeu filtrar gràfics per grup d'equips i equip. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.

en-us	##### Using filter  You can filter graphs by template group and template. For better search performance, data is searched with macros unresolved.
ca	##### Ús de filtres  Podeu filtrar gràfics per grup de plantilles i plantilles. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.

en-us	##### Using filter  You can use the filter to display only the actions you are interested in. For better search performance, data is searched with macros unresolved.  The *Filter* link is available above the list of actions. If you click on it, a filter becomes available where you can filter actions by name and status.  ![](../../../../../assets/en/manual/web_interface/action_filter.png){width="600"}
ca	##### Ús de filtres  Podeu emprar filtres per veure només les accions que us interessen. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.  L'enllaç *Filtre* és disponible a sobre de la llista d'accions. Si hi feu clic, hi haurà un filtre disponible i podeu filtrar les accions per nom i estat.  ![](../../../../../assets/en/manual/web_interface/action_filter.png){width="600"}

en-us	##### Using filter  You can use the filter to display only the correlation rules you are interested in. For better search performance, data is searched with macros unresolved.  The *Filter* link is available above the list of correlation rules. If you click on it, a filter becomes available where you can filter correlation rules by name and status.  ![](../../../../../assets/en/manual/web_interface/correlation_rules_filter1.png){width="600"}
ca	##### Ús de filtres  Podeu emprar filtres per veure només les regles de correlació que us interessen. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.  L'enllaç *Filtre* és disponible a sobre del llistat de regles de correlació. Si hi feu clic, hi haurà un filtre disponible i podeu filtrar les regles de correlació per nom i estat.  ![](../../../../../assets/en/manual/web_interface/correlation_rules_filter1.png){width="600"}

en-us	##### Using filter  You can use the filter to display only the discovery rules you are interested in. For better search performance, data is searched with macros unresolved.  The *Filter* icon is available at the top right corner. Clicking on it will open a filter where you can specify the desired filtering criteria such as template, discovery rule name, item key, item type, etc.  ![](../../../../../../assets/en/manual/web_interface/template_drule_filter.png){width="600"}  |Parameter|Description| |--|--------| |*Template groups*|Filter by one or more template groups.<br>Specifying a parent template group implicitly selects all nested groups.| |*Templates*|Filter by one or more templates.| |*Name*|Filter by discovery rule name.| |*Key*|Filter by discovery item key.| |*Type*|Filter by discovery item type.| |*Update interval*|Filter by update interval.<br>Not available for Zabbix trapper and dependent items.| |*Keep lost resources period*|Filter by Keep lost resources period.| |*Status*|Filter by discovery rule status (All/Enabled/Disabled).|
ca	##### Ús de filtres  Podeu emprar el filtre per mostrar només les regles de descoberta que us interessa. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.  La icona *Filtre* és disponible a la cantonada superior dreta. Si hi feu clic, s'obrirà un filtre on podreu especificar els criteris de filtre desitjats, com ara el model, el nom de la regla de descoberta, la clau d'element, el tipus d'element, etc.  ![](../../../../../../assets/en/manual/web_interface/template_drule_filter.png){width="600"}  |Paràmetre|Descripció| |--|---------| |*Grups de plantilles*|Filtra per un o més grups de plantilles.<br>Especificar un grup de plantilles pare tria implícitament tots els grups niuats.| |*Plantilles*|Filtra per una o més plantilles.| |*Nom*|Filtra per nom de la regla de descoberta.| |*Clau*|Filtra per clau d'element de descoberta.| |*Tipus*|Filtra per tipus d'element de descoberta.| |*Interval d'actualització*|Filtra per interval d'actualització.<br>No disponible per a Zabbix trapper i elements dependents.| |*Període de retenció de recursos perduts*|Filtra per període de retenció de recursos perduts.| |*Estat*|Filtra per estat de la regla de descoberta (Tot/Activat/Desactivat).|

en-us	##### Using filter  You can use the filter to display only the discovery rules you are interested in. For better search performance, data is searched with macros unresolved.  The *Filter* link is available above the list of discovery rules. If you click on it, a filter becomes available where you can filter discovery rules by host group, host, name, item key, item type, and other parameters.  ![](../../../../../../assets/en/manual/web_interface/lld_rule_filter.png){width="600"}  |Parameter|Description| |--|--------| |*Host groups*|Filter by one or more host groups.<br>Specifying a parent host group implicitly selects all nested host groups.| |*Hosts*|Filter by one or more hosts.| |*Name*|Filter by discovery rule name.| |*Key*|Filter by discovery item key.| |*Type*|Filter by discovery item type.| |*Update interval*|Filter by update interval.<br>Not available for Zabbix trapper and dependent items.| |*Keep lost resources period*|Filter by Keep lost resources period.| |*SNMP OID*|Filter by SNMP OID.<br>Only available if *SNMP agent* is selected as type.| |*State*|Filter by discovery rule state (All/Normal/Not supported).| |*Status*|Filter by discovery rule status (All/Enabled/Disabled).|
ca	##### Emprant filtres  Podeu emprar el filtre per mostrar només les regles de descoberta que us interessen. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros sense resoldre.  L'enllaç *Filtre* és disponible a sobre de la llista de regles de descoberta. Si hi feu clic, hi haurà disponible un filtre on podeu filtrar les regles de descoberta per grup d'equips, equip, nom, clau d'element, tipus d'element i altres paràmetres.  ![](../../../../../../assets/en/manual/web_interface/lld_rule_filter.png){width="600"}  |Paràmetre|Descripció| |--|---------| |*Grups d'equips*|Filtra per un o més grups d'equips.<br>Especificar un grup d'equips principal tria implícitament tots els grups d'equip heretats.| |*Equips*|Filtrar per un o més equips.| |*Nom*|Filtra per nom de la regla de descoberta.| |*Clau*|Filtra per clau d'element de descoberta.| |*Tipus*|Filtra per tipus d'element de descoberta.| |*Interval d'actualització*|Filtra per interval d'actualització.<br>No disponible per a Zabbix trapper i elements dependents.| |*Període de conservació dels recursos perduts*|Filtra per període de conservació de recursos perduts.| |*SNMP OID*|Filtra per SNMP OID.<br>Només disponible si s'ha seleccionat *agent SNMP* com a tipus.| |*Estat*|Filtra per estat de la regla de descoberta (Tot/Normal/No compatible).| |*Estat*|Filtra per estat de la regla de descoberta (Tot/Activat/Desactivat).|

en-us	##### Using filter  You can use the filter to display only the discovery rules you are interested in. For better search performance, data is searched with macros unresolved.  The *Filter* link is available above the list of discovery rules. If you click on it, a filter becomes available where you can filter discovery rules by name and status.  ![](../../../../../assets/en/manual/web_interface/discovery_rules_filter1.png){width="600"}
ca	##### Ús de filtres  Podeu emprar filtres per veure només les regles de descoberta que us interessen. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.  L'enllaç *Filtre* és disponible a sobre de la llista de regles de descoberta. Si hi feu clic, hi haurà un filtre disponible i podeu filtrar les regles de descoberta per nom i estat.  ![](../../../../../assets/en/manual/web_interface/discovery_rules_filter1.png){width="600"}

en-us	##### Using filter  You can use the filter to display only the discovery rules you are interested in. For better search performance, data is searched with macros unresolved.  With nothing selected in the filter, all enabled discovery rules are displayed. To select a specific discovery rule for display, start typing its name in the filter. All matching enabled discovery rules will be listed for selection. More than one discovery rule can be selected.
ca	##### Ús de filtres  Podeu emprar el filtre per mostrar només les regles de descoberta que us interessa. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.  Si no es tria res al filtre, es mostren totes les regles de descoberta activades. Per triar una regla de descoberta específica per veure-la, comenceu a escriure-ne el nom al filtre. Totes les regles de descoberta activades que coincideixin es veuran per triar-les. Es poden triar diverses regles de descoberta.

en-us	##### Using filter  You can use the filter to display only the host groups you are interested in. For better search performance, data is searched with macros unresolved.
ca	##### Ús de filtres  Podeu emprar el filtre per mostrar només els grups d'equips que us interessen. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes.

en-us	#### Using filter  You can use the filter to display only the hosts you are interested in. For better search performance, data is searched with macros unresolved.  The *Filter* icon is available at the top right corner. Clicking on it will open a filter where you can specify the desired filtering criteria.  ![](../../../../../assets/en/manual/web_interface/host_filter.png){width="600"}  |Parameter|Description| |--|--------| |*Host groups*|Filter by one or more host groups.<br>Specifying a parent host group implicitly selects all nested host groups.| |*Templates*|Filter by linked templates.| |*Name*|Filter by visible host name.| |*DNS*|Filter by DNS name.| |*IP*|Filter by IP address.| |*Port*|Filter by port number.| |*Status*|Filter by host status.| |*Monitored by*|Filter hosts that are monitored by server only, proxy only or both.| |*Proxy*|Filter hosts that are monitored by the proxy specified here.| |*Tags*|Filter by host tag name and value.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition;<br>**Or** - enough if one condition is met.|
ca	#### Emprant filtres  Podeu emprar el filtre per veure només els equips que us interessen. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros sense resoldre.  La icona *Filtre* és disponible a l'extrem superior dret. En fer-hi clic s'obrirà un filtre on podreu especificar els criteris de filtrat desitjats.  ![](../../../../../assets/en/manual/web_interface/host_filter.png){width="600"}  |Paràmetre|Descripció| |--|---------| |*Grups d'equip*|Filtra per un o més grups d'equips.<br>Especificar un grup d'equips principal tria implícitament tots els grups d'equips heretats.| |*Plantilles*|Filtra per plantilles enllaçades.| |*Nom*|Filtra per nom d'equip visible.| |*DNS*|Filtra per nom DNS.| |*IP*|Filtra per adreça IP.| |*Port*|Filtra per nombre de port.| |*Estat*|Filtra per estat de l'equip.| |*Monitorat per*|Filtra els equip que són monitorats només pel servidor, només pel proxy o ambdós.| |*Proxy*|Filtreu els equips monitorats pel proxy especificat aquí.| |*Etiquetes*|Filtra per nom i valor de l'etiqueta d'equip.<br>És possible incloure i excloure etiquetes i valors d'etiqueta específics. Es poden establir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br><br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats;<br>**Igual** - inclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules);<br>**Conté** - inclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules);<br>**No existeix ** - exclou els noms d'etiquetes especificats;<br>**No és igual** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules);<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules).<br><br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions tenen el el mateix nom d'etiqueta s'agruparà per la condició O;<br>**O** - prou si es compleix una condició.|