Resource provider source IP address updates (September 2023)

Availability

Important

This feature is available in the Premium and Developer tiers of API Management.

On 30 September 2023 as part of our continuing work to increase the resiliency of API Management services, we're making the resource providers for Azure API Management zone redundant in each region. The IP address that the resource provider uses to communicate with your service will change if it's located in Switzerland North:

  • Old IP address: 51.107.0.91
  • New IP address: 51.107.246.176

This change will have no effect on the availability of your API Management service. However, you may have to take steps described below to configure your API Management service beyond 30 September 2023.

Is my service affected by this change?

Your service is impacted by this change if:

  • The API Management service is in the Switzerland North region.
  • The API Management service is running inside an Azure virtual network.
  • The network security group (NSG) or user-defined routes (UDRs) for the virtual network are configured with explicit source IP addresses.

What is the deadline for the change?

The source IP addresses for the affected region will be changed on 30 September 2023. Complete all required networking changes before then.

After 30 September 2023, if you prefer not to make changes to your IP addresses, your services will continue to run but you won't be able to add or remove APIs, or change API policy, or otherwise configure your API Management service.

Can I avoid this sort of change in the future?

Yes, you can.

API Management publishes a service tag that you can use to configure the NSG for your virtual network. The service tag includes information about the source IP addresses that API Management uses to manage your service. For more information on this article, read Configure NSG Rules in the API Management documentation.

What do I need to do?

Update the NSG security rules that allow the API Management resource provider to communicate with your API Management instance. For detailed instructions on how to manage an NSG, review Create, change, or delete a network security group in the Azure virtual network documentation.

  1. Go to the Azure portal to view your NSGs. Search for and select Network security groups.

  2. Select the name of the NSG associated with the virtual network hosting your API Management service.

  3. In the menu bar, choose Inbound security rules.

  4. The inbound security rules should already have an entry that mentions a source address matching the Old IP address from the table above. If it doesn't, you're not using explicit source IP address filtering, and can skip this update.

  5. Select Add.

  6. Fill in the form with the following information:

    1. Source: Service Tag
    2. Source Service Tag: ApiManagement
    3. Source port ranges: *
    4. Destination: VirtualNetwork
    5. Destination port ranges: 3443
    6. Protocol: TCP
    7. Action: Allow
    8. Priority: Pick a suitable priority to place the new rule next to the existing rule.

    The Name and Description fields can be set to anything you wish. All other fields should be left blank.

  7. Select OK.

In addition, you may have to adjust the network routing for the virtual network to accommodate the new control plane IP addresses. If you've configured a default route (0.0.0.0/0) forcing all traffic from the API Management subnet to flow through a firewall instead of directly to the Internet, then more configuration is required.

If you configured user-defined routes (UDRs) for control plane IP addresses, the new IP addresses must be routed the same way. For more details on the changes necessary to handle network routing of management requests, review Force tunneling traffic documentation.

Finally, check for any other systems that may impact the communication from the API Management resource provider to your API Management service subnet. For more information about virtual network configuration, review the Virtual Network documentation.

More information

Next steps

See all upcoming breaking changes and feature retirements.