{"id":11229,"date":"2022-08-11T09:40:21","date_gmt":"2022-08-11T16:40:21","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=11229"},"modified":"2022-10-12T16:05:38","modified_gmt":"2022-10-12T23:05:38","slug":"updates-on-controlling-app-specific-access-on-specific-sharepoint-sites-sites-selected","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/updates-on-controlling-app-specific-access-on-specific-sharepoint-sites-sites-selected\/","title":{"rendered":"Updates on controlling app specific access on specific SharePoint sites (Sites.Selected)"},"content":{"rendered":"<p>In February 2021, we <a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/controlling-app-access-on-specific-sharepoint-site-collections\/\">announced<\/a> a new permission to grant Microsoft Graph applications access to specific site collections. Using Sites.Selected along with the Sites permissions endpoint in Microsoft Graph<strong> allows you to set the specific site collections and access level you want to grant to individual applications<\/strong>. There are two things we\u2019d like to provide an update on today, using Sites.Selected for legacy SharePoint APIs, and the availability and supported status of this feature.<\/p>\n<h2>Sites.Selected for SharePoint CSOM \/ REST<\/h2>\n<p>Although we are Microsoft Graph forward in our plans and direction, we recognize that many of you are still leveraging capabilities from our legacy APIs in SharePoint CSOM or REST. To ease the transition to Microsoft Graph and allow for hybrid scenarios to take advantage of the new permission we have added the Sites.Selected permission to be available for SharePoint permissions as well.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2022\/08\/sitesselected.png\"><img decoding=\"async\" class=\"size-full wp-image-11230 aligncenter\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2022\/08\/sitesselected.png\" alt=\"Image sitesselected\" width=\"910\" height=\"771\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2022\/08\/sitesselected.png 910w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2022\/08\/sitesselected-300x254.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2022\/08\/sitesselected-768x651.png 768w\" sizes=\"(max-width: 910px) 100vw, 910px\" \/><\/a><\/p>\n<p>To take advantage of Sites.Selected for SharePoint APIs you will still need to use the Microsoft Graph API for setting the app permissions, however once set the permissions apply to access through either Microsoft Graph or SharePoint legacy APIs.<\/p>\n<p>The workflow can generally be considered:<\/p>\n<ol>\n<li>In application registration request Sites.Selected permission for either or both Microsoft Graph or SharePoint<\/li>\n<li>Use Microsoft Graph Permissions endpoint point on Sites to configure the access you require<\/li>\n<li>Make API calls as normal in your client application<\/li>\n<\/ol>\n<p>&nbsp;<\/p>\n<h2>Availability and supportability status<\/h2>\n<p>We have received several inquiries about the release status of Sites.Selected. For those who may be concerned, we would like to clarify that <strong>Sites.Selected and the Permissions API for Sites are both fully Generally Available and supported for use<\/strong>. This applies to <strong>both<\/strong> Microsoft Graph and SharePoint legacy API usage.<\/p>\n<p>For more information on using Sites.Selected, you can check out our <a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/controlling-app-access-on-specific-sharepoint-site-collections\/\">original announcement<\/a>, or watch this <a href=\"https:\/\/youtu.be\/SNIF3zCYNUk\">video<\/a> by Paolo Pialorsi (PiaSys) taken from the <a href=\"https:\/\/aka.ms\/m365\/community\">Microsoft 365 Platform Community<\/a> call recording.<\/p>\n<p><iframe title=\"Understanding Sites.Selected permissions in SharePoint Online\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/SNIF3zCYNUk?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Learn about updates about Sites permissions in Microsoft Graph using Sites.Selected for legacy SharePoint APIs, and the availability and supported status of this feature.<\/p>\n","protected":false},"author":69078,"featured_media":11235,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3,166],"tags":[146,200],"class_list":["post-11229","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","category-sharepoint","tag-microsoft-graph-api","tag-sites-and-lists"],"acf":[],"blog_post_summary":"<p>Learn about updates about Sites permissions in Microsoft Graph using Sites.Selected for legacy SharePoint APIs, and the availability and supported status of this feature.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/11229","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69078"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=11229"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/11229\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/11235"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=11229"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=11229"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=11229"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}