Salta ai contenuti
Apri Entergram

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.


Create key: emetti una chiave legata allo spazio di lavoro, con scope espliciti e una data di scadenza fissa.

CampoNote
Key nameAd esempio Zapier CRM bridge. Obbligatorio
ScopesConcedi solo l’accesso minimo necessario per questa integrazione. Almeno uno
Expiry dateTutte le chiavi devono scadere. Finestra consigliata: da 30 a 90 giorni
IP allowlistFacoltativa. Un IP o un CIDR per riga, oppure separati da virgole, ad esempio 203.0.113.10, 198.51.100.0/24

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.


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”.


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
ScopesCosa può fare
Created / Created byProvenienza
ExpiresScadenza tassativa
Last usedNever fino al primo utilizzo
UsageAttività delle richieste
Source IPDa dove sono arrivate le chiamate
User agentNo requests yet fino al primo utilizzo
IP allowlistOppure No IP restrictions configured for this key
AzioneEffetto
Copy keySolo 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)
DocsApre il riferimento dell’API

Gli eventi del ciclo di vita delle chiavi sono registrati: Public API key created / rotated / revoked compaiono in Log history.


La rotazione revoca la vecchia chiave nel momento in cui viene emessa quella nuova, quindi pianificala:

  1. Crea una seconda chiave con gli stessi scope.
  2. Distribuisci la nuova chiave nella tua integrazione.
  3. Verifica il traffico sulla nuova chiave tramite Last used / Usage.
  4. 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.


  • 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.

MessaggioSignificato
PRO access requiredPassa lo spazio di lavoro a Pro
Admin access requiredNon sei proprietario né amministratore
Public API key management is temporarily unavailableProblema temporaneo, riprova tra poco
Public API hashing not configuredProblema di configurazione lato server, contatta il supporto
Public API storage not readyÈ in sospeso una migrazione del database, contatta il supporto