Integrate Microsoft Entra application proxy with SharePoint (SAML)
This step-by-step guide explains how to secure the access to the Microsoft Entra integrated on-premises SharePoint (SAML) using Microsoft Entra application proxy, where users in your organization (Microsoft Entra ID, B2B) connect to SharePoint through the Internet.
If you're new to Microsoft Entra application proxy and want to learn more, see Remote access to on-premises applications through Microsoft Entra application proxy.
There are three primary advantages of this setup:
- Microsoft Entra application proxy ensures that authenticated traffic can reach your internal network and SharePoint.
- Your users can access SharePoint sites as usual without using VPN.
- You can control the access by user assignment on the Microsoft Entra application proxy level and you can increase the security with Microsoft Entra features like Conditional Access and Multi-Factor Authentication (MFA).
This process requires two Enterprise Applications. One is a SharePoint on-premises instance that you publish from the gallery to your list of managed SaaS apps. The second is an on-premises application (non-gallery application) you'll use to publish the first Enterprise Gallery Application.
To complete this configuration, you need the following resources:
- A SharePoint 2013 farm or newer. The SharePoint farm must be integrated with Microsoft Entra ID.
- A Microsoft Entra tenant with a plan that includes Application Proxy. Learn more about Microsoft Entra ID plans and pricing.
- A custom, verified domain in the Microsoft Entra tenant. The verified domain must match the SharePoint URL suffix.
- An SSL certificate is required. See the details in custom domain publishing.
- On-premises Active Directory users must be synchronized with Microsoft Entra Connect, and must be configure to sign in to Azure.
- For cloud-only and B2B guest users, you need to grant access to a guest account to SharePoint on-premises in the Microsoft Entra admin center.
- An Application Proxy connector installed and running on a machine within the corporate domain.
Step 1: Integrate SharePoint on-premises with Microsoft Entra ID
- Configure the SharePoint on-premises app. For more information, see Tutorial: Microsoft Entra single sign-on integration with SharePoint on-premises.
- Validate the configuration before moving to the next step. To validate, try to access the SharePoint on-premises from the internal network and confirm it's accessible internally.
Step 2: Publish the SharePoint on-premises application with Application Proxy
In this step, you create an application in your Microsoft Entra tenant that uses Application Proxy. You set the external URL and specify the internal URL, both of which are used later in SharePoint.
The Internal and External URLs must match the Sign on URL in the SAML Based Application configuration in Step 1.
Create a new Microsoft Entra application proxy application with custom domain. For step-by-step instructions, see Custom domains in Microsoft Entra application proxy.
Internal URL: 'https://portal.contoso.com/'
External URL: 'https://portal.contoso.com/'
Pre-Authentication: Microsoft Entra ID
Translate URLs in Headers: No
Translate URLs in Application Body: No
Assign the same groups you assigned to the on-premises SharePoint Gallery Application.
Finally, go to the Properties section and set Visible to users? to No. This option ensures that only the icon of the first application appears on the My Apps Portal (https://myapplications.microsoft.com).
Step 3: Test your application
Using a browser from a computer on an external network, navigate to the link that you configured during the publish step. Make sure you can sign in with the test account that you set up.