0, -1) che portano un significato speciale.
Per il perché dietro questi campi — il modello di minima agenzia — parti da
Panoramica delle chiavi con scope. Questa pagina è
la tabella di lookup che tieni aperta mentre scripti la creazione delle chiavi.
1. Il riferimento del token object a colpo d’occhio
Una chiave appena creata per un agent di summarization schedulato appare così:Il campo
key è mascherato a ogni lettura — vedi il prefisso di brand e gli
ultimi quattro caratteri, mai il segreto completo. Il plaintext è mostrato una
volta, alla creazione. Vedi Mascheramento delle chiavi.2. Campi di identità e ciclo di vita
Questi descrivono quale chiave è questa e dove si trova nel suo ciclo di vita.id — number
id — number
L’identificatore numerico stabile della chiave. Usalo per indirizzare la
chiave nelle chiamate di update e delete. Di sola lettura.
name — string
name — string
Un’etichetta umana per la chiave, mostrata nella console e nei log. Nomina le
chiavi in base all’agent che le possiede — una chiave, un agent.
status — number
status — number
Stato abilitato / disabilitato.
1 significa attiva; una chiave disabilitata
viene rifiutata in autenticazione senza essere eliminata, così puoi mettere
in pausa una chiave e riabilitarla.key — string (mascherata)
key — string (mascherata)
Il segreto bearer, restituito mascherato (
sk-orca-…****…). Il valore
completo è mostrato solo una volta, alla creazione. Trattalo come una
password.created_time / accessed_time — number
created_time / accessed_time — number
Timestamp Unix (secondi) per quando la chiave è stata coniata e quando ha
servito l’ultima richiesta.
accessed_time è il tuo segnale per una chiave
stale o inutilizzata che vale la pena revocare.expired_time — number
expired_time — number
Scadenza assoluta come timestamp Unix. Il sentinella
-1 significa che la
chiave non scade mai. Imposta un timestamp reale per far auto-scadere una
chiave — il default giusto per esecuzioni di CI e agent effimeri. Vedi
Chiavi a scadenza.3. Campi di spesa e quota
Questi vincolano quanto una chiave può consumare prima di smettere di funzionare.| Campo | Tipo | Significato |
|---|---|---|
credit_limit_usd | number | Cap di spesa complessiva in USD. 0 = illimitata. |
unlimited_quota | boolean | Quando è true, la chiave non è messa a metro rispetto a un saldo di quota. |
remain_quota | number | Quota rimasta sulla chiave. |
used_quota | number | Quota consumata finora. |
4. Campi di reach e scope
Questi limitano cosa la chiave può raggiungere — quali modelli, da quali indirizzi.model_limits / model_limits_enabled
model_limits / model_limits_enabled
model_limits è l’elenco dei modelli che la chiave può chiamare;
model_limits_enabled è l’interruttore on/off. Con il limite abilitato, una
chiamata a qualsiasi modello fuori dall’elenco viene rifiutata prima di
lasciare il gateway — l’agent non può passare a un modello più costoso o
più capace. Vedi Limiti sui modelli.allow_ips — string
allow_ips — string
Un’allow-list di IP / CIDR, una voce per riga. Una richiesta che presenta
la chiave da qualunque indirizzo non elencato viene rifiutata al livello di
autenticazione; un valore vuoto significa che tutti gli indirizzi sono
consentiti. Vedi IP allow-list.
environment — string
environment — string
Un’etichetta di deployment a forma libera (
prod, staging, dev, o quel
che scegli) per organizzare le chiavi e filtrare i log. Puramente
organizzativa — non cambia l’applicazione. Vedi
Environment.group — string
group — string
Il gruppo di routing attraverso cui la chiave risolve i modelli. Lascialo al
default del workspace a meno che non ti sia stato assegnato un gruppo
specifico.
5. Campi di collegamento a policy
I due campi più potenti su una chiave. Ciascuno collega la chiave a una policy con scope a livello di workspace che governa il suo traffico — cambia la policy e ogni chiave ad essa collegata raccoglie la modifica alla richiesta successiva, senza redeploy.| Campo | Tipo | Collega la chiave a |
|---|---|---|
guardrail_id | number | Un guardrail sui contenuti che filtra il testo di richiesta e risposta. |
firewall_policy_id | number | Una policy del firewall che governa le chiamate a tool che la chiave emette. |
is_firewall_gateway | boolean | Marca la chiave come token con scope gateway per le rotte del Firewall MCP / evaluate (non per l’inferenza). |
Il sentinella per entrambi i collegamenti è
0 (non collegato). Ma i due
piani risolvono un collegamento disabilitato in modo diverso:- Un
guardrail_iddisabilitato è l’interruttore di spegnimento — la chiave non ottiene alcun guardrail, senza fallback al default del workspace. - Un
firewall_policy_iddisabilitato fa fallback al default del workspace della policy del firewall.
6. Impostare questi campi
Ogni campo qui sopra è configurato nell’editor delle chiavi della console (/console/token) — non attraverso una chiave di relay. Creare o modificare una
chiave richiede il ruolo Developer o superiore; il flag
is_firewall_gateway richiede Admin+.
Una chiave a minima agenzia concreta — impostata nell’editor, riletta come
l’oggetto qui sopra — limita un modello, un range di IP sorgente, un tetto
settimanale in USD, una scadenza, e un guardrail più una policy del firewall. Se
l’agent che la possiede viene dirottato via
prompt injection, il raggio d’esplosione
si ferma esattamente a quei limiti.
7. Riferimenti correlati
Panoramica chiavi con scope
Il modello di minima agenzia e l’hub per ogni campo di una chiave.
Collegare le policy
Come
guardrail_id e firewall_policy_id si risolvono in una policy attiva.Quota, cap e scadenza
credit_limit_usd, expired_time, e i campi di quota in profondità.Checklist di minima agenzia
Fai passare ogni chiave attraverso lo stesso giro di hardening.