Permisos
La mayoría de los permisos utiliza estructuras de tres elementos entity:action:scope. Las acciones incluyen list, read, edit y delete. Los ámbitos suelen diferenciar el acceso all del acceso assigned para entidades grandes, como clientes o tours.
En las organizaciones modulares, los módulos de suscripción requeridos se comprueban además de estos permisos del rol. Un rol puede permitir una acción mientras el módulo no está disponible, y un módulo activo no concede una capacidad del rol que falte. Consulta Suscripción.
La administración de la organización también se expresa mediante la entidad admin: los roles que pueden gestionar organizaciones secundarias, roles y herramientas similares de jerarquía incluyen permisos admin, como admin:list:all, admin:read:all y combinaciones relacionadas de admin:*. Las comprobaciones del servidor para determinar si una persona es «administradora de la organización» pueden considerar suficiente, en determinadas rutas, cualquier cadena de permiso que comience por admin:. Usa siempre el editor de roles del panel como fuente de verdad para un espacio de trabajo.
Las entidades principales compatibles con list incluyen customer, tour, landing-page, event, experience, newsletter, project, document, contactform, siteplan, place y admin. Las subentidades, como protocol, email y task, omiten intencionadamente list porque la visibilidad se infiere mediante las relaciones.
Los casos especiales, como las asignaciones mixtas o los accesos directos para operadores de la plataforma, se resuelven dentro del producto. Usa el editor de roles del panel como fuente de verdad para un espacio de trabajo determinado.
Formato de los permisos
entity:action:scope
| Parte | Significado | Ejemplo |
|---|---|---|
entity | Tipo de recurso que se controla. | customer, tour, event, admin |
action | Operación que puede realizar el rol. | list, read, edit, delete |
scope | Amplitud del acceso. | assigned, all, off |
Acciones
| Acción | Significado |
|---|---|
list | Ver registros en vistas de lista para entidades compatibles con listados. |
read | Abrir o consultar los detalles de un registro. |
edit | Crear o actualizar registros. |
delete | Eliminar registros cuando esté permitido. |
edit incluye derechos de creación en el modelo de permisos, por lo que los botones de creación suelen depender del permiso de edición en lugar de un permiso de creación independiente.
Ámbitos
| Ámbito | Significado |
|---|---|
assigned | Acceder a los registros conectados con la persona usuaria mediante reglas de asignación o relación. |
all | Acceder a todos los registros de esa entidad dentro de la organización. |
off | Sin acceso explícito, salvo el acceso especial propio o las reglas de relación aplicadas por el producto. |
El comportamiento de solo asignados puede variar según la entidad. Por ejemplo, los clientes pueden tener personas usuarias responsables, mientras que las tareas, los correos electrónicos y los protocolos pueden ser visibles mediante la asignación del cliente o una asignación directa.
Grupos de entidades
Las entidades principales admiten acceso en formato de lista:
customertourlanding-pageeventexperiencenewsletterprojectdocumentcontactformsiteplanplaceadmin
Las subentidades no utilizan intencionadamente list:
protocolemailtask
Normalmente, se accede a estas subentidades mediante relaciones con clientes o proyectos, o mediante asignaciones directas.
Visibilidad del panel
La barra lateral utiliza los permisos para decidir qué grupos y rutas se muestran. Si una persona usuaria no puede ver una página, comprueba primero el permiso de la entidad:
- Gestión de clientes:
customer,protocol,task,project,document,newsletter,email,event. - Aplicaciones web y recorridos:
landing-page,tour,experience,contactform,siteplan(en las configuraciones habituales, los planes del sitio y las preguntas están condicionados por la visibilidad de la página de destino). - Jerarquía de configuración: permisos de entidad
admin(organizaciones secundarias y roles). - Configuración de eventos:
event.
Galería, dentro de Aplicaciones web y recorridos, se muestra de forma más amplia que algunos elementos cercanos; las reglas exactas pueden variar según la implementación. Si falta un enlace, confirma el contexto de la página de destino, el recorrido y la organización en lugar de asumir que hay un error de compilación.
Las personas operadoras de la plataforma pueden ver rutas adicionales que las personas usuarias del entorno nunca encuentran.
Experiencias y comercio de guías
El catálogo unificado utiliza los permisos de experience:*. Los permisos históricos exclusivos para ofertas no conceden acceso a las experiencias. Comprueba las capacidades de experiencia del rol activo cuando falte un producto migrado o su página de reserva.
Crear un producto de guía vinculado también requiere acceso al tour o al plan diario, así como permiso para editarlo. La administración de la plataforma debe habilitar el comercio de guías para la organización. La administración de la organización es necesaria para gestionar hosts y emitir reembolsos directos completos; la administración de la plataforma es necesaria para la conexión central con Bókun y las correspondencias de proveedores. Los hosts vinculados pueden acceder a sus propios manifiestos de salida sin obtener acceso a las reservas ni a la información financiera de toda la organización.
Conceptos relacionados: Permisos y organizaciones, Organizaciones secundarias y roles.