Files
sharepoint-acc-sync/docs/access-setup.md
2026-10-22 22:05:33 -05:00

2.3 KiB

Access setup

The sync server needs two app identities: one for Microsoft (to read SharePoint) and one for Autodesk (to write to ACC). Both are shared by every project. Adding a new project only means granting these identities access to the new folders.

Nothing here needs a user to stay logged in. Both use app-only (client credentials) auth.

Microsoft / SharePoint (ask IT)

  1. Create an Entra ID app registration, e.g. "SharePoint ACC Sync".
    • Single tenant.
    • Create a client secret (or a certificate, if IT prefers). Note its expiry date, because the sync stops when it expires.
    • Send us the Tenant ID, Client ID, and the secret, securely. They go into Portainer as secrets.
  2. Grant Microsoft Graph application permissions (read-only), with admin consent. Pick one:
    • Sites.Selected (recommended, least privilege). The app can read only the sites IT explicitly grants it. Each new project's site needs a one-time grant by IT (POST /sites/{site-id}/permissions with role read).
    • Sites.Read.All. The app can read every SharePoint site in the tenant. No per-project step, but much broader access.
  3. For each project: confirm the site is granted (if using Sites.Selected), then give us the URL of the project's root folder.

The tool only ever reads from SharePoint, so no write permission is needed.

Autodesk / ACC (ask the ACC account admin)

  1. Create an APS app at https://aps.autodesk.com → My Apps.
    • App type: Server-to-Server (app-only).
    • API access: Data Management API.
    • Send us the Client ID and Client Secret.
  2. In ACC Account Admin → Custom Integrations, add the APS app's Client ID so it can access the account's projects.
  3. Possibly: a service user. Some ACC Docs operations may need to run "as" a user, i.e. an account that is a project member with edit/upload permission on the target folder. We'll confirm this during the build spikes before asking for it.
  4. For each project: tell us which ACC project, and which folder under Project Files, is the sync root.

For the build spikes

A sandbox ACC project and a test SharePoint site/folder we can freely create, move and delete files in. The early tests check how ACC handles moves and restores, and they shouldn't run against real project data.