Zammad
Plugin para crear,editar o eliminar tickets en Zammad con Pandora FMS.
- Introducción
- Matriz de compatibilidad
- Pre requisitos
- Configuración
- Parámetros
- Crear ticket
- Actualizar ticket
- Eliminar ticket
Introducción
Plugin para gestionar tickets en Zammad, puedes crear, eliminar y actualizar tickets.
Matriz de compatibilidad
| Sistemas donde se ha probado |
CentOS 7, Fedora. |
| Sistemas donde debería funcionar |
Cualquier sistema GNU/Linux. |
Pre requisitos
Se requiere:
- Habilitar autenticación básica o mediante token de la API.
- * Python3 .
- * Librería
requests.
* En la versión binaria del plugin no es requerido tener estas dependencias puesto que ya vienen incluidas en el compilado.
Configuración
Se tiene que habilitar la autenticación mediante token ( Access Token ) o básica ( Acceso a Password ) haciendo clic en Administrar y luego en API.
El token se crea haciendo clic en Perfil y luego en Access token:
Para que funcione debe poner ticket.agent en permisos.
Parámetros
Parámetros
| Method | -m | get,post,put o delete |
| host | -i, --ip | nombre de tu sitio zammad |
| user | -us | nombre de tu usuario (email) |
| password | -p | pass de la API |
| token | -t | token de la API |
| ticket name | -tn | nombre del ticket |
| ticket comment | -tb | contenido (texto) del ticket |
| ticket id | -id | id del ticket |
| ticket status | -ts | estado |
| ticket priority | -tp | prioridad |
| ticket type | -tt | tipo |
| ticket group | -tg | grupo |
| ticket subject | -tsub | subject |
| ticket customer | -tc | customer (el customer como tal es el correo del customer registrado) |
| ticket note | -tnote | nota |
Métodos
Get para listar, post para crear ticket, put para actualizar ticket y delete para borrar ticket .
Crear ticket
Argumentos necesarios
-m (post)
-i (host)
-us y -p o -t (user y password o solo token dependiendo de la autenticación)
-tn (nombre ticket)
-tg (nombre grupo)
-tp (prioridad)
-ts (status)
-tsub (subject)
-tb (contenido)
-tt (tipo)
-tc (customer)
-tnote (nota)
Ejemplo ejecución manual :
./pandora_zammad -m post -i pandoraplugin -t <token> -tn "ejemplo creacion" -tg Users -tp 3 -tt note -ts 2 -tsub subject -tb "el contenido de la incidencia" -tnote nota -tc <customer>
En el argumento -i (host) he puesto pandoraplugin porque el nombre de mi sitio es : https://pandoraplugin.zammad.com/
Se creará el ticket :
Actualizar ticket
Argumentos necesarios
-m (put)
-i (host)
-us y -p o -t (user y password o solo token dependiendo de la autenticación)
-id (id ticket)
-tn (nombre ticket)
-tg (nombre grupo)
-tp (prioridad)
-ts (status)
-tsub (subject)
-tb (contenido)
-tt (tipo)
-tc (customer)
-tnote (nota)
Ejemplo ejecución manual :
./pandora_zammad -m put -id 3 -i pandoraplugin -t <token> -tn probando123 -tg Users -tp 3 -tt note -ts 2 -tsub <subject> -tb "el contenido de la incidencia" -tnote nota -tc <email>
Se actualizará el ticket con esa id:
Eliminar ticket
Se eliminará el ticket buscando por id.
Ejemplo con ejecución manual.
./pandora_zammad -m delete -i pandoraplugin -t <token> -id 13