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 2016, 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

To prepare your environment for Azure AD Application Proxy, you first need to enable communication to Azure data centers. 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.

  1. Open the following ports to outbound traffic:

    Port number How it's used
    80 Downloading certificate revocation lists (CRLs) while validating the SSL certificate
    443 All outbound communication with the Application Proxy service

    If your firewall enforces traffic according to originating users, open these ports for traffic coming from Windows services running as a Network Service.

    Important

    The table reflects the port requirements for connector versions 1.5.132.0 and newer. If you still have an older connector version, you also need to enable the following ports: 5671, 8080, 9090, 9091, 9350, 9352, and 10100–10120.

    For information about updating your connectors to the newest version, see Understand Azure AD Application Proxy connectors.

  2. If your firewall or proxy allows DNS whitelisting, you can whitelist connections to msappproxy.net and servicebus.windows.net. If not, you need to allow access to the Azure DataCenter IP ranges which are updated each week.

  3. 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.