Adresse IP sortante dédiée

Découvrez comment configurer et utiliser une adresse IP de sortie dédiée, qui permet aux connexions sortantes d’AEM d’être issues d’une adresse IP dédiée.

Qu’est-ce que l’adresse IP de sortie dédiée ?

Une adresse IP sortante dédiée permet aux requêtes d’AEM as a Cloud Service d’utiliser une adresse IP dédiée, ce qui permet aux services externes de filtrer les requêtes entrantes par cette adresse IP. Comme ports de sortie flexibles, une adresse IP sortante dédiée vous permet de passer sur des ports non standard.

Un programme Cloud Manager ne peut avoir qu’une single type d’infrastructure réseau. Assurez-vous que l’adresse IP sortante dédiée est la plus élevée type approprié d’infrastructure réseau pour votre AEM as a Cloud Service avant d’exécuter les commandes suivantes.

Prérequis

Les éléments suivants sont requis lors de la configuration d’une adresse IP de sortie dédiée :

• API Cloud Manager avec Autorisations du propriétaire commercial Cloud Manager
• Accès à Informations d’identification de l’authentification de l’API Cloud Manager
  • ID d’organisation (alias ID d’organisation IMS)
  • ID client (alias clé API)
  • Jeton d’accès (ou jeton porteur)
• ID de programme Cloud Manager
• ID d’environnement de Cloud Manager

Pour plus d’informations, consultez la présentation suivante pour savoir comment configurer, configurer et obtenir les informations d’identification de l’API Cloud Manager, et comment les utiliser pour effectuer un appel de l’API Cloud Manager.

Ce tutoriel utilise curl pour créer les configurations de l’API Cloud Manager. Le curl supposent une syntaxe Linux/macOS. Si vous utilisez l’invite de commande Windows, remplacez la variable \ caractère de saut de ligne avec ^.

Activer l’adresse IP de sortie dédiée sur le programme

Commencez par activer et configurer l’adresse IP sortante dédiée sur AEM as a Cloud Service.

1. Tout d’abord, déterminez la région dans laquelle la mise en réseau avancée est nécessaire, à l’aide de l’API Cloud Manager. listRegion opération. Le region name est nécessaire pour effectuer les appels d’API Cloud Manager suivants. En règle générale, la région dans laquelle réside l’environnement de production est utilisée.

   requête HTTP listRegion

   $ 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. Activation d’une adresse IP de sortie dédiée pour un programme Cloud Manager à l’aide de l’API Cloud Manager createNetworkInfrastructure opération. Utilisez les region code obtenu à partir de l’API Cloud Manager listRegions opération.

   requête HTTP createNetworkInfrastructure

   $ 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" }'
   

   Patientez 15 minutes pendant que le programme Cloud Manager approvisionne l’infrastructure réseau.

3. Vérifier que le programme est terminé adresse IP de sortie dédiée configuration à l’aide de l’API Cloud Manager getNetworkInfrastructure , à l’aide de la fonction id renvoyée par la requête HTTP createNetworkInfrastructure de l’étape précédente.

   requête HTTP getNetworkInfrastructure

   $ 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'
   

   Vérifiez que la réponse HTTP contient une status de ready. Si elle n’est pas encore prête, vérifiez à nouveau l’état toutes les quelques minutes.

Configuration de proxys d’adresses IP sortantes dédiés par environnement

1. Configurez la variable adresse IP de sortie dédiée configuration sur chaque environnement as a Cloud Service AEM à l’aide de l’API Cloud Manager enableEnvironmentAdvancedNetworkingConfiguration opération.

   requête HTTP enableEnvironmentAdvancedNetworkingConfiguration

   $ 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
   

   Définition des paramètres JSON dans une dedicated-egress-ip-address.json et fourni à curl via ... -d @./dedicated-egress-ip-address.json.

   Téléchargez l’exemple dedicated-egress-ip-address.json. Ce fichier n’est qu’un exemple. Configurez votre fichier selon les besoins en fonction des champs facultatifs/obligatoires documentés à l’adresse enableEnvironmentAdvancedNetworkingConfiguration.

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

   La signature HTTP de la configuration de l’adresse IP sortante dédiée diffère uniquement de port de sortie flexible en ce sens qu’il prend également en charge les options facultatives. nonProxyHosts configuration.

   nonProxyHosts déclare un ensemble d’hôtes pour lequel le port 80 ou 443 doit être acheminé par les plages d’adresses IP partagées par défaut plutôt que par l’adresse IP sortante dédiée. nonProxyHosts peut s’avérer utile, car le trafic passant par les adresses IP partagées peut être optimisé automatiquement par Adobe.

   Pour chaque portForwards , la mise en réseau avancée définit la règle de transfert suivante :

   Hôte du proxy	Port du proxy		Hôte externe	Port externe
   AEM_PROXY_HOST	portForwards.portOrig	→	portForwards.name	portForwards.portDest

2. Pour chaque environnement, validez les règles de sortie en vigueur à l’aide de l’API Cloud Manager. getEnvironmentAdvancedNetworkingConfiguration opération.

   requête HTTP getEnvironmentAdvancedNetworkingConfiguration

   $ 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. Les configurations d’adresses IP sortantes dédiées peuvent être mises à jour à l’aide de l’API Cloud Manager. enableEnvironmentAdvancedNetworkingConfiguration opération. Mémoriser enableEnvironmentAdvancedNetworkingConfiguration est un PUT toutes les règles doivent donc être fournies avec chaque appel de cette opération.

4. Obtenez la variable adresse IP de sortie dédiée en utilisant un résolveur DNS (tel que DNSCchaker.org) sur l’hôte : p{programId}.external.adobeaemcloud.comou en exécutant dig de la ligne de commande.

   $ dig +short p{programId}.external.adobeaemcloud.com
   

   Le nom d’hôte ne peut pas être pinged, car il s’agit d’une sortie et not et d’entrée.

   Notez que adresse IP de sortie dédiée est partagé par tous les environnements as a Cloud Service AEM du programme.

5. Vous pouvez désormais utiliser l’adresse IP de sortie dédiée dans votre code et configuration d’AEM personnalisé. Souvent, lors de l’utilisation d’une adresse IP de sortie dédiée, les services externes auxquels AEM as a Cloud Service se connecte sont configurés pour autoriser uniquement le trafic à partir de cette adresse IP dédiée.

Connexion à des services externes sur une adresse IP sortante dédiée

Lorsque l’adresse IP de sortie dédiée est activée, le code AEM et la configuration peuvent utiliser l’adresse IP de sortie dédiée pour effectuer des appels vers des services externes. Il existe deux types d’appels externes qui AEM traitent différemment :

1. Appels HTTP/HTTPS aux services externes
   • Inclut les appels HTTP/HTTPS effectués aux services s’exécutant sur des ports autres que les ports 80 ou 443 standard.
2. Appels non HTTP/HTTPS aux services externes
   • Inclut tous les appels non HTTP, tels que les connexions aux serveurs de messagerie, aux bases de données SQL ou aux services qui s’exécutent sur d’autres protocoles non HTTP/HTTPS.

Les requêtes HTTP/HTTPS provenant d’AEM sur les ports standard (80/443) sont autorisées par défaut, mais elles n’utiliseront pas l’adresse IP de sortie dédiée si elles ne sont pas configurées correctement comme décrit ci-dessous.

HTTP/HTTPS

Lors de la création de connexions HTTP/HTTPS à partir d’AEM, lors de l’utilisation d’adresses IP de sortie dédiées, les connexions HTTP/HTTPS sont automatiquement traitées par proxy hors d’AEM à l’aide de l’adresse IP de sortie dédiée. Aucun code ou configuration supplémentaire n’est requis pour la prise en charge des connexions HTTP/HTTPS.

Exemples de code

HTTP/HTTPS Exemple de code Java™ permettant d’établir une connexion HTTP/HTTPS d’AEM as a Cloud Service à un service externe à l’aide du protocole HTTP/HTTPS.

Connexions non HTTP/HTTPS à des services externes

Lors de la création de connexions non HTTP/HTTPS (ex. SQL, SMTP, etc.) depuis AEM, la connexion doit être établie par un nom d’hôte spécial fourni par AEM.

| Nom de variable | Utilisation | Code Java™ | Configuration OSGi | | - | - | - | - | | AEM_PROXY_HOST | Hôte proxy pour les connexions non HTTP/HTTPS | System.getenv("AEM_PROXY_HOST") | $[env:AEM_PROXY_HOST] |

Les connexions à des services externes sont ensuite appelées par l’intermédiaire de la fonction AEM_PROXY_HOST et le port mappé (portForwards.portOrig), qui AEM ensuite achemine vers le nom d’hôte externe mappé (portForwards.name) et port (portForwards.portDest).

Exemples de code

Connexion SQL à l’aide de JDBC DataSourcePool Exemple de code Java™ se connectant à des bases de données SQL externes en configurant AEM pool de sources de données JDBC.

Connexion SQL à l’aide des API Java™ Exemple de code Java™ se connectant à des bases de données SQL externes à l’aide des API SQL de Java™.

Service de messagerie électronique Exemple de configuration OSGi utilisant AEM pour se connecter à des services de messagerie externes.

Ressources Business.Adobe.com