Seguridad

Las entidades admiten dos niveles de seguridad:

Row Level Security (RLS): Controla a qué registros pueden acceder los usuarios.
Field Level Security (FLS): Controla a qué campos dentro de los registros pueden acceder los usuarios.

El acceso con rol de servicio omite estas reglas: base44.asServiceRole omite por completo RLS y FLS, sin importar cómo esté configurada la entidad, así que no necesitas una regla de administrador equivalente para que lea o escriba un registro. Solo está disponible en funciones de backend alojadas en Base44, y tu función es responsable de cualquier comprobación de acceso que necesite.

Tipos de permiso

Cada nivel de seguridad tiene distintos permisos que puedes establecer. Para cada permiso, defines a quién se le permite realizar la acción.

Row Level Security (RLS)

create - Añade nuevos registros
read - Visualiza registros
update - Modifica registros
delete - Elimina registros

Field Level Security (FLS)

read - Visualiza el campo
write - Crea o modifica el campo

Valores de permiso

Cada permiso acepta uno de los siguientes valores:

true - Permite a todos los usuarios
false - Bloquea a todos los usuarios
{<condition>} - Permite a los usuarios que cumplan la condición

En qué se diferencian las lecturas y escrituras denegadas

Las lecturas denegadas se comportan como si los datos no existieran, así que no revelan lo que hay. Las escrituras denegadas lanzan un error, así que un cambio bloqueado nunca falla en silencio.

Operación	Cuando una regla la deniega
`list()`, `filter()`	Devuelve un resultado vacío, igual que si nada coincidiera. No se lanza ningún error.
`get()`	Lanza un error de no encontrado (HTTP 404), exista o no el registro.
`create()`, `update()`	Lanza un error de permisos (HTTP 403).

Sintaxis de la condición

Al usar {<condition>} como valor de permiso, puedes definir reglas que comprueben los atributos o roles del usuario.

Una condición que hace referencia a {{user.*}} o usa user_condition requiere un llamante autenticado. Un llamante anónimo no tiene usuario con el que comparar, así que la regla lo bloquea directamente en lugar de evaluarse como falsa.

1. Comparación entidad-usuario Compara campos del registro con los valores del usuario actual. Campos de entidad que puedes referenciar:

created_by - Email del usuario que creó el registro
created_by_id - ID del usuario que creó el registro
entity_name - Nombre del tipo de entidad
app_id - App ID
environment - prod o dev
is_sample - Si son datos de muestra
is_deleted - Flag de eliminación lógica
deleted_date - Cuándo se eliminó
data.* - Cualquier campo de las propiedades de tu esquema de entidad

Variables de plantilla para los valores del usuario:

{{user.email}} - Email del usuario
{{user.id}} - ID del usuario
{{user.role}} - Rol del usuario
{{user.data.*}} - Campos de usuario adicionales que definas

Ejemplo:

{"created_by": "{{user.email}}"}
{"data.department": "{{user.data.department}}"}
{"data.status": "approved"}

2. Comprobación de condición de usuario Comprueba las propiedades del usuario directamente usando user_condition. Campos de usuario que puedes comprobar:

email - Email del usuario
id - ID del usuario
role - Rol del usuario
data.* - Campos de usuario personalizados

Ejemplo:

{"user_condition": {"role": "admin"}}
{"user_condition": {"data.level": "senior"}}

3. Condiciones complejas Combina varias condiciones usando operadores. Operadores compatibles: $or, $and, $nor, $in, $nin, $all Ejemplo:

{
  "$or": [
    {"created_by": "{{user.email}}"},
    {"user_condition": {"role": "admin"}}
  ]
}

Ejemplo de Row Level Security (RLS)

Añade rls a nivel de entidad:

{
  "name": "task",
  "type": "object",
  "properties": {...},
  "rls": {
    "create": true,
    "read": {"created_by": "{{user.email}}"},
    "update": {"created_by": "{{user.email}}"},
    "delete": {"user_condition": {"role": "admin"}}
  }
}

Ejemplo de Field Level Security (FLS)

Añade rls a las propiedades de campos individuales:

{
  "properties": {
    "salary": {
      "type": "number",
      "rls": {
        "read": {"user_condition": {"role": "admin"}},
        "write": {"user_condition": {"role": "admin"}}
      }
    }
  }
}

Ejemplo completo con seguridad

Aquí tienes un esquema de entidad con RLS y FLS:

{
  "name": "Task",
  "type": "object",
  "title": "Task",
  "description": "A task item with priority, due date, and completion status",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "description": {
      "type": "string",
      "maxLength": 1000
    },
    "priority": {
      "type": "string",
      "enum": ["low", "medium", "high"],
      "default": "medium"
    },
    "completed": {
      "type": "boolean",
      "default": false
    },
    "due_date": {
      "type": "string",
      "format": "date"
    },
    "tags": {
      "type": "array",
      "items": {"type": "string"}
    },
    "internal_notes": {
      "type": "string",
      "rls": {
        "read": {"user_condition": {"role": "admin"}},
        "write": {"user_condition": {"role": "admin"}}
      }
    }
  },
  "required": ["title"],
  "rls": {
    "create": true,
    "read": {"created_by": "{{user.email}}"},
    "update": {"created_by": "{{user.email}}"},
    "delete": {"created_by": "{{user.email}}"}
  }
}

Desplegar reglas de seguridad

Las reglas de seguridad forman parte de tu esquema de entidad. Después de añadir o actualizar las reglas de seguridad, despliega usando entities push. Las reglas de seguridad también se despliegan automáticamente cuando ejecutas el comando deploy para desplegar todo tu proyecto.

Ver también

Resumen de entidades: Aprende sobre la configuración de esquemas de base de datos
Esquemas de entidad: Define la estructura de tus entidades
Esquema de usuario: Entidad integrada especial para la autenticación de usuarios
Acceso a datos con rol de servicio: Lee y escribe datos sin que se apliquen las reglas de acceso
Estructura del proyecto: Cómo encajan los esquemas de entidad en tu proyecto

Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la versión en inglés.

Resumen

Inicio rápido

Proyecto

Herramientas de Desarrollo con IA

Recursos

Tipos de permiso

Row Level Security (RLS)

Field Level Security (FLS)

Valores de permiso

En qué se diferencian las lecturas y escrituras denegadas

Sintaxis de la condición

Ejemplo de Row Level Security (RLS)

Ejemplo de Field Level Security (FLS)

Ejemplo completo con seguridad

Desplegar reglas de seguridad

Ver también

​Tipos de permiso

​Row Level Security (RLS)

​Field Level Security (FLS)

​Valores de permiso

​En qué se diferencian las lecturas y escrituras denegadas

​Sintaxis de la condición

​Ejemplo de Row Level Security (RLS)

​Ejemplo de Field Level Security (FLS)

​Ejemplo completo con seguridad

​Desplegar reglas de seguridad

​Ver también

Tipos de permiso

Row Level Security (RLS)

Field Level Security (FLS)

Valores de permiso

En qué se diferencian las lecturas y escrituras denegadas

Sintaxis de la condición

Ejemplo de Row Level Security (RLS)

Ejemplo de Field Level Security (FLS)

Ejemplo completo con seguridad

Desplegar reglas de seguridad

Ver también