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