Skip to main content
Gli elenchi di accesso IP consentono agli amministratori enterprise di limitare l’accesso alla piattaforma Devin da specifici indirizzi IP o intervalli CIDR. Quando viene configurato un elenco di accesso IP, solo le richieste provenienti dagli intervalli IP autorizzati possono accedere alle API e all’app web di Devin.

​
Come funziona

Quando configuri un elenco di controllo degli accessi IP, Devin lo applica a livello Enterprise:
  • Le richieste API provenienti da IP non presenti nell’elenco di accesso vengono respinte con una risposta 401 Unauthorized
  • L’accesso alla web app è limitato agli utenti che si connettono da intervalli di IP consentiti
Questo è utile per le organizzazioni Enterprise che devono garantire che Devin venga utilizzato solo da reti aziendali, endpoint VPN o altri intervalli di IP attendibili.

​
Configurazione degli elenchi di accesso IP

Gli elenchi di accesso IP sono gestiti tramite la Enterprise API v3. Sono disponibili le seguenti operazioni:

​
Visualizzare l’elenco di accesso corrente

Recupera l’elenco di accesso IP attuale per il tuo account Enterprise:
Restituisce l’elenco degli intervalli di indirizzi IP autorizzati attualmente configurati.

​
Aggiungere all’elenco di accesso IP

Aggiungi intervalli IP all’elenco di accesso esistente senza rimuovere quelli già configurati:
Il corpo della richiesta deve essere un oggetto JSON con un campo ip_ranges contenente un array di intervalli IP in notazione CIDR. I singoli indirizzi IP possono essere specificati con il suffisso /32.
I nuovi intervalli vengono uniti alla lista esistente e quelli già presenti non vengono duplicati. La risposta contiene la lista completa aggiornata degli intervalli IP consentiti. Se l’elenco di accesso è attualmente vuoto, l’aggiunta di intervalli attiva le restrizioni IP.

​
Sostituire l’elenco di accesso IP

Sostituisci l’intero elenco di accesso IP con un nuovo insieme di intervalli IP:
Il corpo della richiesta deve essere un oggetto JSON con un campo ip_ranges contenente un array di intervalli IP in notazione CIDR. I singoli indirizzi IP possono essere specificati con il suffisso /32.
L’endpoint PUT sostituisce l’intero elenco. Qualsiasi intervallo di IP non incluso nella richiesta verrà rimosso. Assicurati di includere tutti gli intervalli desiderati in ogni aggiornamento, oppure usa l’endpoint POST per aggiungere intervalli senza modificare quelli esistenti.

​
Svuotare l’elenco di accesso

Rimuovi tutte le restrizioni IP svuotando l’elenco di accesso:
Quando la lista di accesso è vuota, non viene applicata alcuna restrizione basata sull’IP.

​
Autorizzazioni

La visualizzazione e la gestione degli elenchi di accesso IP richiedono l’autorizzazione ManageIPWhitelist (“Gestisci whitelist IP”). Questa è in genere assegnata agli amministratori Enterprise e può essere concessa a un ruolo personalizzato. Tieni presente che ManageEnterpriseSettings non concede la gestione degli elenchi di accesso IP.

​
Best Practices

  • Includi tutti gli indirizzi IP di egress dell’ufficio e della VPN prima di abilitare la lista di controllo degli accessi per evitare di bloccare gli utenti
  • Usa intervalli CIDR invece di singoli IP, quando possibile, per semplificare la gestione
  • Esegui prima un test con un intervallo ampio, quindi restringilo secondo necessità
  • Tieni un registro degli intervalli configurati al di fuori di Devin nel caso in cui tu debba ripristinare l’accesso
Se ti blocchi fuori per errore a causa della configurazione errata di una lista di accesso IP, contatta support@cognition.ai per assistenza.