Adresses IP dans Gestion des API Azure

S’APPLIQUE À : Tous les niveaux de Gestion des API

Cet article explique comment récupérer les adresses IP de Gestion des API Azure. Les adresses IP peuvent être publiques ou privées si le service se trouve dans un réseau virtuel. Vous pouvez utiliser des adresses IP pour créer des règles de pare-feu, filtrer le trafic entrant vers les services principaux ou restreindre le trafic sortant.

Adresses IP publiques

Chaque instance de gestion d’API dans les niveaux Développeur, Basic, Standard ou Premium possède des adresses IP publiques exclusives à cette instance. (Ils ne sont pas partagés avec d’autres ressources.)

Récupérez les adresses IP depuis le tableau de bord d’aperçu de votre ressource dans le portail Azure :

Capture d’écran montrant une adresse IP dans Gestion des API.

Sinon, récupérez-les programmatiquement en utilisant cet appel API :

GET https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.ApiManagement/service/<service-name>?api-version=<api-version>

Des adresses IP publiques apparaissent dans la réponse :

{
  ...
  "properties": {
    ...
    "publicIPAddresses": [
      "172.31.0.1"
    ],
    ...
  }
  ...
}

Dans les déploiements multirégionaux, chaque déploiement régional possède une adresse IP publique.

Adresses IP de gestion des API dans un réseau virtuel

Si votre instance Gestion des API se trouve à l’intérieur d’un réseau virtuel, elle a deux types d’adresses IP : public et privé.

  • Utilisez des adresses IP publiques pour la communication interne sur le port 3443 afin de gérer la configuration, par exemple via Azure Resource Manager. Dans la configuration du réseau virtuel externe, utilisez-les aussi pour le trafic de l’API au moment de l’exécution. Dans la configuration interne du réseau virtuel, utilisez uniquement les adresses IP publiques pour les opérations de gestion interne Azure. Ils n’exposent pas votre instance à Internet.

  • Utilisez des adresses IP virtuelles privées (VIP), disponibles uniquement en mode réseau virtuel interne, pour vous connecter depuis l’intérieur du réseau aux terminaux de gestion API : passerelles, le portail développeur et le plan de gestion pour un accès direct à l’API. Utilisez ces adresses pour configurer des enregistrements DNS au sein du réseau.

Vous voyez des adresses des deux types dans le portail Azure et dans la réponse à un appel API :

Capture d’écran montrant une adresse VIP dans API Management.

GET https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.ApiManagement/service/<service-name>?api-version=<api-version>
{
  ...
  "properties": {
    ...
    "publicIPAddresses": [
      "172.31.0.1"
    ],
    "privateIPAddresses": [
      "192.168.1.5"
    ],
    ...
  },
  ...
}

Important

Les unités internes d’équilibrage de charge et de gestion d’API obtiennent dynamiquement des adresses IP privées. Vous ne pouvez pas anticiper l’IP privée de l’instance de gestion d’API avant son déploiement. De plus, changer de sous-réseau puis le retourner peut provoquer un changement d’adresse IP privée.

Adresses IP pour le trafic sortant

API Management utilise une adresse IP publique pour les connexions à l’extérieur du réseau virtuel ou d’un réseau virtuel appairé. Il utilise une adresse IP privée pour établir une connexion au sein du réseau virtuel ou d’un réseau virtuel mis en peering.

  • Lorsque vous déployez la gestion des API dans un réseau virtuel externe ou interne et qu’elle se connecte à des backends privés (orientés intranet), la gestion des API utilise des adresses IP internes (adresses IP dynamiques, ou adresses DIP) du sous-réseau pour le trafic API à l’exécution. Lorsque la gestion d’API envoie une requête à un backend privé, une adresse IP privée est visible comme origine de la requête.

    Par conséquent, si la restriction d’IP liste des ressources sécurisées au sein du réseau virtuel ou d’un réseau virtuel appairé, utilisez l’intégralité de la plage de sous-réseau de la gestion des API avec une règle d’adresse IP et (en mode interne) pas seulement l’adresse IP privée associée à la ressource API Management.

  • Lorsque la gestion d’API envoie une requête à un backend public (orienté vers Internet), une adresse IP publique est toujours visible comme origine de la requête.

Adresses IP des instances de gestion des API de niveau Consommation, De base v2, Standard v2 et Premium v2

Si vous créez votre instance de gestion d’API dans un niveau de service qui fonctionne sur une infrastructure partagée, elle n’a pas d’adresse IP dédiée. Actuellement, les instances dans les niveaux de service suivant s’exécutent sur une infrastructure partagée et sans aucune adresse IP déterministe : Consommation, Essentiel v2, Standard v2 et Premium v2.

Si vous devez ajouter les adresses IP sortantes utilisées par votre instance Consumption, Basic v2, Standard v2 ou Premium v2 à une liste d'autorisations, vous pouvez ajouter le centre de données de l'instance (région Azure) à une liste d'autorisations. Téléchargez un fichier JSON qui liste les adresses IP de tous les centres de données Azure. Recherchez ensuite le fragment JSON qui s’applique à la région dans laquelle s’exécute votre instance.

Par exemple, le fragment JSON suivant montre à quoi pourrait ressembler la liste des autorisations pour l’Europe occidentale :

{
  "name": "AzureCloud.westeurope",
  "id": "AzureCloud.westeurope",
  "properties": {
    "changeNumber": 9,
    "region": "westeurope",
    "platform": "Azure",
    "systemService": "",
    "addressPrefixes": [
      "13.69.0.0/17",
      "13.73.128.0/18",
      ... Some IP addresses not shown here
     "213.199.183.0/24"
    ]
  }
}

Pour savoir quand ce fichier est mis à jour et quand les adresses IP changent, développez la section Détails de la page du Centre de téléchargement.

Modifications apportées aux adresses IP

Dans les niveaux Développeur, De base, Standard et Premium de Gestion des API, l’adresse IP publique ou les adresses IP virtuelles (VIP) et les adresses IP virtuelles privées (si configurées en mode réseau virtuel interne) sont statiques pour la durée de vie d’un service, à l’exception suivante :

  • La gestion des API est supprimée, puis recréée.

  • L’abonnement au service est désactivé ou fait l’objet d’un avertissement (par exemple, pour non-paiement), puis est rétabli. En savoir plus sur les États d’abonnement.

  • (Niveaux Développeur et Premium) Le Réseau virtuel Azure est ajouté au service ou supprimé de celui-ci.

  • (niveaux Développeur et Premium) API Management peut être basculé entre les modes de déploiement sur réseau virtuel externe et interne.

  • (Niveaux Développeur et Premium) Gestion des API est déplacée vers un sous-réseau différent ou configurée avec une autre ressource d’adresse IP publique.

  • (Niveau Premium) Les zones de disponibilité sont activées, ajoutées ou supprimées.

  • (Niveau Premium) Dans les déploiements multirégionaux, l'adresse IP régionale change si une région est libérée, puis rétablie.

    Important

    Lorsque vous passez d’un réseau virtuel interne à un réseau virtuel externe ou que vous modifiez des sous-réseaux dans le réseau, vous pouvez configurer une autre adresse IP publique. Si vous n’en fournissez pas, une adresse IP publique gérée par Azure est automatiquement configurée.