Skip to main content
Alcuni clienti Enterprise richiedono che Devin si connetta in modo privato a sistemi interni come GitHub Enterprise Server, GitLab, Bitbucket Data Center, Artifactory, Nexus o altre infrastrutture di sviluppo. Devin Dedicated SaaS supporta questo tramite AWS PrivateLink. Questo modello mantiene tutto il traffico sul backbone di AWS ed evita l’esposizione su Internet pubblico.

​
Panoramica

PrivateLink fornisce connettività IP privata dalla tua VPC Devin Dedicated SaaS ai tuoi endpoint interni. Per abilitare questa connettività, il tuo team deve esporre un AWS VPC Endpoint Service davanti a ciascun sistema interno a cui Devin deve accedere. Cognition crea quindi degli Interface VPC Endpoint che utilizzano tale servizio. PrivateLink è configurato per singolo dominio. Se Devin deve raggiungere più domini, saranno necessari un Endpoint Service e un Interface Endpoint per ciascun dominio.

​
Requisiti

Devi fornire:
  • Un Network Load Balancer (NLB) nel tuo account AWS che faccia da front-end a ciascun servizio interno (GitLab, Artifactory, ecc.)
  • Un VPC Endpoint Service che utilizzi l’NLB come target
  • Il nome del servizio per ciascun Endpoint Service
  • Autorizzazioni per i principal autorizzati (allowed principal) che includano l’account AWS di Cognition
  • Conferma delle porte supportate per ciascun servizio
  • Informazioni DNS per i domini che Devin deve risolvere privatamente
Cognition fornirà:
  • L’ID dell’account AWS da aggiungere come principal autorizzato (allowed principal)
  • Le informazioni sul VPC di destinazione e sulla subnet per gli Interface Endpoints
  • La configurazione DNS dal lato Devin una volta che la connettività è stata stabilita
Se i tuoi servizi interni vengono eseguiti in una regione diversa rispetto al tuo tenant Cognition Dedicated SaaS, è comunque possibile utilizzare PrivateLink. AWS supporta l’utilizzo di endpoint tra regioni, a condizione che il proprietario del servizio lo abiliti.

​
Passaggi per il cliente

  1. Crea o riutilizza il Network Load Balancer L’NLB deve puntare ai sistemi interni a cui Devin deve accedere. L’NLB deve supportare tutte le porte richieste.
  2. Crea un VPC Endpoint Service dall’NLB In questo modo il servizio sarà disponibile per l’utilizzo tramite PrivateLink.
  3. Abilita il supporto cross-region Nella console AWS: 
    VPC Console → Endpoint Services → Select service → Actions → Modify supported Regions
    Aggiungi la regione in cui è distribuito il tuo tenant Cognition. Esempio CLI: 
    aws ec2 modify-vpc-endpoint-service-configuration \
    --service-id vpce-svc-0abc123 \
    --add-supported-regions us-east-1  # Regione del tuo tenant Cognition
  4. Aggiungi l’account AWS di Cognition come principal autorizzato 
    aws ec2 modify-vpc-endpoint-service-permissions \
    --service-id vpce-svc-0abc123 \
    --add-allowed-principals arn:aws:iam::<COGNITION_ACCOUNT_ID>:root
  5. Fornisci a Cognition i seguenti dettagli
    • Nome del servizio Endpoint
      Esempio: com.amazonaws.vpce.us-west-2.vpce-svc-0abc123
    • Porte accettate dal servizio
    • I domini che devono essere risolti tramite PrivateLink

​
Cosa succede dopo

Una volta forniti i dettagli di cui sopra, Cognition provvederà a:
  1. Creare Endpoint VPC di tipo Interface nella tua VPC dedicata al tenant, utilizzando i nomi dei servizi che hai fornito.
  2. Inviare una richiesta di connessione che dovrai approvare (manualmente oppure tramite accettazione automatica, se configurata).
  3. Configurare il DNS in modo che i domini specificati vengano risolti privatamente all’interno dell’ambiente Devin.

​
Diagramma dell’architettura

Architettura PrivateLink

Connettività PrivateLink inter-regionale da Cognition ai servizi interni del cliente

​
Considerazioni chiave

TopicGuidance
Required setupUn Endpoint Service per dominio, un Interface Endpoint per dominio
Cross region supportDeve essere esplicitamente abilitato sull’Endpoint Service
Allowed principalsIl cliente deve aggiungere l’ID dell’account AWS di Cognition
DNSI domini del cliente verranno risolti in IP privati degli Interface Endpoint sul lato Cognition
PortsI listener NLB devono corrispondere alle porte che Devin utilizza per accedere a ciascun servizio
AvailabilityNLB e i target sottostanti devono essere configurati in più Availability Zones
LatencyPotrebbe verificarsi un piccolo aumento della latenza inter-regionale, poiché il traffico rimane sul backbone AWS

​
Informazioni da fornire a Cognition

Quando la configurazione è pronta, invia a Cognition:
  • Nomi degli AWS Endpoint Service per ciascun dominio interno
  • Conferma che il supporto tra region è abilitato (se applicabile)
  • Che la configurazione dei principal autorizzati è completa
  • Porte esposte dall’NLB
  • L’elenco dei domini che devono essere instradati tramite PrivateLink
Cognition quindi effettuerà il provisioning degli Interface Endpoint, configurerà il DNS e confermerà la connettività.