Proxy-seller

Autorizzazioni

Updated:

Generare e gestire credenziali uniche per l'accesso proxy, per ogni ordine.

Come funziona

  1. Effettuare l'ordine

    POST /ordine/realizzazione

  2. generateAuth=Y

    Credenziali uniche rilasciate

  3. Gestione tramite /auth

    Elenco - aggiornamento - revoca

Generare l'autorizzazione alla creazione dell'ordine

InviaregenerateAuth=Y a/order/make per rilasciare credenziali univoche legate all'oggetto restituitoorderNumber.

POST/it-IT/order/make?generateAuth=Y

Memorizzare queste credenziali. Le credenziali generate congenerateAuth=Y non sono elencati da/proxy/list. Recuperarli tramite il file restituitoorderNumber.

Gestire le autorizzazioni

Quattro operazioni per le credenziali legate a un ordine proxy.

GET/auth
Elenco autorizzazioni
Quali coppie di login/password o IP whitelistati hanno accesso.
Use when: auditing all data tied to a client email.
POST/auth
Creare l'autorizzazione
Emettere cred personalizzati o casuali per ogni nuovo ordine.
Use when: onboarding a team member or sub-user.
PATCH/auth/{id}
Autorizzazione alla modifica
Modificare i diritti di accesso esistenti per un utente.
Use when: leak suspected or scope needs tightening.
DELETE/auth/{id}
Cancellare l'autorizzazione
Rimuovere le autorizzazioni non più necessarie.
Use when: access period expires.

Correlato

GET/it-IT/proxy/list - find the orderNumber
POST/it-IT/order/make - place a new proxy order

FAQ

Una configurazione tipica: un set di login e password e un numero limitato di indirizzi IP per l'autorizzazione.

login:password: script e client mobili con IP dinamico. IP whitelist: server con IP statico stabile. Entrambi possono coesistere nello stesso ordine: sono record di autenticazione separati.

Le connessioni iniziano a fallire immediatamente. Chiamatachange-authorization con il nuovoip per aggiornare il record senza ricrearlo. Le connessioni in volo si interrompono in pochi secondi.

Solo per quel set di credenziali. Gli altri record di autenticazione dello stesso ordine continuano a funzionare.

Sì./auth/list ritornilogin epassword in chiaro per ogni autorizzazione sul conto, oltre aid,active eorderNumber. Per i record di IP-whitelist il parametroip viene anch'esso restituito. Non esiste un endpoint "reveal" separato: l'elenco è il meccanismo di recupero.

Se si preferisce ruotare piuttosto che recuperare, si può usare il metodochange-authorization per impostare una nuova password.

No, per impostazione predefinita i nuovi ordini si autenticano con le credenziali condivise a livello di account. Per ottenere un codice univocologin:password vincolato a un ordine specifico, passaregenerateAuth=Y a/order/make (o/prolong/make per i rinnovi). Senza il flag, ogni ordine riutilizza la stessa coppia predefinita.

Le credenziali univoche sono legate al file restituitoorderNumber e può essere recuperato in seguito tramite/auth/list. Se avete saltatogenerateAuth=Y e si vuole aggiungere una coppia unica a un ordine esistente, usare/auth/add esplicitamente.

Sono supportati indirizzi IPv4 e IPv6 singoli. La notazione CIDR ènon supportati - enumerare gli indirizzi necessari.

Le sessioni TCP aperte vengono abbandonate entro pochi secondi. Non c'è graceful drain; trattate l'eliminazione dell'autenticazione come un kill switch immediato.

On this page

Come funziona
1
Effettuare l'ordine
2
generateAuth=Y
3
Gestione tramite /auth
Generare l'autorizzazione alla creazione dell'ordine
Gestire le autorizzazioni
Correlato
FAQ