Vai al contenuto principale

​
Panoramica

Questa pagina spiega autenticazione, autorizzazioni, scadenza e conservazione delle chiavi Developer Platform. Ogni chiave appartiene a un progetto e consente solo le operazioni autorizzate.

​
Usare una chiave Developer Platform

Invia questo header Authorization con ogni richiesta.
Le chiavi delle impostazioni ordinarie del team usano spazi di lavoro, relative autorizzazioni e crediti NoimosAI. Le chiavi Developer Platform usano progetti, autorizzazioni e saldi prepagati in USD separati.
Le chiavi non sono intercambiabili. Chiavi non valide, autorizzazioni o saldo insufficienti non provocano cambi automatici di autenticazione o fatturazione.

​
Impostare le autorizzazioni

Alla creazione seleziona le autorizzazioni necessarie. Separa le chiavi di verifica connessione da quelle di esecuzione a pagamento per limitare errori. Verifica tutti i permessi per progetto, preventivo, esecuzione e risultati.

​
Chi può creare chiavi

I membri ADMIN o DEVELOPER del progetto possono crearle. Anche gli amministratori dell’organizzazione devono appartenere esplicitamente al progetto per accedervi. Valgono le autorizzazioni del creatore e del progetto. La chiave smette di funzionare se il creatore viene disattivato o rimosso dal progetto, oppure se la chiave viene revocata.

​
Gestire la scadenza

Scegli la scadenza nella schermata di creazione della chiave di Developer Platform e verificala nell’elenco dopo la creazione. La chiave completa appare una sola volta: salvala in sicurezza prima di chiudere la schermata. Prima della scadenza crea una nuova chiave, aggiorna gli utilizzi e revoca la vecchia. Revoca subito in caso di possibile divulgazione.

​
Conservare le chiavi in sicurezza

Tratta le chiavi come segreti del server, mai distribuiti ai browser degli utenti.
  • Usa variabili d’ambiente o un gestore di segreti.
  • Non registrarle in Git, log, schermate di errore o eventi analitici.
  • Non incorporarle in app web o mobili.
  • Separa chiavi e progetti per produzione, collaudo e sviluppo.
  • Crea chiavi per uso con i soli permessi necessari.

​
Risolvere errori di autenticazione

Verifica lo stato HTTP e quello della chiave.
  • 401 — Verifica Authorization, chiave completa, scadenza e revoca.
  • 403 — Verifica permessi richiesti e accesso del proprietario al progetto.
  • 429 — Verifica limiti richieste, saldo e tetti mensili di organizzazione o progetto.
Se non sai se chiave ed endpoint corrispondono, usa GET /tools/project prima di inviare attività a pagamento.

​
Pagine correlate

Queste pagine spiegano creazione delle chiavi e specifiche comuni.