Dirección IP de salida dedicada

AEM Obtenga información sobre cómo configurar y utilizar la dirección IP de salida dedicada, que permite que las conexiones salientes de la dirección IP de salida se originen desde una dirección IP dedicada.

¿Qué es la dirección IP de salida dedicada?

AEM La dirección IP de salida dedicada permite que las solicitudes de los as a Cloud Service utilicen una dirección IP específica, lo que permite a los servicios externos filtrar las solicitudes entrantes por esta dirección IP. Like puertos de salida flexibles, la IP de salida dedicada le permite salir en puertos no estándar.

Un programa de Cloud Manager solo puede tener un soltero tipo de infraestructura de red. Asegúrese de que la dirección IP de salida dedicada sea la más adecuada tipo adecuado de infraestructura de red AEM para el recurso as a Cloud Service antes de ejecutar los siguientes comandos.

Requisitos previos

Se requiere lo siguiente al configurar la dirección IP de salida dedicada mediante las API de Cloud Manager:

Para obtener más información, consulte el siguiente tutorial sobre cómo configurar y obtener credenciales de API de Cloud Manager y cómo utilizarlas para realizar una llamada de API de Cloud Manager.

Este tutorial utiliza curl para realizar las configuraciones de la API de Cloud Manager. El proporcionado curl Los comandos de asumen una sintaxis de Linux/macOS. Si utiliza el símbolo del sistema de Windows, reemplace la variable \ salto de línea con ^.

Habilitar la dirección IP de salida dedicada en el programa

AEM Comience habilitando y configurando la dirección IP de salida dedicada en el as a Cloud Service de la.

Cloud Manager

La dirección IP de salida dedicada se puede habilitar mediante Cloud Manager. AEM Los siguientes pasos describen cómo habilitar la dirección IP de salida dedicada en las direcciones as a Cloud Service de mediante Cloud Manager.

  1. Inicie sesión en Adobe Experience Manager Cloud Manager como propietario empresarial de Cloud Manager.

  2. Vaya al programa deseado.

  3. En el menú de la izquierda, navegue hasta Servicios > Infraestructura de red.

  4. Seleccione el Agregar infraestructura de red botón.

    Agregar infraestructura de red

  5. En el Agregar infraestructura de red , seleccione la Dirección IP de salida dedicada y seleccione la opción Región para crear la dirección IP de salida dedicada.

    Añadir dirección IP de salida dedicada

  6. Seleccionar Guardar para confirmar la adición de la dirección IP de salida dedicada.

    Confirmar creación de dirección IP de salida dedicada

  7. Espere a que se cree la infraestructura de red y se marque como Listo. Este proceso puede tardar hasta 1 hora.

    Estado de creación de dirección IP de salida dedicada

Con la dirección IP de salida dedicada creada, ahora puede configurarla mediante las API de Cloud Manager como se describe a continuación.

API de Cloud Manager

La dirección IP de salida dedicada se puede habilitar mediante las API de Cloud Manager. AEM Los siguientes pasos describen cómo habilitar la dirección IP de salida dedicada en las direcciones as a Cloud Service mediante la API de Cloud Manager.

  1. En primer lugar, determine la región en la que se necesita la red avanzada mediante la API de Cloud Manager listRegions operación. El region name es necesario para realizar llamadas posteriores a la API de Cloud Manager. Normalmente, se utiliza la región en la que reside el entorno de producción.

    AEM Encuentre la región de su entorno as a Cloud Service de la en Cloud Manager en el detalles del entorno. El nombre de región que se muestra en Cloud Manager puede ser asignado al código de región se utiliza en la API de Cloud Manager.

    solicitud HTTP listRegions

    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. Habilite la dirección IP de salida dedicada para un programa de Cloud Manager mediante la API de Cloud Manager createNetworkInfrastructure operación. Utilice el adecuado region código obtenido de la API de Cloud Manager listRegions operación.

    solicitud HTTP createNetworkInfrastructure

    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 '{ "kind": "dedicatedEgressIp", "region": "va7" }'
    

    Espere 15 minutos para que el programa Cloud Manager aprovisione la infraestructura de red.

  3. Compruebe que el programa ha finalizado dirección IP de salida dedicada Configuración de mediante la API de Cloud Manager getNetworkInfrastructure operación, usando el id devuelto desde el createNetworkInfrastructure Solicitud HTTP en el paso anterior.

    petición HTTP getNetworkInfrastructure

    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: Bearer <ACCESS_TOKEN>' \
        -H 'Content-Type: application/json'
    

    Compruebe que la respuesta HTTP contiene un status de ready. Si aún no está listo, vuelva a comprobar el estado cada pocos minutos.

Con la dirección IP de salida dedicada creada, ahora puede configurarla mediante las API de Cloud Manager como se describe a continuación.

Configurar proxies de direcciones IP de salida dedicados por entorno

  1. Configure las variables dirección IP de salida dedicada AEM Configuración de en cada entorno as a Cloud Service de mediante la API de Cloud Manager enableEnvironmentAdvancedNetworkingConfiguration operación.

    enableEnvironmentAdvancedNetworkingConfiguration petición HTTP

    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 @./dedicated-egress-ip-address.json
    

    Defina los parámetros JSON en una dedicated-egress-ip-address.json y se proporciona para rizar mediante ... -d @./dedicated-egress-ip-address.json.

    Descargue el ejemplo dedicated-egress-ip-address.json. Este archivo es solo un ejemplo. Configure el archivo según sea necesario en función de los campos opcionales/obligatorios documentados en enableEnvironmentAdvancedNetworkingConfiguration.

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

    La firma HTTP de la configuración de la dirección IP de salida dedicada solo difiere de puerto de salida flexible en el sentido de que también admite el nonProxyHosts configuración.

    nonProxyHosts declara un conjunto de hosts para los que el puerto 80 o 443 debe enrutarse a través de los intervalos de direcciones IP compartidos predeterminados en lugar de la IP de salida dedicada. nonProxyHosts puede resultar útil, ya que la salida de tráfico a través de direcciones IP compartidas se optimiza automáticamente mediante el Adobe.

    Para cada portForwards , la red avanzada define la siguiente regla de reenvío:

    table 0-row-5 1-row-5
    Host de proxy Puerto Proxy Host externo Puerto externo
    AEM_PROXY_HOST portForwards.portOrig portForwards.name portForwards.portDest
  2. Para cada entorno, valide que las reglas de salida estén en vigor mediante la API de Cloud Manager getEnvironmentAdvancedNetworkingConfiguration operación.

    getEnvironmentAdvancedNetworkingConfiguration petición HTTP

    code language-shell
    $ 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: <YOUR_TOKEN>' \
        -H 'Content-Type: application/json'
    
  3. Las configuraciones de direcciones IP de salida dedicadas se pueden actualizar mediante la API de Cloud Manager enableEnvironmentAdvancedNetworkingConfiguration operación. Recordar enableEnvironmentAdvancedNetworkingConfiguration es un PUT , por lo que todas las reglas deben proporcionarse con cada invocación de esta operación.

  4. Obtenga la dirección IP de salida dedicada mediante una resolución DNS (por ejemplo, DNSChecker.org) en el host: p{programId}.external.adobeaemcloud.com, o ejecutando dig desde la línea de comandos.

    code language-shell
    $ dig +short p{programId}.external.adobeaemcloud.com
    

    El nombre de host no puede ser pinged, ya que es una salida y no y la entrada.

    AEM Tenga en cuenta que todos los entornos as a Cloud Service del programa comparten la dirección IP de salida dedicada.

  5. AEM Ahora, puede utilizar la dirección IP de salida dedicada en el código y la configuración personalizados de la. AEM A menudo, al utilizar una dirección IP de salida dedicada, los servicios externos a los que se conecta as a Cloud Service se configuran para permitir solo el tráfico de esta dirección IP dedicada.

Conexión a servicios externos a través de una dirección IP de salida dedicada

AEM Con la dirección IP de salida dedicada habilitada, el código y la configuración de la pueden utilizar la IP de salida dedicada para hacer llamadas a servicios externos. AEM Existen dos tipos de llamadas externas que se tratan de manera diferente en el modo que se hace:

  1. Llamadas HTTP/HTTPS a servicios externos
    • Incluye llamadas HTTP/HTTPS realizadas a servicios que se ejecutan en puertos que no son los puertos estándar 80 o 443.
  2. llamadas no HTTP/HTTPS a servicios externos
    • Incluye cualquier llamada que no sea HTTP, como conexiones con servidores de correo, bases de datos SQL o servicios que se ejecutan en otros protocolos que no son HTTP/HTTPS.

AEM Las solicitudes HTTP/HTTPS de los puertos estándar (80/443) se permiten de forma predeterminada, pero no utilizan la dirección IP de salida dedicada si no se configura correctamente como se describe a continuación.

TIP
AEM Consulte la documentación de la dirección IP de salida dedicada de as a Cloud Service para el conjunto completo de reglas de enrutamiento.

HTTP/HTTPS

AEM AEM Al crear conexiones HTTP/HTTPS desde la dirección IP de salida dedicada, las conexiones HTTP/HTTPS se procesan como proxy automáticamente fuera de la dirección IP de salida dedicada usando la dirección IP de salida dedicada. No se requiere código ni configuración adicional para admitir conexiones HTTP/HTTPS.

Ejemplos de código

HTTP/HTTPS

HTTP/HTTPS

AEM Ejemplo de código Java™ que establece la conexión HTTP/HTTPS de manera as a Cloud Service a un servicio externo que utiliza el protocolo HTTP/HTTPS.

Conexiones no HTTP/HTTPS a servicios externos

Al crear conexiones no HTTP/HTTPS (por ejemplo, AEM AEM SQL, SMTP, etc.) desde el punto de vista de la seguridad, la conexión debe realizarse a través de un nombre de host especial proporcionado por el usuario de la red de seguridad de la red de datos (SQL, SMTP, etc.) de la red de seguridad de la red de datos

Nombre de variable
Uso
Código Java™
Configuración de OSGi
AEM_PROXY_HOST
Host proxy para conexiones no HTTP/HTTPS
System.getenv("AEM_PROXY_HOST")
$[env:AEM_PROXY_HOST]

A continuación, se llama a las conexiones a servicios externos a través de AEM_PROXY_HOST y el puerto asignado (portForwards.portOrigAEM ), que luego enruta al nombre de host externo asignado (portForwards.name) y el puerto (portForwards.portDest).

Host de proxy
Puerto Proxy
Host externo
Puerto externo
AEM_PROXY_HOST
portForwards.portOrig
portForwards.name
portForwards.portDest

Ejemplos de código

Conexión SQL con JDBC DataSourcePool

Conexión SQL con JDBC DataSourcePool

AEM Ejemplo de código Java™ conectarse a bases de datos SQL externas configurando el grupo de fuentes de datos JDBC de la.

Conexión SQL con API de Java

Conexión SQL con las API de Java™

Ejemplo de código Java™ conectarse a bases de datos SQL externas mediante las API SQL de Java™.

Red privada virtual (VPN)

Servicio de correo electrónico

AEM Ejemplo de configuración de OSGi que utiliza la conexión con los servicios de correo electrónico externos mediante el uso de la.

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