33 lines
2.3 KiB
Markdown
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.
|