Sicurezza
La sicurezza di un progetto si regge su quattro leve: i ruoli delle persone, le credenziali richiamate per nome e mai esposte, il minimo privilegio sulle porte e il controllo d'accesso di ogni canale.
Un valore sensibile non torna mai al browser: scriverlo lo sostituisce, nessuno può rileggerlo.
Ogni agente riceve solo le porte di cui ha bisogno.
Il login può passare dalla directory dell'azienda (Microsoft Entra ID).
Organizzazioni, ruoli e gruppi
Una persona può appartenere a più organizzazioni. In Organization → Members ogni membro ha un ruolo, dei gruppi e, se serve, un'identità Telegram collegata.
| Ruolo | Cosa può fare |
|---|---|
| user | Conversa con gli agenti consentiti e apre le app dell'organizzazione |
| fullmember | In più costruisce: progetti, codice, dati |
| admin | In più gestisce impostazioni, membri, secret e connection dell'organizzazione |
I gruppi restringono agenti, web app, bot, mailbox e librerie di skill a un sottoinsieme di membri.
Secret e connection
| Riferimento | Significato |
|---|---|
| Secret dell'organizzazione | Impostato da un amministratore in Organization → Secrets e richiamato per nome |
| Secret personale | Impostato da ogni membro dal proprio profilo; usato quando la chiamata è fatta per quel membro |
| Connection OAuth | Un'applicazione OAuth registrata una volta (Microsoft 365, Google, un CRM); il token è rinnovato dalla piattaforma |
- Una connection può essere collegata dall'amministratore per tutta l'organizzazione, oppure da ogni membro per sé.
- La tabella Secrets mostra per ogni nome lo stato, chi l'ha impostato e quale nodo lo richiede.
- Le variabili non sono credenziali: contengono stato non segreto che i nodi leggono e scrivono.
Accesso con l'identità aziendale
Organization → Identity abilita il login tramite la directory aziendale; oggi è disponibile Microsoft Entra ID. Chi ha un account nel tenant e un'email di uno dei domini configurati entra con un pulsante, senza una password TeraBrain NX.
- Tenant. L'identificativo del tenant viene verificato a ogni accesso.
- Auto Join. La persona diventa membro al primo accesso, con il ruolo indicato.
- Group Mappings. I gruppi della directory diventano ruoli ed etichette.
- Sync. Lettura periodica della directory (ogni 60 minuti di default). Remove Leavers rimuove chi non è più nei gruppi mappati, mai i membri aggiunti a mano né l'ultimo amministratore.
Minimo privilegio: la checklist
- Agenti pubblici: niente accesso completo ai database, niente scrittura sui file, niente strumenti di sviluppo, niente sandbox o macchine on-premise.
- Sulle porte che inviano all'esterno (destinatari email, numeri chiamabili, trasferimenti) usa
allowper limitare dove si può andare. - Web app con dati aziendali: accesso
organizationogroup, maipublic. - L'indirizzo del server MCP si tratta come una password; si ruota cambiando la chiave.
- Link pubblici ai file solo dove servono, con scadenza breve.
- Credenziali mai nel codice: dichiarate nei Secrets del nodo e lette a runtime.
Pagine collegate
Governance e audit
Versioni, ripristino, registro delle attività e tracciamento di ogni conversazione: sapere cosa fanno gli agenti.
Canali: come le persone raggiungono gli agenti
Web app, Telegram, mailbox, telefono, scheduler e server MCP: come si collegano e come si controlla chi può usarli.
Dati e conoscenza
Database MySQL, file storage e libreria di skill: lo stato persistente di agenti e codice.
Hai un agente da portare in produzione?Parliamone.
Ti mostriamo TeraBrain NX sul tuo caso: sistemi da collegare, accessi e controlli.