> ## Documentation Index
> Fetch the complete documentation index at: https://tatallo-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sicurezza

> Come funziona l'accesso, che cosa è e che cosa non è un ID, e come segnalare una vulnerabilità.

## Come funziona l'accesso

Tre condizioni devono valere tutte insieme prima che il tuo PMS veda una proprietà:

```mermaid theme={"dark"}
flowchart LR
  K["La tua credenziale PMS<br/>(valida, di questo ambiente)"] --> S["Scope<br/>properties:read"]
  S --> C["La proprietà è collegata al tuo PMS<br/>dal suo host"]
  C --> P["Puoi elencarla e leggerla"]
```

1. **Credenziale PMS.** La chiave è valida, è quella attuale e appartiene all'ambiente che stai chiamando.
2. **Scope.** La chiave ha lo scope richiesto dalla route: `properties:read` per elencare e leggere le proprietà.
3. **Collegamento.** L'host della proprietà ha collegato quella proprietà al tuo PMS. Uno scope, da solo, non concede mai una proprietà.

Se fallisce la prima, ricevi `401`; se fallisce la seconda, `403`; se fallisce la terza, `404`. Una proprietà che non puoi vedere riceve esattamente la stessa risposta di una che non esiste.

## L'ID di una proprietà non è una credenziale

L'`id` di una proprietà è un identificatore. Conoscerlo non concede nulla: lo fanno solo le tre condizioni sopra. Puoi salvare e registrare gli ID liberamente, ma tratta la credenziale PMS come un segreto (vedi [Autenticazione](https://tatallo-docs.mintlify.site/it/get-started/authentication.md)).

## Minimizzazione dei dati

L'API condivide solo ciò che serve a un PMS per associare una proprietà. Vedi [Titolarità dei dati](https://tatallo-docs.mintlify.site/it/concepts/data-ownership.md) per ciò che non viene mai condiviso.

## Segnalare una vulnerabilità

Se trovi un problema di sicurezza nell'API PMS Tatallo o in questo sito, scrivi a [hello@tatallo.com](mailto:hello@tatallo.com) con **Sicurezza** nell'oggetto. Non renderlo pubblico e, mentre indaghi, non accedere a dati che non sono tuoi. Includi che cosa hai trovato, come riprodurlo e gli eventuali ID delle richieste. Tatallo conferma di aver ricevuto la segnalazione e ti tiene aggiornato fino alla correzione.

Se pensi che una delle tue chiavi sia trapelata, scrivilo nella prima riga: Tatallo la revoca subito e te ne emette una nuova.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.