Sicurezza

Le entità supportano due livelli di sicurezza:

Sicurezza a livello di riga (RLS): controlla a quali record gli utenti possono accedere.
Sicurezza a livello di campo (FLS): controlla a quali campi all’interno dei record gli utenti possono accedere.

L’accesso con service role ignora queste regole: base44.asServiceRole aggira completamente sia RLS sia FLS, a prescindere da come è configurata l’entità. Non ti serve quindi una regola admin corrispondente per leggere o scrivere un record. È disponibile solo nelle funzioni backend ospitate da Base44 e la tua funzione è responsabile degli eventuali controlli di accesso necessari.

Tipi di permesso

Ogni livello di sicurezza ha permessi diversi che puoi impostare. Per ogni permesso, definisci chi è autorizzato a eseguire l’azione.

Sicurezza a livello di riga (RLS)

create - aggiungere nuovi record
read - visualizzare i record
update - modificare i record
delete - rimuovere i record

Sicurezza a livello di campo (FLS)

read - visualizzare il campo
write - creare o modificare il campo

Valori dei permessi

Ogni permesso accetta uno dei seguenti valori:

true - consente a tutti gli utenti
false - blocca tutti gli utenti
{<condition>} - consente agli utenti che corrispondono alla condizione

Differenze tra letture e scritture negate

Le letture negate si comportano come se i dati non esistessero, quindi non rivelano cosa c’è. Le scritture negate generano un errore, quindi una modifica bloccata non fallisce mai in silenzio.

Operazione	Quando una regola la nega
`list()`, `filter()`	Restituisce un risultato vuoto, come se nulla corrispondesse. Non viene generato alcun errore.
`get()`	Genera un errore not-found (HTTP 404), che il record esista o meno.
`create()`, `update()`	Genera un errore di permesso (HTTP 403).

Sintassi delle condizioni

Quando usi {<condition>} come valore di permesso, puoi definire regole che verificano attributi o ruoli dell’utente.

Una condizione che fa riferimento a {{user.*}} o usa user_condition richiede un chiamante autenticato. Un chiamante anonimo non ha un utente con cui fare il confronto, quindi la regola lo blocca direttamente invece di valutarsi come falsa.

1. Confronto entità-utente Confronta i campi del record con i valori dell’utente corrente. Campi dell’entità che puoi referenziare:

created_by - email dell’utente che ha creato il record
created_by_id - ID dell’utente che ha creato il record
entity_name - nome del tipo di entità
app_id - ID dell’app
environment - prod oppure dev
is_sample - se si tratta di dati di esempio
is_deleted - flag di eliminazione soft
deleted_date - quando è stato eliminato
data.* - qualsiasi campo dalle proprietà del tuo schema entità

Variabili template per i valori utente:

{{user.email}} - email dell’utente
{{user.id}} - ID dell’utente
{{user.role}} - ruolo dell’utente
{{user.data.*}} - campi utente aggiuntivi che definisci

Esempio:

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

2. Verifica delle condizioni utente Verifica direttamente le proprietà dell’utente usando user_condition. Campi utente che puoi verificare:

email - email dell’utente
id - ID dell’utente
role - ruolo dell’utente
data.* - campi utente personalizzati

Esempio:

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

3. Condizioni complesse Combina più condizioni usando gli operatori. Operatori supportati: $or, $and, $nor, $in, $nin, $all Esempio:

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

Esempio di sicurezza a livello di riga (RLS)

Aggiungi rls a livello di entità:

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

Esempio di sicurezza a livello di campo (FLS)

Aggiungi rls alle singole proprietà dei campi:

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

Esempio completo con sicurezza

Ecco uno schema di entità con sia RLS che 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}}"}
  }
}

Distribuire le regole di sicurezza

Le regole di sicurezza fanno parte del tuo schema di entità. Dopo aver aggiunto o aggiornato le regole di sicurezza, distribuisci usando entities push. Le regole di sicurezza vengono anche distribuite automaticamente quando esegui il comando deploy per distribuire l’intero progetto.

Vedi anche

Panoramica delle entità: scopri la configurazione dello schema del database
Schemi delle entità: definisci la struttura delle tue entità
Schema utente: entità integrata speciale per l’autenticazione degli utenti
Accesso ai dati con service role: leggi e scrivi dati senza che si applichino le regole di accesso
Struttura del progetto: come gli schemi delle entità si inseriscono nel tuo progetto

Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.

Panoramica

Guida rapida

Progetto

Strumenti di sviluppo con IA

Risorse

Tipi di permesso

Sicurezza a livello di riga (RLS)

Sicurezza a livello di campo (FLS)

Valori dei permessi

Differenze tra letture e scritture negate

Sintassi delle condizioni

Esempio di sicurezza a livello di riga (RLS)

Esempio di sicurezza a livello di campo (FLS)

Esempio completo con sicurezza

Distribuire le regole di sicurezza

Vedi anche

​Tipi di permesso

​Sicurezza a livello di riga (RLS)

​Sicurezza a livello di campo (FLS)

​Valori dei permessi

​Differenze tra letture e scritture negate

​Sintassi delle condizioni

​Esempio di sicurezza a livello di riga (RLS)

​Esempio di sicurezza a livello di campo (FLS)

​Esempio completo con sicurezza

​Distribuire le regole di sicurezza

​Vedi anche

Tipi di permesso

Sicurezza a livello di riga (RLS)

Sicurezza a livello di campo (FLS)

Valori dei permessi

Differenze tra letture e scritture negate

Sintassi delle condizioni

Esempio di sicurezza a livello di riga (RLS)

Esempio di sicurezza a livello di campo (FLS)

Esempio completo con sicurezza

Distribuire le regole di sicurezza

Vedi anche