> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dediziertes Deployment-Private Networking

Einige Unternehmenskunden benötigen, dass Devin privat eine Verbindung zu internen Systemen wie GitHub Enterprise Server, GitLab, Bitbucket Data Center, Artifactory, Nexus oder anderer Entwickler-Infrastruktur herstellt.

Devin's Dediziertes Deployment unterstützt dies über AWS PrivateLink. Dieses Modell hält den gesamten Datenverkehr im AWS-Backbone und vermeidet eine Exponierung im öffentlichen Internet.

<div id="overview">
  ## Übersicht
</div>

PrivateLink stellt eine private IP-Verbindung von Ihrer Devin Dediziertes Deployment-Umgebung zu Ihren internen Endpunkten her. Damit dies möglich ist, richtet Ihr Team vor jedem internen System, das Devin erreichen muss, einen AWS VPC Endpoint Service ein. Cognition erstellt anschließend Interface-VPC-Endpunkte, die diesen Service nutzen.
PrivateLink wird pro Domäne konfiguriert. Wenn Devin mehrere Domänen erreichen muss, benötigen Sie für jede Domäne einen Endpoint Service und einen Interface Endpoint.

<div id="requirements">
  ## Anforderungen
</div>

Sie müssen Folgendes bereitstellen:

* Einen Network Load Balancer (NLB) in Ihrem AWS-Account, der jedem internen Dienst (GitLab, Artifactory usw.) vorgeschaltet ist
* Einen VPC-Endpunkt-Service, der den NLB als Ziel verwendet
* Den Servicenamen für jeden Endpunkt-Service
* Berechtigungen für zulässige Principals, die das Cognition-AWS-Konto einschließen
* Eine Bestätigung der unterstützten Ports für jeden Dienst
* DNS-Informationen für die Domains, die Devin privat auflösen muss

Cognition stellt Folgendes bereit:

* Die AWS-Account-ID, die als zulässiger Principal hinzugefügt werden soll
* Die DNS-Konfiguration auf Devin-Seite, sobald die Konnektivität hergestellt ist

<div id="cross-region-privatelink-if-your-services-are-in-a-different-region">
  ## Regionsübergreifendes PrivateLink (wenn Ihre Services in einer anderen Region sind)
</div>

Wenn Ihre internen Services in einer anderen Region laufen als Ihr Cognition Dediziertes Deployment-Mandant, kann PrivateLink trotzdem verwendet werden. AWS unterstützt die regionsübergreifende Nutzung von Endpoints, sofern der Service-Owner sie aktiviert.

<div id="customer-steps">
  ### Schritte für Kund:innen
</div>

1. **Network Load Balancer erstellen oder wiederverwenden**
   Der NLB sollte auf die internen Systeme ausgerichtet sein, auf die Devin zugreifen muss. Der NLB muss alle erforderlichen Ports unterstützen.

2. **Einen VPC Endpoint Service aus dem NLB erstellen**
   Dadurch wird der Service für die Nutzung über PrivateLink verfügbar gemacht.

3. **Regionsübergreifende Unterstützung aktivieren**
   In der AWS-Konsole:

   ```
   VPC Console → Endpoint Services → Select service → Actions → Modify supported Regions
   ```

   Fügen Sie die Region hinzu, in der Ihr Cognition-Mandant bereitgestellt ist.
   CLI-Beispiel:

   ```bash theme={null}
   aws ec2 modify-vpc-endpoint-service-configuration \
       --service-id vpce-svc-0abc123 \
       --add-supported-regions us-west-2  # Region Ihres Cognition-Mandanten
   ```

4. **Das AWS-Konto von Cognition als zulässigen Principal hinzufügen**
   ```bash theme={null}
   aws ec2 modify-vpc-endpoint-service-permissions \
       --service-id vpce-svc-0abc123 \
       --add-allowed-principals arn:aws:iam::<COGNITION_ACCOUNT_ID>:root
   ```

5. **Folgende Details an Cognition übermitteln**
   * Endpoint-Service-Name\
     Beispiel: `com.amazonaws.vpce.us-west-2.vpce-svc-0abc123`
   * Ports, die der Service akzeptiert
   * Die Domains, die über PrivateLink aufgelöst werden sollen

<div id="what-happens-next">
  ### Wie es weitergeht
</div>

Sobald Sie die oben genannten Details angegeben haben, wird Cognition Folgendes vornehmen:

1. **Interface-VPC-Endpunkte erstellen** in Ihrer dedizierten Mandantenumgebung unter Verwendung der von Ihnen angegebenen Servicenamen.
2. **Eine Verbindungsanfrage senden**, die Sie genehmigen müssen (entweder manuell oder per automatischer Annahme, falls konfiguriert).
3. **DNS konfigurieren**, damit Ihre angegebenen Domains innerhalb der Devin-Umgebung privat aufgelöst werden.

<div id="architecture-diagram">
  ## Architekturdiagramm
</div>

<Frame caption="Cross-Region-PrivateLink-Konnektivität von Cognition zu internen Diensten des Kunden">
  <img src="https://mintcdn.com/cognitionai-enterprise/G1KUV0opl7B4FiVt/images/privatelink-architecture.svg?fit=max&auto=format&n=G1KUV0opl7B4FiVt&q=85&s=17d8611558974f3c70f9c100feaea8b7" alt="PrivateLink-Architektur" width="900" height="480" data-path="images/privatelink-architecture.svg" />
</Frame>

<div id="gateway-load-balancer-gwlb-support">
  ## Unterstützung für Gateway Load Balancer (GWLB)
</div>

Wenn Ihre Organisation eine Sicherheits-Appliance wie Zscaler zur Inspektion des Datenverkehrs verwendet, können Sie einen AWS Gateway Load Balancer (GWLB) anstelle eines Network Load Balancer verwenden. Dadurch wird der von Devin erzeugte Datenverkehr vor dem Erreichen Ihrer internen Services zur Inspektion durch Ihre Sicherheits-Appliance geleitet.

In diesem Modell:

* Ein **Gateway Load Balancer** steht vor Ihrer Sicherheits-Appliance (z. B. Zscaler)
* Ein **Gateway Load Balancer Endpoint** wird in der Devin-Umgebung erstellt, um den Datenverkehr durch die Appliance zu routen
* Der Datenverkehr wird von Ihrer Sicherheits-Appliance inspiziert und anschließend an den internen Zielservice weitergeleitet

Um diese Option zu nutzen, stellen Sie Cognition Folgendes zur Verfügung:

* Den Namen des GWLB Endpoint Service
* Den Anbieter der Sicherheits-Appliance und Konfigurationsdetails
* Die Domains, die über den GWLB geroutet werden sollen

<Note>
  GWLB-basierte Setups folgen denselben PrivateLink-Prinzipien wie NLB-basierte Setups, fügen jedoch eine zusätzliche Schicht zur Inspektion des Datenverkehrs hinzu. Wenden Sie sich an Ihr Cognition Account-Team für detaillierte Hinweise zur Einrichtung.
</Note>

<div id="key-considerations">
  ## Wichtige Aspekte
</div>

| Thema                              | Hinweise                                                                                                        |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| Erforderliche Einrichtung          | Ein Endpoint Service pro Domäne, ein Interface Endpoint pro Domäne                                              |
| Regionsübergreifende Unterstützung | Muss explizit auf dem Endpoint Service aktiviert werden                                                         |
| Zulässige Principals               | Der Kunde muss die AWS-Konto-ID von Cognition hinzufügen                                                        |
| DNS                                | Kundendomänen werden auf private Interface-Endpoint-IP-Adressen auf der Cognition-Seite aufgelöst               |
| Ports                              | NLB-Listener müssen mit den Ports übereinstimmen, die Devin für den Zugriff auf jeden Service verwendet         |
| Verfügbarkeit                      | NLB und zugrunde liegende Targets sollten in mehreren Availability Zones konfiguriert werden                    |
| Latenz                             | Eine geringe zusätzliche regionsübergreifende Latenz kann auftreten, da der Datenverkehr im AWS-Backbone bleibt |

<div id="information-to-provide-to-cognition">
  ## Für Cognition bereitzustellende Informationen
</div>

Wenn Ihr Setup abgeschlossen ist, senden Sie Cognition:

* AWS Endpoint-Service-Namen für jede interne Domain
* Bestätigung, dass Cross-Region-Support aktiviert ist (falls zutreffend)
* Bestätigung, dass die Konfiguration der zulässigen Principals abgeschlossen ist
* Vom NLB bereitgestellte Ports
* Die Liste der Domains, die über PrivateLink geroutet werden sollen

Cognition richtet dann die Interface Endpoints ein, konfiguriert DNS und bestätigt die Konnektivität.