Chiavi API pubbliche
Settings → Developers → API: crea e gestisci chiavi API legate allo spazio di lavoro per le integrazioni esterne.
Usa una chiave API quando l’integrazione non è un client MCP: un ponte con Zapier, un servizio interno, un job di reportistica.
PRO access required: passa questo spazio di lavoro a Pro prima di emettere chiavi API pubbliche. Admin access required: solo i proprietari e gli amministratori dello spazio di lavoro possono creare o gestire le chiavi.
Creare una chiave
Sezione intitolata “Creare una chiave”Create key: emetti una chiave legata allo spazio di lavoro, con scope espliciti e una data di scadenza fissa.
| Campo | Note |
|---|---|
| Key name | Ad esempio Zapier CRM bridge. Obbligatorio |
| Scopes | Concedi solo l’accesso minimo necessario per questa integrazione. Almeno uno |
| Expiry date | Tutte le chiavi devono scadere. Finestra consigliata: da 30 a 90 giorni |
| IP allowlist | Facoltativa. Un IP o un CIDR per riga, oppure separati da virgole, ad esempio 203.0.113.10, 198.51.100.0/24 |
Scope disponibili
Sezione intitolata “Scope disponibili”Workspace access · Members access · Accounts access · Contacts access · Chats access / Chats write · Custom fields read / write · Messages read / Messages write · Tickets read / Tickets write.
Messages write invia messaggi Telegram a nome dei tuoi account. Concedilo solo quando l’integrazione deve davvero inviare messaggi.
Conservare la chiave
Sezione intitolata “Conservare la chiave”La chiave in chiaro viene mostrata una sola volta:
Store this API key now: la chiave in chiaro viene mostrata una sola volta. Dopo aver chiuso questa finestra resterà visibile solo il prefisso. Salva la chiave nel tuo password manager o secret manager prima di chiudere la finestra.
Entergram conserva solo un hash della chiave. Non esiste un “mostra di nuovo la chiave”.
Gestire le chiavi
Sezione intitolata “Gestire le chiavi”L’elenco mostra Active keys e Total keys, con lo stato Active, Expired o
Revoked. Show archived ({n}) mostra le chiavi ritirate.
Per ogni chiave:
| Campo | |
|---|---|
| Scopes | Cosa può fare |
| Created / Created by | Provenienza |
| Expires | Scadenza tassativa |
| Last used | Never fino al primo utilizzo |
| Usage | Attività delle richieste |
| Source IP | Da dove sono arrivate le chiamate |
| User agent | No requests yet fino al primo utilizzo |
| IP allowlist | Oppure No IP restrictions configured for this key |
| Azione | Effetto |
|---|---|
| Copy key | Solo finché la finestra a visualizzazione unica è aperta |
| Rotate | ”The current key will be revoked and replaced with a newly generated key.” (la chiave attuale viene revocata e sostituita da una nuova) |
| Revoke | ”This key will stop working immediately for all clients using it.” (la chiave smette subito di funzionare per tutti i client che la usano) |
| Docs | Apre il riferimento dell’API |
Gli eventi del ciclo di vita delle chiavi sono registrati: Public API key created / rotated / revoked compaiono in Log history.
Rotazione senza interruzioni
Sezione intitolata “Rotazione senza interruzioni”La rotazione revoca la vecchia chiave nel momento in cui viene emessa quella nuova, quindi pianificala:
- Crea una seconda chiave con gli stessi scope.
- Distribuisci la nuova chiave nella tua integrazione.
- Verifica il traffico sulla nuova chiave tramite Last used / Usage.
- Revoke la vecchia chiave.
Usare due chiavi e revocare quella superata è meglio che ruotare una chiave in uso e fare a gara con il deploy.
Buone pratiche
Sezione intitolata “Buone pratiche”- Una chiave per integrazione. Con chiavi condivise non puoi revocarne una senza rompere altre tre cose.
- Scadenza di 30-90 giorni, come consiglia l’app. Lo scopo è proprio forzare la rotazione.
- Imposta sempre una allowlist IP quando il chiamante ha un IP stabile. Trasforma una chiave trapelata da disastro a semplice fastidio.
- Dai alle chiavi il nome dei sistemi, non delle persone.
- Controlla Last used prima di rinnovare. Una chiave che nessuno usa è solo un rischio.
Risoluzione dei problemi
Sezione intitolata “Risoluzione dei problemi”| Messaggio | Significato |
|---|---|
| PRO access required | Passa lo spazio di lavoro a Pro |
| Admin access required | Non sei proprietario né amministratore |
| Public API key management is temporarily unavailable | Problema temporaneo, riprova tra poco |
| Public API hashing not configured | Problema di configurazione lato server, contatta il supporto |
| Public API storage not ready | È in sospeso una migrazione del database, contatta il supporto |
Articoli correlati
Sezione intitolata “Articoli correlati”- Connettori MCP, per i client AI
- Checklist della privacy
Preferenze dei cookie
Rispettiamo il tuo diritto alla privacy. Scegli quali cookie consentire, la tua scelta vale su tutto il sito. Informativa sui cookie
Indispensabili al funzionamento del sito, incluso il ricordo delle tue scelte sulla privacy. Sempre attivi.
Ci aiutano a capire l'uso del sito e ad attribuire le registrazioni ai partner di referral. Facoltativi.