Opti'

Grant a SharePoint site to Opti'

For the Microsoft 365 administrator of your organization (SharePoint Administrator or Global Administrator role). Ten minutes, once.

What you grant. Opti' only reaches the site you grant it. It reads neither the files of your other sites, nor OneDrive, nor the list of your sites. It also acts with the rights of the signed-in person: it can never do more than they can on that site. You can remove this access whenever you want (see the last section).

One limit, set by Microsoft: without any grant, an application can read the names of the libraries of a site where the person has rights, never their content.

Fill in these fields: the requests to copy below fill themselves in.

Choose the setup

1. Create the site reserved for Opti'

  1. On the SharePoint home page: + Create site > Communication site > template Standard.
  2. Site name: Opti (no apostrophe: the address becomes …/sites/Opti). Create, and leave it empty.
  3. Add the people who will use Opti' as members of the site.
  4. Copy the site address into the first field at the top of this page.

2. Open Graph Explorer as administrator

  1. Open Microsoft Graph Explorer and sign in (top right) with your administrator account.
  2. Open the permissions panel (Permissions), search for Sites.FullControl.All in its search bar, click Consent and accept.

This permission is given to Graph Explorer, not to Opti'. You remove it in step 5.

3. Read the site identifier

Method GET, paste this address, then Run query:

https://graph.microsoft.com/v1.0/sites/your-organization.sharepoint.com:/sites/Opti?$select=id,webUrl

In the answer, check that webUrl is indeed your site address. Copy the value of id (three parts separated by commas, without the quotes) and paste it here:

4. Grant the site to Opti'

Method POST, paste this address:

https://graph.microsoft.com/v1.0/sites/ID-SITE/permissions

In the Request body tab, just below the address bar, paste:

{ "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "af692652-622c-4033-af23-2eb8483dead5", "displayName": "Opti'" } }] }

Run query. Expected answer: 201 Created, with fullcontrol in roles. Copy the id of the answer (the grant's) and paste it here, so you can remove it later:

Never grant the role owner. Microsoft accepts it but records it as none: Opti' then has access to nothing. Only fullcontrol and write work. "Empty Payload" in the answer means the Request body tab was left empty.

5. Clean up Graph Explorer

By consenting in step 2, Microsoft added Graph Explorer to your applications by itself, under the name Graph Explorer, with the Sites.FullControl.All permission on all your sites. Remove it now: Microsoft Entra admin center > Enterprise applications (the list hides Microsoft's own applications by default: remove the "Application type" filter or choose All applications, then search for "Graph") > Graph Explorer > Properties > Delete. The grant made to Opti' in step 4 stays in place. For the strict setup, do step 6 first.

Then, for each person

In Opti': My account > Storage, site address, then Connect SharePoint. On the first connection, Microsoft may ask an administrator to consent for the organization: Opti' only asks for access to the granted sites and to read the person's profile.

6. Strict setup: switch to write

Once a person has connected Opti' (the "Opti" library then exists), in Graph Explorer:

  1. Remove the full control grant: the DELETE request of the "Remove the access" section below. Expected answer: 204.
  2. Repeat step 4 (same address, POST method), with this body:
    { "roles": ["write"], "grantedToIdentities": [{ "application": { "id": "af692652-622c-4033-af23-2eb8483dead5", "displayName": "Opti'" } }] }

With write access, if a future version of Opti' needs one more column, Opti' will tell the person and send you back here: switch back to full control for one connection.

Remove the access

Files already stored stay in the site: they are ordinary files (Word, Excel, PowerPoint, PDF), readable without Opti'. For everything Opti' does with data, see Opti' security.