Chiavi, ambiti e ambienti
Le chiavi stanno nei progetti, funzionano in un solo ambiente e possono fare solo ciò che i loro ambiti consentono. Proprietari, amministratori e sviluppatori le gestiscono nella dashboard; i visualizzatori possono vederle.
Test e produzione
| Test | Produzione | |
|---|---|---|
| Prefisso della chiave | sk_test_ | sk_live_ |
| Certificato di firma | La nostra catena di test | La nostra catena di produzione |
| Quota mensile | Propria: 100 marcature nel piano Free, quante quelle di produzione nei piani a pagamento | Quella del tuo piano |
| Da usare per | Sviluppo, CI, prove delle opzioni | I file che pubblichi |
Entrambi gli ambienti eseguono lo stesso codice e gli stessi controlli. I file marcati con una chiave di test sono marcati davvero, ma firmati con la catena di test, così un verificatore li distingue.
Ambiti
Assegna a ogni chiave solo gli ambiti che le servono. Gli ambiti degli endpoint non ancora disponibili si possono già impostare.
| Ambito | Consente | Disponibile |
|---|---|---|
mark | POST /v1/mark: marcatura dei file nel cloud | Ora |
tsa | POST /v1/tsa/{key}: marche temporali per la modalità locale. Unico ambito della sua chiave, l’unico tipo di chiave ammesso in un URL | Ora |
sign | POST /v1/sign: la firma della modalità locale, per l’SDK e i nodi ComfyUI | Ora |
check | POST /v1/check: il controllo di sicurezza di un’immagine. L’opzione check di POST /v1/mark richiede solo mark | Ora |
verify | Ancora nulla: POST /v1/verify e i suoi risultati firmati non richiedono alcuna chiave | Riservato |
GET /v1/usage funziona con qualsiasi chiave valida.
Progetti
I progetti raggruppano le chiavi, ad esempio per app o per cliente. Ogni organizzazione ha un progetto Default fin dall’inizio. Eliminare un progetto ne revoca subito le chiavi; lo storico del suo utilizzo resta.
Liste di IP consentiti
Una chiave può essere limitata a intervalli IPv4 e IPv6 in notazione CIDR, come 203.0.113.0/24 o 2001:db8::/32. Un singolo indirizzo equivale a un /32 o a un /128. Fino a 100 intervalli per chiave; una lista vuota consente qualsiasi indirizzo. Le richieste da altri indirizzi ricevono 403 ip_not_allowed.
- Confrontiamo l’indirizzo da cui la tua richiesta raggiunge il nostro edge: dietro un NAT o un proxy, è il suo indirizzo pubblico di uscita.
- Un indirizzo IPv4 che arriva come IPv6 (
::ffff:192.0.2.1) corrisponde agli intervalli IPv4. - Gli intervalli vengono salvati in forma canonica: i bit dell’host vengono azzerati, quindi
10.1.2.3/8diventa10.0.0.0/8. - Ogni modifica alla lista di IP consentiti di una chiave compare nel registro di audit, con la lista prima e dopo.
Creazione e revoca
- Per creare chiavi serve un indirizzo email confermato.
- La chiave viene mostrata una sola volta, alla creazione. Ne conserviamo solo l’hash SHA-256, i primi caratteri e gli ultimi quattro.
- La dashboard mostra quando ogni chiave è stata usata l’ultima volta (dato aggiornato al massimo una volta al minuto).
- La revoca è immediata e non si può annullare.