IP statico per allowlist API: un IPv4 fisso di cui i tuoi partner possono fidarsi

Perché le API e i firewall chiedono un IP statico?

Le API e i firewall chiedono un IP statico perché un indirizzo di origine noto è un semplice secondo controllo oltre a una chiave o una password. Se una chiave trapela, una richiesta da un indirizzo sconosciuto viene comunque rifiutata.

Luoghi comuni che usano un'allowlist IP:

• API di partner e fornitori: logistica, inventario, cataloghi all'ingrosso e feed di dati.
• Dashboard B2B che accettano login solo dagli indirizzi registrati di un cliente.
• Firewall cloud e security group che aprono SSH, una porta database o un pannello di amministrazione agli IP in elenco.
• Server di staging e anteprima che non dovrebbero essere pubblici.
• Console di amministrazione SaaS con un'impostazione opzionale "IP attendibili".

Le connessioni domestiche e d'ufficio cambiano spesso indirizzo, e le funzioni cloud o i runner CI usano intervalli condivisi e variabili. Un IP noleggiato dà a tutti loro un'unica uscita stabile.

Quali due allowlist sono coinvolte?

In questa configurazione si incontrano due allowlist diverse, e confonderle è la domanda di assistenza più comune.

Se le tue macchine hanno indirizzi variabili, salta l'allowlist proxy e usa invece nome utente e password. Nome utente e password, oppure una allowlist IP (fino a 10 IP).

Come posso instradare le chiamate API attraverso l'IP statico?

Instrada le chiamate API attraverso l'IP statico impostandolo come proxy HTTP(S) o SOCKS5 del client che chiama l'API. La maggior parte delle librerie HTTP, curl e molti strumenti leggono un'impostazione proxy o la variabile d'ambiente HTTPS_PROXY. Prima conferma l'indirizzo di uscita con un servizio echo pubblico, poi chiama l'API del partner. Gli indirizzi qui sotto sono esempi di documentazione; il tuo IP, la porta e le credenziali reali sono nel tuo account.

# 1. The address the partner will see
curl -x http://USERNAME:[email protected]:8000 https://api.ipify.org

# 2. Same proxy for every tool in this shell
export HTTPS_PROXY=http://USERNAME:[email protected]:8000
curl -H "Authorization: Bearer $PARTNER_TOKEN" https://example.com/api/v1/orders

Cosa succede alla allowlist quando termina il noleggio?

La allowlist continua a funzionare finché mantieni lo stesso IP, quindi rinnova prima della data di scadenza. Ogni noleggio dura 30 giorni dalla consegna. Rinnova dal tuo account prima della data di scadenza; mantenere gli stessi IP dopo la fine di un noleggio non è garantito.

Una procedura sicura per l'accesso in allowlist:

1. Noleggia due IP, non uno. Comunica entrambi gli indirizzi al partner. Se uno deve essere sostituito, l'altro mantiene l'integrazione attiva.
2. Annota la data di scadenza mostrata accanto a ogni IP nel tuo account e rinnova qualche giorno prima.
3. Tieni a portata di mano la procedura di modifica del partner. Sappi chi aggiorna la loro allowlist e quanto tempo richiede.
4. Testa dopo ogni rinnovo con la chiamata echo qui sopra.

Se un IP non funziona o è inutilizzabile per un uso lecito, scrivi al supporto: lo sistemiamo o lo sostituiamo con un IP nello stesso paese, in base alla disponibilità. Un IP sostitutivo è un nuovo indirizzo, quindi richiede una nuova voce nella allowlist.

Quando un IP proxy noleggiato è la scelta sbagliata?

Un IP proxy noleggiato è la scelta sbagliata quando il servizio che vuoi raggiungere è nella nostra lista di blocco o richiede un indirizzo permanente. I siti bancari, governativi e dei portali di pagamento sono bloccati su ogni IP, quindi le allowlist delle API bancarie e di pagamento non sono un uso che supportiamo.

Valuta anche altre opzioni quando:

• Gestisci i tuoi server nel cloud: un indirizzo statico del tuo provider cloud, collegato al tuo NAT gateway, mantiene il traffico dentro la tua infrastruttura.
• Ti serve IPv6: Solo IPv4. I proxy IPv6 non sono ancora in vendita.
• Ti serve lo stesso indirizzo per anni: un noleggio di 30 giorni è rinnovabile, ma non è un'assegnazione di indirizzo di tua proprietà.