Get started with Application Proxy and install the connector

This article walks you through the steps to enable Microsoft Azure AD Application Proxy for your cloud directory in Azure AD.

If you're unfamiliar with what Application Proxy can help you do, learn more about How to provide secure remote access to on-premises applications.

Application Proxy prerequisites

Before you can enable and use Application Proxy services, you need to have:

  • A Microsoft Azure AD basic or premium subscription and an Azure AD directory for which you are a global administrator.
  • A server running Windows Server 2012 R2, or Windows 8.1 or higher, on which you can install the Application Proxy Connector. The server sends requests to the Application Proxy services in the cloud, and it needs an HTTP or HTTPS connection to the applications that you are publishing.
    • For single sign-on to your published applications, this machine should be domain-joined in the same AD domain as the applications that you are publishing. For information, see Single sign-on with Application Proxy

If your organization uses proxy servers to connect to the internet, read Work with existing on-premises proxy servers for details on how to configure them.

Open your ports

If there is a firewall in the path, make sure that it's open so that the Connector can make HTTPS (TCP) requests to the Application Proxy. The Connector uses these ports together with subdomains that are part of the high-level domains msappproxy.net and servicebus.windows.net. Make sure to open the following ports to outbound traffic:

Port Number Description
80 Enable outbound HTTP traffic for security validation.
443 Enable user authentication against Azure AD (required only for the Connector registration process)
Enable the connector bootstrap sequence and automatic updates
Enable communication between the connector and the Azure service for incoming requests
10100–10120 Enable LOB HTTP responses sent back to the proxy
9350 Optional, to enable better performance for incoming requests
8080 Enable the connector bootstrap sequence and connector automatic update
9090 Enable connector registration (required only for the connector registration process)
9091 Enable connector trust certificate automatic renewal
Important

The table reflects the port requirements for the most recent version of the connector. If you still have a connector that's older than version 1.5, you also need to enable 9350, 9352, and 5671. These ports enable communication between the older connectors and the Azure service for incoming requests.

If your firewall enforces traffic according to originating users, open these ports for traffic coming from Windows services running as a Network Service. Also, make sure to enable port 8080 for NT Authority\System.

Use the Azure AD Application Proxy Connector Ports Test Tool to verify that your connector can reach the Application Proxy service. At a minimum, make sure that the Central US region and the region closest to you have all green checkmarks. Beyond that, more green checkmarks means greater resiliency.

Install and register a connector

  1. Sign in as an administrator in the Azure portal.
  2. Your current directory appears under your username in the top right corner. If you need to change directories, select that icon.
  3. Go to Azure Active Directory > Application Proxy.

    Navigate to Application Proxy

  4. Select Download Connector.

    Download Connector

  5. Run AADApplicationProxyConnectorInstaller.exe on the server you prepared according to the prerequisites.

  6. Follow the instructions in the wizard to install.
  7. During installation, you are prompted to register the connector with the Application Proxy of your Azure AD tenant.

    • Provide your Azure AD global administrator credentials. Your global administrator tenant may be different from your Microsoft Azure credentials.
    • Make sure the admin who registers the connector is in the same directory where you enabled the Application Proxy service. For example, if the tenant domain is contoso.com, the admin should be admin@contoso.com or any other alias on that domain.
    • If IE Enhanced Security Configuration is set to On on the server where you are installing the connector, the registration screen might be blocked. Follow the instructions in the error message to allow access. Make sure that Internet Explorer Enhanced Security is off.
    • If connector registration does not succeed, see Troubleshoot Application Proxy.
  8. When the installation completes, two new services are added to your server:

    • Microsoft AAD Application Proxy Connector enables connectivity

    • Microsoft AAD Application Proxy Connector Updater is an automated update service, which periodically checks for new versions of the connector and updates the connector as needed.

    App Proxy Connector services - screenshot

For information about connectors, see Understand Azure AD Application Proxy connectors.

For high availability purposes, you should deploy at least two connectors. To deploy more connectors, repeat steps 2 and 3. Each connector must be registered separately.

If you want to uninstall the Connector, uninstall both the Connector service and the Updater service. Restart your computer to fully remove the service.

Next steps

You are now ready to Publish applications with Application Proxy.

If you have applications that are on separate networks or different locations, you can use connector groups to organize the different connectors into logical units. Learn more about Working with Application Proxy connectors.