Restrict SharePoint site access with Microsoft 365 groups and Entra security groups

Some features in this article require Microsoft SharePoint Premium - SharePoint Advanced Management

You can restrict access to SharePoint sites and content to users in a specific group by using a site access restriction policy. Users not in the specified group can't access the site or its content, even if they had prior permissions or a shared link. This policy can be used with Microsoft 365 group-connected, Teams-connected, and non-group connected sites.

Site access restriction policies are applied when a user attempts to open a site or access a file. Users with direct permissions to the file can still view files in search results. However, they can't access the files if they're not part of the specified group.

Restricting site access via group membership can minimize the risk of oversharing content. For insights into data sharing, see Data access governance reports.

Prerequisites

The site access restriction policy requires Microsoft SharePoint Premium - SharePoint Advanced Management.

Enable site-level access restriction for your organization

You must enable site-level access restriction for your organization before you can configure it for individual sites.

To enable site-level access restriction for your organization in SharePoint admin center:

1. Expand Policies and select Access control.

2. Select Site-level access restriction.

3. Select Allow access restriction and then select Save.

   

To enable site-level access restriction for your organization using PowerShell, run the following command:

Set-SPOTenant -EnableRestrictedAccessControl $true

It might take up to one hour for command to take effect

Note

For Microsoft 365 Multi-Geo users, run this command separately for each desired geo-location.

Restrict access to group-connected sites (Microsoft 365 Groups and Teams)

Site access restriction policy for group-connected sites restricts SharePoint site access to members of the Microsoft 365 group or team associated with the site.

To manage site access restriction for a group-connected site in SharePoint admin center

1. In SharePoint admin center, expand Sites and select Active sites.
2. Select the site you want to manage and the site details panel appears.
3. In the Settings tab, select Edit in the Restricted site access section.
4. Select the Restrict access to this site box and select Save.

To manage site access restriction for group-connected sites using PowerShell, use the following commands:

Action	PowerShell command
Enable site access restriction for group-connected site	Set-SPOSite -Identity <siteurl> -RestrictedAccessControl $true
View site access restriction for group-connected site	Get-SPOSite -Identity <siteurl> -Select RestrictedAccessControl
Disable site access restriction for group-connected site	Set-SPOSite -Identity <siteurl> -RestrictedAccessControl $false

Restrict site access to non-group connected sites

You can restrict access to non-group connected sites by specifying Entra security groups or Microsoft 365 groups that contain the people who should be allowed access to the site. You can configure up to 10 Entra security groups or Microsoft 365 groups. Once the policy is applied, users in the specified group who have site access permissions are granted access to the site and its content. You can use dynamic security groups if you want to base group membership on user properties.

To manage site access to a non-group connected site:

1. In SharePoint admin center, expand Sites and select Active sites.
2. Select the site you want to manage and the site details panel appears.
3. In Settings tab, select Edit in the Restricted site access section.
4. Select the Restrict SharePoint site access to only users in specified groups check box.
5. Add or remove your security groups or Microsoft 365 groups and select Save.

In order for site access restriction to be applied to the site, you must add at least one group to the site access restriction policy.

To manage site access restriction for non-group connected sites using PowerShell, use the following commands:

Action	PowerShell command
Enable site access restriction	Set-SPOSite -Identity <siteurl> -RestrictedAccessControl $true
Add group	Set-SPOSite -Identity <siteurl> -AddRestrictedAccessControlGroups <comma separated group GUIDS>
Edit group	Set-SPOSite -Identity <siteurl> -RestrictedAccessControlGroups <comma separated group GUIDS>
View group	Get-SPOSite -Identity <siteurl> Select RestrictedAccessControl, RestrictedAccessControlGroups
Remove group	Set-SPOSite -Identity <siteurl> -RemoveRestrictedAccessControlGroups <comma separated group GUIDS>
Reset site access restriction	Set-SPOSite -Identity <siteurl> -ClearRestrictedAccessControl

Shared and private channel sites

Shared and private channel sites are separate from the Microsoft 365 group-connected site that standard channels use. Because shared and private channel sites aren't connected to the Microsoft 365 group, site access restriction policies applied to the team don't affect them. You must enable site access restriction for each shared or private channel site separately as non-group connected sites.

For shared channel sites, only internal users in the resource tenant are subject to site access restriction. External channel participants are excluded from site access restriction policy and only evaluated per the site's existing site permissions.

Important

Adding people to the security group or Microsoft 365 group won't give users access to the channel in Teams. It is recommended to add or remove the same users of the teams channel in Teams and the security group or Microsoft 365 group so users have access to both Teams and SharePoint.

Configure learn more link for access denial error page

Configure your learn more link to inform users who were denied access to a SharePoint site due to the restricted site access control policy. With this customizable error link, you can provide more information and guidance to your users.

Note

The learn more link is a tenant-level setting that applies to all sites that have restricted access control policy enabled.

To configure the link, run the following command in SharePoint PowerShell:

Set-SPOTenant -RestrictedAccessControlForSitesErrorHelpLink “<Learn more URL>” 

To fetch the value of the link, run the following command:

Get-SPOTenant | select RestrictedAccessControlForSitesErrorHelpLink 

The configured learn more link is launched when the user selects the Know more about your organization’s policies here link.

Restricted site access policy insights

As an IT administrator, you can view the following reports to gain more insight on SharePoint and OneDrive sites protected with restricted site access policy:

• Sites protected by restricted site access policy (RACProtectedSites)
• Details of access denials due to restricted site access (ActionsBlockedByPolicy)

Note

It can take a few hours to generate each report.

Sites protected by restricted site access policy report (preview)

You can run the following commands in SharePoint PowerShell to generate, view, and download the reports:

Action	PowerShell command	Description
Generate report	Start-SPORestrictedAccessForSitesInsights -RACProtectedSites	Generates a list of site protected by restricted site access policy
View report	Get-SPORestrictedAccessForSitesInsights -RACProtectedSites -ReportId <Report GUID>	The report shows the top 100 sites with the highest page views that are protected by the policy.
Download report	Get-SPORestrictedAccessForSitesInsights -RACProtectedSites -ReportId <Report GUID> -Action Download	This command must be run as an administrator. The downloaded report is located on the path where the command was run.
Percentage of site protected with restricted site access report	Get-SPORestrictedAccessForSitesInsights -RACProtectedSites -ReportId <Report GUID> -InsightsSummary	This report shows the percentage of sites that are protected by the policy out of the total number of sites

Access denials due to restricted site access policy

You can run the following commands to create, fetch, and view report for access denials due to restricted site access reports:

Action	PowerShell command	Description
Create access denials report	Start-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy	Creates a new report for fetching access denial details
Fetch access denials report status	Get-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy	Fetches the status of the generated report.
Last 100 access denials in the past 28 days report	Get-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy -ReportId <Report ID> -Content AllDenials	Gets a list of the most recent 100 access denials that occurred in the past 28 days
Top 100 users denied access report	Get-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy -ReportId <Report ID> -Content TopUsers	Gets a list of the top 100 users who received the most access denials
View list of top sites that received the most access denials	Get-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy -ReportId <Report ID> -Content TopSites	Gets a list of the top 100 sites that had the most access denials
Distribution of access denials across different types of sites report	Get-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy -ReportId <Report ID> -Content SiteDistribution	This command must be run as an administrator in order to download the report. Shows the distribution of access denials across different types of sites

Note

To view up to 10,000 denials, you must download the reports. The downloaded reports will be located on the path from where command was run.

Auditing

Audit events are available in the Purview compliance portal to help you monitor site access restriction activities. Audit events are logged for the following activities:

• Applying site access restriction for site
• Removing site access restriction for site
• Changing site access restriction groups for site

Related articles

Conditional access policy for SharePoint sites and OneDrive

Data Access Governance reports