Virtual Private Network (VPN)

Leer hoe te om AEM as a Cloud Service met uw VPN te verbinden om veilige communicatie kanalen tussen AEM en de interne diensten tot stand te brengen.

IMPORTANT
U kunt VPNs en haven vormen door:sturen of door Cloud Manager UI of het gebruiken van API vraag. Deze zelfstudie richt zich op de API-methode.
Als u verkiest gebruikend UI, zie ​ Geavanceerd Voorzien van een netwerk voor AEM as a Cloud Service ​ vormen.

Wat is een Virtueel Privé Netwerk?

Het virtuele Privé Netwerk (VPN) staat een klant van AEM as a Cloud Service toe om de milieu's van AEM binnen een Programma van Cloud Manager aan bestaand, ​ gesteund ​ VPN te verbinden. VPN staat veilige en gecontroleerde verbindingen tussen AEM as a Cloud Service en de diensten binnen het netwerk van de klant toe.

Een programma van Cloud Manager kan het type van a enige netwerkinfrastructuur slechts hebben. Zorg ervoor dat het Virtuele Privé Netwerk het meest ​ aangewezen type van netwerkinfrastructuur ​ voor uw AEM as a Cloud Service is alvorens de volgende bevelen uit te voeren.

NOTE
Gelieve te merken op, wordt het verbinden van het bouwstijlmilieu van Cloud Manager met VPN niet gesteund. Als u tot binaire artefacten van een privé bewaarplaats moet toegang hebben, moet u opstelling een veilige en wachtwoord-beschermde bewaarplaats met een URL die op openbaar Internet ​ beschikbaar is zoals hier beschreven ​.

Vereisten

Voor het instellen van een Virtual Private Network met Cloud Manager API's is het volgende vereist:

Voor meer details ​ overzicht hoe te opstelling, vorm, en verkrijg de geloofsbrieven van de Manager van de Wolk API ​, om hen te gebruiken om een Cloud Manager API vraag te maken.

IMPORTANT
Dit leerprogramma gebruikt curl om de configuraties van Cloud Manager API te maken - als u een programmatic benadering verkiest. Voor de geleverde curl opdrachten wordt uitgegaan van een Linux®- of macOS-syntaxis. Als u de Windows-opdrachtregel gebruikt, vervangt u het teken voor het \ regeleinde door ^ .
U kunt dezelfde taak ook uitvoeren via de gebruikersinterface van Cloud Manager. als u de UI benadering verkiest, zie ​ Geavanceerd Voorzien van een netwerk voor AEM as a Cloud Service ​ vormen.

Virtuele privénetwerk per programma inschakelen

Begin door het Virtuele Privé Netwerk op AEM as a Cloud Service toe te laten.

Cloud Manager

Flexibele poortuitgang kan worden ingeschakeld met Cloud Manager. In de volgende stappen wordt beschreven hoe u flexibele poorttoegang op AEM as a Cloud Service kunt inschakelen met de Cloud Manager.

  1. Login aan ​ Adobe Experience Manager Cloud Manager ​ als Bedrijfseigenaar van Cloud Manager.

  2. Navigeer naar het gewenste programma.

  3. In het linkermenu, navigeer aan Diensten > de Infrastructuur van het Netwerk.

  4. Selecteer toevoegen netwerkinfrastructuur knoop.

    voeg netwerkinfrastructuur toe

  5. In voeg de dialoogdoos van de netwerkinfrastructuur toe, selecteer de Virtuele privé netwerk optie. Vul de gebieden uit en selecteer verdergaan. Werk met de netwerkbeheerder van uw organisatie om de correcte waarden te verkrijgen.

    voeg VPN toe

  6. Creeer minstens één verbinding van VPN. Geef de verbinding een betekenisvolle naam en selecteer verbindingsknoop toevoegen.

    voeg de verbinding van VPN toe

  7. Vorm de verbinding van VPN. Werk met de netwerkbeheerder van uw organisatie om de correcte waarden te verkrijgen. Selecteer sparen om de toevoeging van de verbinding te bevestigen.

    vorm de verbinding van VPN

  8. Als de veelvoudige verbindingen van VPN worden vereist, zoals meer verbindingen zoals nodig. Wanneer alle verbindingen van VPN worden toegevoegd, uitgezochte gaat verder.

    vorm de verbinding van VPN

  9. Selecteer sparen om de toevoeging van VPN en alle gevormde verbindingen te bevestigen.

    bevestigt de verwezenlijking van VPN

  10. Wacht op de netwerkinfrastructuur die moet worden gecreeerd en als Klaar worden gemerkt. Dit proces kan tot 1 uur duren.

    de aanmaakstatus van VPN

Met VPN gecreeerd, kunt u het nu vormen gebruikend Cloud Manager APIs zoals hieronder beschreven.

Cloud Manager APIs

Virtual Private Network kan worden ingeschakeld met Cloud Manager API's. In de volgende stappen wordt beschreven hoe u VPN in AEM as a Cloud Service kunt inschakelen met de Cloud Manager API.

  1. Eerst, bepaal het gebied waarin het Geavanceerde Voorzien van een netwerk nodig is door de Cloud Manager API ​ listRegions ​ verrichting te gebruiken. region name is vereist om volgende Cloud Manager API-aanroepen te kunnen uitvoeren. Doorgaans wordt de regio waarin de productieomgeving zich bevindt, gebruikt.

    Vind het gebied van uw milieu van AEM as a Cloud Service in ​ Cloud Manager ​ onder de ​ details van het milieu ​. De gebiedsnaam die in Cloud Manager wordt getoond kan ​ aan de gebiedscode ​ worden in kaart gebracht die in Cloud Manager API wordt gebruikt.

    listRegions HTTP- verzoek

    code language-shell
    $ curl -X GET https://cloudmanager.adobe.io/api/program/{programId}/regions \
        -H 'x-gw-ims-org-id: <ORGANIZATION_ID>' \
        -H 'x-api-key: <CLIENT_ID>' \
        -H 'Authorization: Bearer <ACCESS_TOKEN>' \
        -H 'Content-Type: application/json'
    
  2. Laat Virtueel Privé Netwerk voor een Programma van Cloud Manager toe gebruikend Cloud Manager APIs ​ createNetworkInfrastructure ​ verrichting. Gebruik de juiste region -code die is verkregen via de Cloud Manager API listRegions -bewerking.

    createNetworkInfrastructure HTTP- verzoek

    code language-shell
    $ curl -X POST https://cloudmanager.adobe.io/api/program/{programId}/networkInfrastructures \
        -H 'x-gw-ims-org-id: <ORGANIZATION_ID>' \
        -H 'x-api-key: <CLIENT_ID>' \
        -H 'Authorization: Bearer <ACCESS_TOKEN>' \
        -H 'Content-Type: application/json'
        -d @./vpn-create.json
    

    Definieer de JSON-parameters in een vpn-create.json -instructie en geef deze als ... -d @./vpn-create.json op.

    ​ Download het voorbeeld vpn-create.json ​. Dit bestand is slechts een voorbeeld. Vorm uw dossier zoals vereist gebaseerd op de facultatieve/vereiste gebieden die bij ​ worden gedocumenteerd enableEnvironmentAdvancedNetworkingConfiguration ​.

    code language-json
    {
        "kind": "vpn",
        "region": "va7",
        "addressSpace": [
            "10.104.182.64/26"
        ],
        "dns": {
            "resolvers": [
                "10.151.201.22",
                "10.151.202.22",
                "10.154.155.22"
            ],
            "domains": [
                "wknd.site",
                "wknd.com"
            ]
        },
        "connections": [{
            "name": "connection-1",
            "gateway": {
                "address": "195.231.212.78",
                "addressSpace": [
                    "10.151.0.0/16",
                    "10.152.0.0/16",
                    "10.153.0.0/16",
                    "10.154.0.0/16",
                    "10.142.0.0/16",
                    "10.143.0.0/16",
                    "10.124.128.0/17"
                ]
            },
            "sharedKey": "<secret_shared_key>",
            "ipsecPolicy": {
                "dhGroup": "ECP256",
                "ikeEncryption": "AES256",
                "ikeIntegrity": "SHA256",
                "ipsecEncryption": "AES256",
                "ipsecIntegrity": "SHA256",
                "pfsGroup": "ECP256",
                "saDatasize": 102400000,
                "saLifetime": 3600
            }
        }]
    }
    

    Wacht 45-60 minuten op het Programma van Cloud Manager om de netwerkinfrastructuur te verstrekken.

  3. Controleer dat het milieu Virtuele Privé Configuratie van het Netwerk gebruikend de Cloud Manager API ​ getNetworkInfrastructure ​ verrichting gebeëindigd heeft, gebruikend id die van het createNetworkInfrastructure HTTP- verzoek in de vorige stap is teruggekeerd.

    getNetworkInfrastructure HTTP- verzoek

    code language-shell
    $ curl -X GET https://cloudmanager.adobe.io/api/program/{programId}/networkInfrastructure/{networkInfrastructureId} \
        -H 'x-gw-ims-org-id: <ORGANIZATION_ID>' \
        -H 'x-api-key: <CLIENT_ID>' \
        -H 'Authorization: <YOUR_BEARER_TOKEN>' \
        -H 'Content-Type: application/json'
    

    Verifieer dat de reactie van HTTP a status van klaar bevat. Controleer de status om de paar minuten als u dat nog niet hebt gedaan.

Met VPN gecreeerd, kunt u het nu vormen gebruikend Cloud Manager APIs zoals hieronder beschreven.

Virtual Private Network-proxy's per omgeving configureren

  1. Laat en vorm de Virtuele Privé configuratie van het Netwerk op elk milieu van AEM as a Cloud Service toe gebruikend Cloud Manager API ​ enableEnvironmentAdvancedNetworkingConfiguration ​ verrichting.

    enableEnvironmentAdvancedNetworkingConfiguration HTTP- verzoek

    code language-shell
    $ curl -X PUT https://cloudmanager.adobe.io/api/program/{programId}/environment/{environmentId}/advancedNetworking \
        -H 'x-gw-ims-org-id: <ORGANIZATION_ID>' \
        -H 'x-api-key: <CLIENT_ID>' \
        -H 'Authorization: Bearer <ACCESS_TOKEN>' \
        -H 'Content-Type: application/json' \
        -d @./vpn-configure.json
    

    Definieer de JSON-parameters in een vpn-configure.json -instructie en geef deze als ... -d @./vpn-configure.json op.

Download het voorbeeld vpn-configure.json

{
    "nonProxyHosts": [
        "example.net",
        "*.example.org"
    ],
    "portForwards": [
        {
            "name": "mysql.example.com",
            "portDest": 3306,
            "portOrig": 30001
        },
        {
            "name": "smtp.sendgrid.com",
            "portDest": 465,
            "portOrig": 30002
        }
    ]
}

nonProxyHosts verklaart een reeks gastheren waarvoor haven 80 of 443 door de standaard gedeelde IP adreswaaiers eerder dan specifieke uitgang IP zou moeten worden verpletterd. nonProxyHosts kan nuttig zijn als verkeer dat zich door gedeelde IPs verwijdert die Adobe automatisch optimaliseert.

Voor elke portForwards afbeelding, bepaalt het geavanceerde voorzien van een netwerk de volgende het door:sturen regel:

Proxyhost
Proxypoort
Externe host
Externe poort
AEM_PROXY_HOST
portForwards.portOrig
portForwards.name
portForwards.portDest

Als uw plaatsing van AEM slechts verbindingen HTTP/HTTPS aan externe dienst vereist, verlaat de portForwards serie leeg, aangezien deze regels slechts voor niet-HTTP/HTTPS verzoeken worden vereist.

​2. Voor elk milieu, bevestig VPN die regels verplettert in feite gebruikend de Cloud Manager API ​ getEnvironmentAdvancedNetworkingConfiguration ​ verrichting.

getEnvironmentAdvancedNetworkingConfiguration HTTP- verzoek

$ curl -X GET https://cloudmanager.adobe.io/api/program/{programId}/environment/{environmentId}/advancedNetworking \
    -H 'x-gw-ims-org-id: <ORGANIZATION_ID>' \
    -H 'x-api-key: <CLIENT_ID>' \
    -H 'Authorization: Bearer <ACCESS_TOKEN>' \
    -H 'Content-Type: application/json'

​3. De virtuele Privé de volmachtsconfiguraties van het Netwerk kunnen worden bijgewerkt gebruikend Cloud Manager API ​ enableEnvironmentAdvancedNetworkingConfiguration ​ verrichting. Vergeet niet dat enableEnvironmentAdvancedNetworkingConfiguration een PUT -bewerking is. Alle regels moeten daarom bij elke aanroep van deze bewerking worden opgegeven.

​4. Nu, kunt u de Virtuele Privé configuratie van de uitgang van het Netwerk in uw code en configuratie van douaneAEM gebruiken.

Verbinding maken met externe services via het Virtual Private Network

Met het Virtuele Privé Toegelaten Netwerk, kunnen de code en de configuratie van AEM hen gebruiken om vraag aan externe diensten door VPN te maken. Er zijn twee flavors van externe vraag die AEM verschillend behandelt:

  1. HTTP/HTTPS-aanroepen naar externe services
    • Deze externe services omvatten HTTP/HTTPS-aanroepen naar services die worden uitgevoerd op andere poorten dan de standaardpoorten 80 of 443.
  2. Niet-HTTP/HTTPS-aanroepen naar externe services
    • Deze externe services omvatten alle niet-HTTP-aanroepen, zoals verbindingen met mailservers, SQL-databases of services die andere protocollen gebruiken dan HTTP/HTTPS.

HTTP/HTTPS-aanvragen van AEM op standaardpoorten (80/443) zijn standaard toegestaan, maar gebruiken de VPN-verbinding niet als deze niet op de hieronder beschreven manier is geconfigureerd.

HTTP/HTTPS

Wanneer u HTTP/HTTPS-verbindingen maakt vanuit AEM, worden bij gebruik van VPN HTTP/HTTPS-verbindingen automatisch vanuit AEM opgewaardeerd. Er is geen aanvullende code of configuratie vereist voor ondersteuning van HTTP/HTTPS-verbindingen.

TIP
Zie de Virtuele documentatie Privé van het Netwerk van AEM as a Cloud Service voor ​ de volledige reeks het verpletteren van regels ​.

Codevoorbeelden

HTTP/HTTPS

HTTP/HTTPS

Java™-codevoorbeeld waarbij via het HTTP/HTTPS-protocol een HTTP/HTTPS-verbinding van AEM as a Cloud Service naar een externe service wordt gemaakt.

Codevoorbeelden van niet-HTTP/HTTPS-verbindingen

Bij het maken van niet-HTTP/HTTPS-verbindingen (bijvoorbeeld SQL, SMTP, etc.) van AEM, moet de verbinding door een speciale gastheernaam worden gemaakt die door AEM wordt verstrekt.

Naam variabele
Gebruiken
Java™-code
OSGi-configuratie
AEM_PROXY_HOST
Proxyhost voor niet-HTTP/HTTPS-verbindingen
System.getenv("AEM_PROXY_HOST")
$[env:AEM_PROXY_HOST]

Verbindingen met externe diensten worden dan geroepen door AEM_PROXY_HOST en de in kaart gebrachte haven (portForwards.portOrig), die AEM dan aan toegewezen externe hostname (portForwards.name) en haven (portForwards.portDest) leidt.

Proxyhost
Proxypoort
Externe host
Externe poort
AEM_PROXY_HOST
portForwards.portOrig
portForwards.name
portForwards.portDest

Codevoorbeelden

SQL-verbinding met JDBC DataSourcePool

SQL verbinding gebruikend JDBC DataSourcePool

Java™ codevoorbeeld die met externe SQL gegevensbestanden verbinden door AEM te vormen JDBC datasource pool.

SQL-verbinding met Java API's

SQL verbinding gebruikend Java™ APIs

Java™-codevoorbeeld voor verbinding met externe SQL-databases met SQL API's van Java™.

Virtual Private Network (VPN)

E-maildienst

OSGi-configuratievoorbeeld dat AEM gebruikt om verbinding te maken met externe e-mailservices.

Toegang tot AEM as a Cloud Service beperken via VPN

De Virtual Private Network-configuratie beperkt de toegang tot AEM as a Cloud Service-omgevingen tot een VPN.

Configuratievoorbeelden

Een IP-lijst van gewenste personen toepassen

Toepassend een IP lijst van gewenste personen

Vorm een IP lijst van gewenste personen dusdanig dat slechts het verkeer van VPN tot AEM kan toegang hebben.

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69