Skip to content

Releases

v1.7.2

Choose a tag to compare

@github-actions github-actions released this 12 Nov 03:22

Installation

  1. Download smart-permissions.sppkg
  2. Upload to your SharePoint App Catalog
  3. Deploy tenant-wide or to specific sites
  4. Grant the required Microsoft Graph API permissions in the SharePoint Admin Center

Changed

  • Permissions Explorer — library permissions on load
    The permissions panel now shows the selected library's own permissions as
    soon as it loads, instead of an empty "Select a folder or file" message.
  • Permissions Explorer — "Show parent permissions" is on by default
    Inherited items show where their permissions come from without an extra
    click. The checkbox is still there to turn it off.

Fixed

  • Folders starting with an underscore were hidden
    The Permissions Explorer, Permissions Report, and User Access tools skipped
    every folder whose name began with _, so real folders such as
    _Sales Manager never appeared and any unique permissions on them were
    missed. Only SharePoint's own system folders are skipped now: Forms,
    _cts, _w, _t, _private, _catalogs, _layouts, and _vti_*
    (matched case-insensitively).
  • Forms folder shown in the Permissions Explorer
    The Explorer tree listed Forms while the report and User Access scans
    skipped it. All three tools now hide it consistently.

v1.7.1

Choose a tag to compare

@github-actions github-actions released this 05 Nov 16:29

Installation

  1. Download smart-permissions.sppkg
  2. Upload to your SharePoint App Catalog
  3. Deploy tenant-wide or to specific sites
  4. Grant the required Microsoft Graph API permissions in the SharePoint Admin Center

Added

  • Permissions Report — risk summary
    A row of one-click filter buttons above the results shows counts for
    Everyone access, External users, Full Control (non-owners), and
    Unconfirmed items, and filters the table to just those entries.
  • Permissions Report — open and copy links
    Each result row has an "Open in SharePoint" link and a "Copy path" button.
  • Permissions Report — view saved reports
    A "View" button on each History row opens a saved report in the web part,
    with a banner marking it as a saved report. History is now kept separately
    for each site, and a "Clear history" button removes everything after a
    confirmation.
  • User Access — "Access via" column
    Shows the group or assignment that grants the access at each location,
    sortable on screen and included in the Excel export.
  • Permissions Explorer — nested Entra groups
    A group inside an Entra group is now shown as a Security Group row with
    its members indented beneath it, down to five levels, instead of appearing
    as a user. Groups that contain each other are expanded only once. The same
    expansion applies in the Permissions Report.
  • Permissions Explorer — remembers the library
    Opens on Shared Documents the first time, then on the last library picked
    for that site.
  • Property pane options
    Toggles to hide the Permissions Report, Permissions Explorer, or User
    Access card, plus a default site URL and a lock that removes the Change URL
    link for viewers.
  • Home screen shows the connected site
    The brand banner with the site URL, Change URL, and Settings now appears on
    the home screen as well as the tool screens.

Changed

  • Confirmations before losing work
    Leaving a screen during a scan, deleting a saved report, and clearing
    history now ask first, using a dialog instead of a browser prompt.
  • User Access — accuracy
    Access through Entra and Microsoft 365 groups, including groups inside
    SharePoint groups, is now resolved from the user's group memberships, and
    locations that could not be fully checked are flagged as possibly incomplete.
  • Clearer states
    Added a "no results match the current filters" message, a notice when scan
    options change after results were produced, a retry button when a library
    fails to load, and a hint when the user list is truncated.
  • Export safety
    CSV cells that begin with =, +, -, or @ are prefixed so spreadsheet
    apps open them as text rather than running them as formulas.
  • Input handling
    Site URLs pasted with a trailing slash or a page path are cleaned up, and
    invalid numeric settings fall back to their defaults instead of stalling a
    scan.
  • Provisioning scripts
    scripts/Provision-SmartPermissions.ps1 no longer needs PnP.PowerShell or
    an app registration: it signs in with a device code, remembers the sign-in,
    and uses SharePoint REST. The PnP version is now
    scripts/Provision-SmartPermissions-PnP.ps1. Both remove duplicate
    Permissions navigation links on re-run and no longer set page audience
    targeting (the page is limited to Site Owners by permissions alone).

Documentation

  • Updated the User Guide and README for all of the above.
  • Refreshed the home screen screenshot.

v1.7.0

Choose a tag to compare

@github-actions github-actions released this 28 Sep 17:24

Installation

  1. Download smart-permissions.sppkg
  2. Upload to your SharePoint App Catalog
  3. Deploy tenant-wide or to specific sites
  4. Grant the required Microsoft Graph API permissions in the SharePoint Admin Center

Added

  • Multilingual interface — 30 languages
    The web part's entire user interface is now localized: Arabic, Chinese
    (Simplified & Traditional), Czech, Danish, Dutch, English, Finnish, French,
    German, Greek, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese,
    Korean, Norwegian Bokmål, Polish, Portuguese (Brazil & Portugal), Romanian,
    Russian, Spanish, Swedish, Thai, Turkish, Ukrainian, and Vietnamese. The
    displayed language follows the SharePoint page's own UI culture
    automatically — there is no separate language picker to configure.

v1.6.1

Choose a tag to compare

@github-actions github-actions released this 30 Jul 17:22

Added

  • Exclude Sharing Links filter
    New "Exclude Sharing Links" option hides the internal SharingLinks.<guid>.*
    groups SharePoint auto-creates for "Anyone with the link" and "Specific
    people" sharing links, alongside the existing "Exclude Limited Access"
    filter. Applies everywhere the existing filter did — Permissions Report,
    Permissions Explorer, and User Access, on-screen and in exports.
  • Exclude Limited Access / Exclude Sharing Links now available directly from
    the Permissions Report screen
    , in the same filter bar as "Unique
    permissions only" and "External users only," not just on the Settings page.
  • Permissions Report — site/tenant-named exports
    Excel and CSV exports from the Permissions Report are now prefixed with
    the scanned site's name, or Tenant for an all-site-collections scan
    (e.g. SP_Permissions_Tenant_20260729...xlsx), instead of a generic
    SP_Permissions_<timestamp> name — exports from different scans no
    longer look identical once several have piled up in a downloads folder.

Changed

  • Wider Permissions Report and User Access screens
    Both screens' maximum width was increased to 1100px (previously 760px and
    900px respectively) to match the Permissions Explorer and Home screens,
    giving the results tables more room.
  • Permissions Report — precise throttling warning
    The "SharePoint throttled this scan" banner previously said only that
    results "may be incomplete," with no way to tell whether the scan was
    actually usable. It now states the exact number of items (if any) that
    couldn't be confirmed after retrying, points to the existing
    "could not be fully read" notice for exactly which ones, and confirms
    everything else in the report was read successfully — or, if every
    retried item ultimately succeeded, says so plainly instead of leaving
    the scan under a cloud of doubt.
  • Permissions Report — precise restricted-access warning
    Previously, a single item denied during a scan (e.g. one site collection
    in a tenant-wide scan where the account was still Member-level rather
    than Site Owner) triggered a blanket "results may be incomplete" banner
    that read as if the entire report couldn't be trusted, even when
    everything else scanned successfully. The warning now reports exactly
    how many items (out of the total scanned) were denied and lists up to
    10 of the specific site, library, folder, or file paths affected (with
    an "…and N more" summary beyond that), so a mostly-successful scan no
    longer reads as a failed one.
    • Folder- and file-level permission denials, which previously weren't
      tracked at all, are now recorded and surfaced the same way as site-
      and library-level denials.

Documentation

  • Documented the Permissions Report's per-library selection picker (select
    or exclude specific libraries before a Folders/Files & Folders scan) in
    the User Guide, which had never described it despite it existing in the
    UI.
  • Added a "Partial Results Due to Restricted Access" section to the User
    Guide covering the new restricted-access warning behavior above.
  • Documented the new "Exclude Sharing Links Entries" setting and clarified
    that both it and "Exclude Limited Access Entries" can now be toggled from
    the Permissions Report screen's filter bar, not just from Settings.

v1.6.0

Choose a tag to compare

@github-actions github-actions released this 22 Jul 20:44

Fixed

  • Localized (non-English) tenant accuracy
    • System role filtering ("Limited Access" / "Web-Only Limited Access") now
      checks SharePoint's language-invariant RoleTypeKind field first, falling
      back to the English display name only when RoleTypeKind isn't
      available. Previously the check matched only the English name, so these
      auto-assigned, no-meaningful-permission roles weren't recognized on
      non-English tenants and appeared as noise in every tool's results.
    • "Full Site Access" / Owner-level detection in User Access, and
      permission-level color-coding for badges and Excel exports across all
      three tools, now use the same RoleTypeKind-first classification instead
      of matching English words like "Full Control" or "Edit" in the role name.
    • The provisioning script (scripts/Provision-SmartPermissions.ps1) now
      resolves the pages library by its stable "SitePages" URL segment instead
      of the localized "Site Pages" display title, so page permissions, Quick
      Launch navigation, and audience targeting no longer silently fail to
      apply on non-English sites.
  • Provisioning script — Quick Launch de-duplication
    The existing-node check before adding the page to Quick Launch now matches
    on URL as well as title, so an unrelated page that happens to share the
    same title is left alone instead of having its nav node replaced.

Changed

  • Added a workbench npm script (gulp clean && gulp serve) as a
    convenience alias for starting the local dev server.

v1.5.1

Choose a tag to compare

@github-actions github-actions released this 14 Jul 16:50

Changed

  • Home screen — card layout
    Feature card screenshots now sit between the title/description and the
    action button instead of above the title, with object-position: left top
    cropping and added footer padding around the button.
  • Documentation — refreshed screenshots
    All home screen and feature screenshots regenerated to reflect the current
    UI.

v1.5.0

Choose a tag to compare

@sregan1 sregan1 released this 13 Jul 17:11

What's New in v1.5.0

Fixed

  • Provisioning script — App install now targets the tenant App Catalog and waits for install completion; publishing uses the current Set-PnPPage -Publish cmdlet; the web part is resolved via Get-PnPAvailablePageComponents instead of a raw ID string; fixed a duplicate-webpart guard and non-English "Site Pages" library resolution; added optional $clientId support; Quick Launch de-duplication now also matches by URL.
  • Audit accuracy — Items that fail a unique-permission check after retries are now flagged as scan-incomplete instead of silently shown as inheriting; retry/backoff now covers thrown/rejected requests, not just 429/503; a Graph permission error in the M365-group ownership check now surfaces as "Graph permission required" instead of a false "Member" result; transitiveMemberOf now follows @odata.nextLink past 999 groups; group member expansion resolves by numeric group ID; checkCanManagePermissions now fails closed on API errors; "Everyone" / "Everyone except external users" claims are now flagged as tenant-wide access; the "exclude limited access" and "external users only" filters are now applied consistently across Explorer, Report, and User Access (including exports).
  • Explorer reliability — Folder prefetches are now bounded by scan concurrency; background scans/prefetches are discarded on library switch instead of applying stale results; failed folder listings show inline error text instead of a broken tree node.

Changed

  • Permissions Report export buttons moved to the top of the results, above the summary badges.
  • User-identifying diagnostic logging in User Access is now gated behind localStorage.setItem('smartPermissionsDebug', '1').
  • Documentation (README, USER-GUIDE) updated to match current behavior.

Installation

Upload smart-permissions.sppkg to your SharePoint Tenant App Catalog.

Optionally approve the GroupMember.Read.All Graph permission in SharePoint Admin Center → Advanced → API access to enable Security/M365 group member expansion.

See the User Guide for full documentation.

v1.2.0

Choose a tag to compare

@sregan1 sregan1 released this 02 Jun 12:34

What's New in v1.2.0

Added

  • User Access — site permission shown for M365 Group members
    Users who access a site through a Microsoft 365 Group now correctly see a site-level permission entry. Uses a three-tier detection approach: SP group REST membership check, M365 Group detection via the site's GroupId and associated groups, and Graph transitiveMemberOf fallback.

  • User Access — highest permission shown when in multiple groups
    When a user is in both Owners and Members, Full Control is shown instead of Edit. Owner status is checked via GET /groups/{id}/owners/{userId}.

  • Permissions Explorer — permission-denied banner for member accounts
    A blue informational banner now appears when role-assignment reads fail with HTTP 403, explaining that external user indicators and permission tables may be incomplete for the current account.

  • User Access — "New scan" replaces "Scan again"
    The button now clears results and returns to the user picker instead of re-running the same user.

Fixed

  • "Web-Only Limited Access" and other system-assigned pass-through roles no longer appear as site permissions
  • Site permission detection now works for M365-backed SharePoint groups using sitegroups/getbyid instead of getbyloginname
  • Scan in-progress text simplified to "Scanning…"

Installation

Upload smart-permissions.sppkg to your SharePoint Tenant App Catalog.

Optionally approve the GroupMember.Read.All Graph permission in SharePoint Admin Center → Advanced → API access to enable M365 Group membership detection in User Access.

See the User Guide for full documentation.

Latest Build (v1.6.1.0)

Choose a tag to compare

@github-actions github-actions released this 19 May 02:01

Automated build from commit f4367de.
Upload smart-permissions.sppkg to your SharePoint App Catalog to deploy.

v1.0.0 — Initial Public Release

Choose a tag to compare

@sregan1 sregan1 released this 13 May 17:22

Initial public release of SharePoint Smart Permissions.

Features

  • Permissions Report — Scans a site's libraries, folders, and files and exports a colour-coded Excel workbook of every unique permission assignment. Supports group member expansion (SharePoint groups, Security groups, M365 groups) and full-tenant scans from the root site.

  • Permissions Explorer — Interactively browse a document library tree and inspect live permissions on any folder or file. Shows inherited vs. unique permissions with a clear visual indicator, and supports real-time group member expansion.

  • User Access — Look up any user and see every location they can access, with their exact permission level at each location. Detects full-site owner access immediately.

Highlights

  • Runs entirely in the browser as an SPFx web part — no PowerShell, no elevated service accounts
  • Uses the signed-in user's own credentials; read-only, no data stored or transmitted externally
  • SharePoint site theme colours applied automatically
  • Configurable default view via the web part property pane

See README.md for setup and deployment instructions.