Tokens
En esta página se describen los flags de token y los flags (bits) ACL a los que corresponden.
Cada token tiene un flag combinado (fl) que limita los derechos de acceso que el token puede utilizar. Un flag de token combina varios bits de derechos de acceso individuales en una sola categoría (por ejemplo, rastreo en línea o modificación de datos). Un token no puede superar los derechos de acceso del usuario.
En las solicitudes de API, el flag de token (
fl) suele especificarse como número decimal. En las tablas a continuación, los bits ACL se muestran en HEX y en DEC para mayor comodidad.
| Flag de token (HEX) | Flag de token (DEC) | Descripción |
|---|---|---|
| 0x100 | 256 | Rastreo en línea |
| 0x200 | 512 | Visualización de datos |
| 0x400 | 1024 | Modificación de datos no sensibles |
| 0x800 | 2048 | Modificación de datos sensibles |
| 0x1000 | 4096 | Modificación de datos críticos y eliminación de mensajes |
| 0x2000 | 8192 | Envío de comandos y modificación de asuntos |
| 0x4000 | 16384 | Administración de códigos de activación |
| -1 | -1 | Acceso ilimitado |
Para conceder varios niveles de acceso a un token, sume los valores de los flags de token. Por ejemplo, para conceder acceso al rastreo en línea (256) y a la visualización de datos (512), utilice fl = 768.
Para conceder acceso sin restricciones, utilice fl = -1.
Rastreo en línea
El flag de token 0x100 (256) concede los derechos de acceso relacionados con el rastreo en línea.
| Se aplica a | Nombre del derecho de acceso | Bit ACL (HEX) | Bit ACL (DEC) |
|---|---|---|---|
| Cualquier objeto | Ver objeto y sus propiedades básicas | 0x1 | 1 |
| Cualquier objeto | Ver detalle de propiedades de objeto | 0x2 | 2 |
| Cualquier objeto | Ver campos personalizados | 0x20 | 32 |
| Cualquier objeto | Solicitar informes y mensajes | 0x200 | 512 |
| Cualquier objeto | Ver y descargar archivos | 0x4000 | 16384 |
| Unidad, grupo de unidades | Ver comandos | 0x400000000 | 17179869184 |
| Unidad, grupo de unidades | Exportar mensajes | 0x80000000 | 2147483648 |
| Unidad, grupo de unidades | Ver vídeo | 0x80000000000 | 8796093022208 |
| Recurso (Cuenta) | Ver POI (obsoleto) | 0x400000 | 4194304 |
| Recurso (Cuenta) | Ver geocercas | 0x1000000 | 16777216 |
| Recurso (Cuenta) | Ver plantillas de informes | 0x10000000 | 268435456 |
| Recurso (Cuenta) | Ver conductores | 0x40000000 | 1073741824 |
| Recurso (Cuenta) | Ver pasajeros | 0x800000000 | 34359738368 |
| Recurso (Cuenta) | Ver remolques | 0x100000000000 | 17592186044416 |
Visualización de datos
El flag de token 0x200 (512) concede los derechos de acceso relacionados con la visualización de datos.
| Se aplica a | Nombre del derecho de acceso | Bit ACL (HEX) | Bit ACL (DEC) |
|---|---|---|---|
| Unidad, grupo de unidades | Ver intervalos de servicio | 0x10000000 | 268435456 |
| Unidad, grupo de unidades | Ver propiedades de conexión (tipo de dispositivo, ID único, número de teléfono, contraseña, etc.) | 0x4000000 | 67108864 |
| Usuario | Actuar en nombre del usuario (crear objetos, iniciar sesión, etc.) | 0x200000 | 2097152 |
| Recurso (Cuenta) | Ver notificaciones | 0x100000 | 1048576 |
| Recurso (Cuenta) | Ver tareas | 0x4000000 | 67108864 |
| Recurso (Cuenta) | Ver pedidos | 0x200000000 | 8589934592 |
Modificación de datos no sensibles
El flag de token 0x400 (1024) concede los derechos de acceso relacionados con la modificación de datos no sensibles.
| Se aplica a | Nombre del derecho de acceso | Bit ACL (HEX) | Bit ACL (DEC) |
|---|---|---|---|
| Cualquier objeto | Renombrar objeto | 0x10 | 16 |
| Cualquier objeto | Gestionar campos personalizados | 0x40 | 64 |
| Cualquier objeto | Modificar propiedades no mencionadas | 0x80 | 128 |
| Cualquier objeto | Cambiar icono | 0x100 | 256 |
| Cualquier objeto | Cargar y eliminar archivos | 0x8000 | 32768 |
| Unidad, grupo de unidades | Administrar eventos | 0x2000000 | 33554432 |
| Unidad, grupo de unidades | Crear, modificar y eliminar comandos | 0x800000000 | 34359738368 |
| Recurso (Cuenta) | Crear, modificar y eliminar POI (obsoleto) | 0x800000 | 8388608 |
| Recurso (Cuenta) | Crear, modificar y eliminar geocercas | 0x2000000 | 33554432 |
Modificación de datos sensibles
El flag de token 0x800 (2048) concede los derechos de acceso relacionados con la modificación de datos sensibles.
| Se aplica a | Nombre del derecho de acceso | Bit ACL (HEX) | Bit ACL (DEC) |
|---|---|---|---|
| Cualquier objeto | Gestionar acceso al objeto | 0x4 | 4 |
| Unidad, grupo de unidades | Crear, modificar y eliminar intervalos de servicio | 0x20000000 | 536870912 |
| Unidad, grupo de unidades | Modificar ajustes de viajes, conducción y Diagnóstico | 0x4000000000 | 274877906944 |
| Unidad, grupo de unidades | Utilizar unidad en tareas, notificaciones, rutas, repetidores | 0x8000000000 | 549755813888 |
| Unidad, grupo de unidades | Gestionar vídeo | 0x100000000000 | 17592186044416 |
| Usuario | Administrar derechos de acceso del usuario | 0x100000 | 1048576 |
| Usuario | Modificar propiedades básicas del usuario | 0x400000 | 4194304 |
| Repetidor | Modificar las propiedades del repetidor, incluyendo inicio/paro | 0x100000 | 1048576 |
| Ruta | Modificar propiedades de la ruta | 0x100000 | 1048576 |
| Recurso (Cuenta) | Crear, modificar y eliminar notificaciones | 0x200000 | 2097152 |
| Recurso (Cuenta) | Crear, modificar y eliminar tareas | 0x8000000 | 134217728 |
| Recurso (Cuenta) | Crear, modificar y eliminar plantillas de informes | 0x20000000 | 536870912 |
| Recurso (Cuenta) | Crear, modificar y eliminar conductores | 0x80000000 | 2147483648 |
| Recurso (Cuenta) | Crear, modificar y eliminar pedidos | 0x400000000 | 17179869184 |
| Recurso (Cuenta) | Crear, modificar y eliminar pasajeros | 0x1000000000 | 68719476736 |
| Recurso (Cuenta) | Crear, modificar y eliminar remolques | 0x200000000000 | 35184372088832 |
Modificación de datos críticos y eliminación de mensajes
El flag de token 0x1000 (4096) concede los derechos de acceso relacionados con la modificación de datos críticos y la eliminación de mensajes.
| Se aplica a | Nombre del derecho de acceso | Bit ACL (HEX) | Bit ACL (DEC) |
|---|---|---|---|
| Cualquier objeto | Eliminar objeto | 0x8 | 8 |
| Cualquier objeto | Gestionar registros del objeto | 0x800 | 2048 |
| Cualquier objeto | Ver campos administrativos | 0x1000 | 4096 |
| Cualquier objeto | Gestionar campos administrativos | 0x2000 | 8192 |
| Unidad, grupo de unidades | Modificar propiedades de conexión (tipo de dispositivo, ID único, número de teléfono, contraseña de acceso, filtración de validez de mensajes) | 0x100000 | 1048576 |
| Unidad, grupo de unidades | Crear, modificar y eliminar sensores | 0x200000 | 2097152 |
| Unidad, grupo de unidades | Modificar contadores | 0x400000 | 4194304 |
| Unidad, grupo de unidades | Eliminar mensajes | 0x800000 | 8388608 |
| Unidad, grupo de unidades | Importar mensajes | 0x40000000 | 1073741824 |
| Unidad, grupo de unidades | Modificar estados de asuntos y gestionar comentarios | 0x10000000000 | 1099511627776 |
En Wialon Local, el derecho de acceso Modificar estados de asuntos y gestionar comentarios está disponible a partir de la versión 2504.
Envío de comandos y modificación de asuntos
El flag de token 0x2000 (8192) concede el permiso para enviar (ejecutar) comandos a unidades y grupos de unidades, así como para modificar sus asuntos.
| Se aplica a | Nombre del derecho de acceso | Bit ACL (HEX) | Bit ACL (DEC) |
|---|---|---|---|
| Unidad, grupo de unidades | Enviar comandos | 0x1000000 | 16777216 |
| Unidad, grupo de unidades | Modificar asuntos | 0x20000000000 | 2199023255552 |
En Wialon Local, el derecho de acceso Modificar asuntos está disponible a partir de la versión 2504.
Administración de códigos de activación
El flag de token 0x4000 (16384) concede el permiso para administrar los códigos de activación de unidades y grupos de unidades.
| Se aplica a | Nombre del derecho de acceso | Bit ACL (HEX) | Bit ACL (DEC) |
|---|---|---|---|
| Unidad, grupo de unidades | Administrar códigos de activación | 0x40000000000 | 4398046511104 |
El flag solo tiene efecto en los servicios con la función de códigos de activación habilitada. En otros servicios, las solicitudes que dependen de este derecho devuelven el error 7 independientemente del flag de token. Para obtener más información sobre la función, consulte Códigos de activación.
Trabajo como usuario autorizado (acceso ilimitado)
El flag de token -1 significa que el token no restringe al usuario autorizado mediante niveles de acceso de token (0x100, 0x200, 0x400, etc.). Los siguientes bits ACL solo están disponibles con este flag y no se incluyen en ningún otro flag de token.
| Se aplica a | Nombre del derecho de acceso | Bit ACL (HEX) | Bit ACL (DEC) |
|---|---|---|---|
| Cualquier objeto | Modificar objetos recursivos | 0x400 | 1024 |
| Repetidor | Agregar o eliminar unidades del repetidor, cambiar sus ID únicos | 0x200000 | 2097152 |
| Recurso (Cuenta) | Gestionar cuenta | 0x100000000 | 4294967296 |
Véase también
- token/update. Crear, modificar o eliminar tokens.
- token/login. Autenticarse mediante un token.
- core/check_items_billing. Lista completa de flags ACL por tipo de objeto.
- Preguntas frecuentes. Escenarios habituales relacionados con tokens.
- Derechos de acceso. Descripción general de los derechos de acceso en Wialon.