Black Friday tra 20 giorni: i Suoi clienti potranno pagare? -25 % il 1° anno e configurazione offerta, fino al 30 novembreVedi l’offerta →

Integrazione

Ambiti (scope) e privilegio minimo

Matrice risorsa:azione, implicazione write→read e chiavi separate per ogni uso in CI.

Ottenere la mia chiave APIContratto OpenAPI

Documento completo, senza autenticazione, da passare al Suo generatore di client.

Ambiti (scope)

Un ambito si scrive risorsa:azione. La chiave raggiunge solo gli endpoint il cui ambito figura nel suo. Fuori ambito → 403 con il nome di quello mancante.

Scrivere implica leggere: scenarios:write concede anche scenarios:read. runs:trigger è distinto da runs:read: avviare un’esecuzione consuma quota di esecuzioni.

RisorsaLetturaScrittura
Scenariscenarios:readscenarios:write
Esecuzioniruns:readruns:trigger
Incidentiincidents:readincidents:write
Webhook in uscitaalerting:readalerting:write
Finestre di manutenzionemaintenance:readmaintenance:write
Obiettivi di disponibilitàsla:readsla:write
Organizzazione, consumi, pagina di statoorg:readorg:write
Pagine di stato e badgestatus:readstatus:write
Lumi, l'assistente Flow (prova, salvataggio)assistant:runassistant:save
Membrimembers:read—

Privilegio minimo

Emetta una chiave per ogni uso. CI in sola lettura: scenarios:read + runs:read. Pipeline che crea monitor: scenarios:write. Job che avvia uno smoke post-deploy: solo runs:trigger se possibile. Webhook: alerting:write solo sul servizio che li gestisce.

Revochi la chiave appena cambia una pipeline o una postazione. Una chiave ampia dimenticata in un fork pubblico è un incidente, non una nota di backlog.

Matrice consigliata

# usage              scopes
# terraform apply    scenarios:write alerting:write maintenance:write sla:write
# terraform plan     scenarios:read  alerting:read  maintenance:read  sla:read
# smoke post-deploy  runs:trigger runs:read
# dashboard RO       scenarios:read runs:read incidents:read org:read