Skip to main content

Granting BidScript access to selected SharePoint sites

Limit BidScript to the SharePoint sites you choose, grant each site with PnP PowerShell or Graph Explorer, and add it to your workspace.

T
Written by Tyler McCarthy

Selected sites lets BidScript read only the SharePoint sites your organisation chooses. A Microsoft admin approves BidScript once, then your SharePoint admin grants it read access to each site, and a BidScript Admin adds those sites to your workspace.

This article covers how to choose Selected sites, how your SharePoint admin grants a site, and how to add, check and remove sites in BidScript.

Where to find it

  • In the left-hand sidebar, click Settings.

  • Open Integrations and find the SharePoint admin approval card.

Who does what

Microsoft admin

A Global Administrator or Privileged Role Administrator approves BidScript once for your organisation.

SharePoint admin

Grants BidScript read access to each site. This needs the SharePoint Administrator role or the Sites.FullControl.All permission. BidScript never holds either, so it can't grant itself access to a site.

BidScript Admins

Choose the access level, request approval, and add or remove sites in BidScript. Other roles can see the card but can't change it.

Choosing Selected sites

  1. On the SharePoint admin approval card, under What BidScript can read, select Selected sites.

  2. Click Get admin approval.

  3. Sign in to Microsoft as a Global Administrator or Privileged Role Administrator and accept the request.

When you return to BidScript the card shows the approval date and an empty list of sites. BidScript can't read any site yet. Your SharePoint admin grants each one next.

Note: To move between All sites and Selected sites later, disconnect SharePoint admin approval and approve again with the other option.

Granting BidScript access to a site

Your SharePoint admin grants read access once per site collection. A grant covers the site and every subsite under it. You'll need two things before you start.

  • The site address, for example https://yourcompany.sharepoint.com/sites/Bids.

  • The application ID of the BidScript app for selected sites. Find it in the Microsoft Entra admin centre under Enterprise applications once approval is complete, or ask our support team.

Use whichever of the two routes below suits your admin.

With PnP PowerShell

Best for admins who already manage SharePoint from PowerShell.

  1. Connect to the site with Connect-PnPOnline -Url https://yourcompany.sharepoint.com/sites/Bids -Interactive -ClientId <your PnP app ID>.

  2. Run Grant-PnPAzureADAppSitePermission -AppId <BidScript application ID> -DisplayName "BidScript" -Site https://yourcompany.sharepoint.com/sites/Bids -Permissions Read.

  3. Repeat for each site BidScript should read.

Tip: Recent versions of PnP PowerShell also name this command Grant-PnPEntraIDAppSitePermission. Both take the same parameters.

With Graph Explorer

Best where your admin prefers a browser to PowerShell.

  1. Open Graph Explorer and sign in as your SharePoint admin.

  2. Consent to the Sites.FullControl.All permission when Graph Explorer asks for it.

  3. Look up the site ID with a GET request to https://graph.microsoft.com/v1.0/sites/yourcompany.sharepoint.com:/sites/Bids and copy the id value from the response.

  4. Send a POST request to https://graph.microsoft.com/v1.0/sites/<site ID>/permissions with this request body.

{  "roles": ["read"],  "grantedToIdentities": [    { "application": { "id": "<BidScript application ID>", "displayName": "BidScript" } }  ]}

A successful grant returns the new permission with the role read.

Adding a site in BidScript

  1. On the SharePoint admin approval card, paste the site address into the box under Sites BidScript can read.

  2. Click Add site.

BidScript checks the site with Microsoft before adding it. You can paste the site's home page address, a Teams site address, or a sharing link to any file in the site. If the grant isn't in place yet you'll see a message asking you to check the address and the grant. Once a site is on the list you can sync its libraries as usual.

Searching SharePoint with Selected sites

Search across all of SharePoint isn't available with Selected sites, because Microsoft only allows it for apps that can read every site. Open a site from the list and search inside it instead.

Removing access to a site

To stop BidScript reading a site, ask your SharePoint admin to remove the grant, then remove the site from the list in BidScript.

  • In BidScript: Click the remove button beside the site on the Sites BidScript can read list.

  • In SharePoint: Your admin removes the BidScript permission from the site with PnP PowerShell or Graph Explorer.

If the grant is removed first, the site stays on the list and its synced libraries show Access removed after their next sync. Remove the site in BidScript, or ask your admin to grant access again.

What each message means

BidScript can't read this site

The address is wrong, or your SharePoint admin hasn't granted BidScript read access to the site yet.

Access removed

BidScript could read the site before but can't now. Ask your SharePoint admin whether the grant was removed.

We couldn't reach SharePoint to check this site

Microsoft didn't respond in time. Try again in a few minutes.

Best practice

  • Grant only the sites your bid team draws on, such as the site that holds approved case studies and policies.

  • Keep a record of which sites you've granted, so you can review them when your bid content moves.

  • Expect changes in a selected site to reach BidScript within the hour.

Related articles

Did this answer your question?