Autorizzazioni
Updated:
Generare e gestire credenziali univoche per l'accesso tramite proxy, per ogni ordine.
Come funziona
Effettua l'ordine
POST /order/make
generateAuth=Y
Credenziali uniche emesse
Gestisci tramite /auth
Elenco · Aggiornamento · Revoca
Generare le credenziali di autenticazione al momento della creazione dell'ordine
Invia generateAuth=Y a /order/make per generare credenziali univoche associate al risultato restituito orderNumber.
Salva queste credenziali. Le autorizzazioni generate con generateAuth=Y non sono elencati da /proxy/list. Recuperali tramite il risultato restituito orderNumber.
Gestisci le autorizzazioni
Quattro operazioni relative alle credenziali associate a un ordine proxy.
Correlati
Domande frequenti
Una configurazione tipica: un unico set di credenziali di accesso e un numero limitato di indirizzi IP per l'autorizzazione.
login:password: script e client mobili con IP dinamico. Lista bianca degli IP: server con IP statico fisso. Entrambe le opzioni possono coesistere nello stesso ordine: si tratta di record di autenticazione distinti.
Le connessioni iniziano subito a non funzionare più. Chiama change-authorization con il nuovo ip per aggiornare il record senza ricrearlo. Le connessioni in corso si interrompono nel giro di pochi secondi.
Solo per quel set di credenziali. Gli altri record di autenticazione presenti nello stesso ordine continuano a funzionare.
Sì. /auth/list rendimenti login e password in chiaro per ogni autorizzazione relativa all'account, insieme a id, active e orderNumber. Per i record della whitelist IP, il ip viene restituito anche questo. Non esiste un endpoint "reveal" separato: l'elenco costituisce il meccanismo di recupero.
Se preferisci ruotare piuttosto che ripristinare, usa change-authorization per impostare una nuova password.
No — per impostazione predefinita, i nuovi ordini effettuano l'autenticazione utilizzando le credenziali condivise a livello di account. Per ottenere un login:password legato a un ordine specifico, passare generateAuth=Y a /order/make (oppure /prolong/make (in caso di rinnovi). Se il flag non è impostato, ogni ordine riutilizza la stessa coppia predefinita.
Le credenziali univoche sono associate al valore restituito orderNumber e può essere recuperato in un secondo momento tramite /auth/list. Se hai saltato generateAuth=Y e desideri aggiungere un paio specifico a un ordine esistente, utilizza /auth/add esplicitamente.
Sono supportati sia gli indirizzi IPv4 che quelli IPv6 singoli. La notazione CIDR è non supportato — elenca gli indirizzi di cui hai bisogno.
Le sessioni TCP aperte vengono interrotte nel giro di pochi secondi. Non è previsto alcun processo di chiusura graduale; considerare la cancellazione dell'autenticazione come un "kill switch" immediato.