Providing secure, identity-based access to private apps and resources without traditional VPNs
The behavior described (changes apparently saving but reverting on refresh) is typically caused by an invalid or incomplete application proxy configuration, especially around internal/external URLs and custom domains.
From the available guidance, focus on these areas when troubleshooting:
- Verify internal vs. external URL relationship
- Application proxy expects a valid internal URL and an external URL that it can map correctly.
- Best practice is to keep internal and external URLs identical in
protocol://hostname:port/path/where possible. This avoids complex link translation and configuration issues. - If using a custom external domain (for example,
appname.contoso.com) instead of the default*.msappproxy.net, ensure that:- The internal URL is valid and reachable by the connector (for example,
https://appname.contoso.com/appweb/). - If the internal URL uses a nonstandard port (not 80/443), identical internal/external URLs are not possible and additional configuration in the web app may be required.
- The internal URL is valid and reachable by the connector (for example,
- Ensure custom domain prerequisites are met
- Changing the external URL from
*.msappproxy.netto a vanity domain such asappname.contoso.comrequires the custom domains feature. - The custom domain must be configured correctly (DNS and certificate) for application proxy. If the custom domain configuration is invalid, the portal can show errors such as
A server with the specified host name could not be foundwhen users access the app. - Confirm that the custom domain is configured and validated according to the custom domain guidance before changing the external URL.
- Changing the external URL from
- Check for broken-link and root URL issues
- After publishing an app, only links under the published root URL work by default. If the internal URL or external URL is not set to a root that contains all relevant paths, the service may treat parts of the configuration as invalid.
- Ensure the internal URL you enter is the correct root for the application and that it is consistent with how the app is expected to be accessed.
- Validate connector and service health
- Confirm that the Microsoft Entra private network connector service is running and healthy:
- In Services, verify the connector service is running.
- In Event Viewer, check
Applications and Services Logs > Microsoft > Microsoft Entra private network > Connector > Adminfor connector errors.
- If the connector is misconfigured or cannot reach the app, the portal may accept changes but the backend validation can fail and revert to the last known good configuration.
- Confirm that the Microsoft Entra private network connector service is running and healthy:
- Use the official troubleshooting flow
- Follow the application proxy troubleshooting flow:
- Step 1–2: Confirm sign-in and user access work for the existing configuration.
- Step 3: After attempting to change the internal/external URLs, check for any immediate errors or logs indicating misconfiguration.
- If the connector is configured to use an on-premises proxy, verify HTTPS connectivity from the connector to the proxy and look for HTTP 407/502 responses that might block configuration validation.
- Follow the application proxy troubleshooting flow:
- SAML/SSO considerations (if applicable)
- If the app uses SAML SSO, ensure that the external URL used in application proxy is also reflected in the SAML configuration (Identifier, Reply URL, Logout URL). Mismatches can cause the app to fail validation.
- If the backend app expects the internal URL as Reply URL, either configure custom domains so internal and external URLs match or use the My Apps secure sign-in extension.
If, after verifying the above, the portal still reverts the configuration with no visible error, collect connector logs and portal screenshots and open a support case, as backend validation or policy constraints in the tenant may be preventing the change.
References:
- Microsoft Entra application proxy frequently asked questions
- Broken links in an application proxy app
- Troubleshoot application proxy issues and errors
- Debug application proxy issues
- Security Assertion Markup Language (SAML) single sign-on (SSO) for on-premises apps with Microsoft Entra application proxy
- Work with existing on-premises proxy servers