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

33 lines
2.3 KiB
Markdown

# 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.