Skip to content

OneDrive configuration

The single OneDrive for Business connection CtrlShare uses: the Microsoft Entra app registration and the connected account's authorization code. Who may co-author which documents lives in ; automation lives in . Persisted as MainConfiguration.OneDriveConfiguration (configuration version 3.1). The member names below are frozen: they are the JSON keys stored in every customer vault and are copied verbatim by the upgrade hops in Configuration/Upgrades. The redirect_uri initializer may only change together with a new configuration version: the VAF.Extensions serializer omits values equal to the initializer, so a stored body whose value equalled the old initializer carries no value at all, and the hop for the new version must write the old value out explicitly for connected sections (see for 3.0 → 3.1).

Reached from OneDrive for Business on Main configuration.

Settings

Client ID

Type
Text

The client id of the registered application in Microsoft Azure. The app registration needs the delegated Microsoft Graph permissions Files.ReadWrite.All and offline_access; no directory or User permissions are required.

Client Secret

Type
Text

The secret of the registered application in Microsoft Azure.

Treat this value as a password. Do not share it or store it in a ticket.

Redirect URI

Type
Text
Default
http://localhost/ctrlshare

The redirect URI registered on the app registration in Microsoft Entra (Authentication → Web → Redirect URIs); the value here must match it exactly. The default, http://localhost/ctrlshare, needs nothing running there: after sign-in the browser shows a connection error page whose address bar keeps the full URL with the code=... part, which you paste into Authorization Code. Entra accepts http://localhost addresses on the Web platform. Connections set up before CtrlShare 2.26.8.0 keep https://login.microsoftonline.com/common/oauth2/nativeclient, which still works but redirects away from the code after a moment.

Authorization Code

Type
Text

The authorization code that was retrieved in the authentication step of the documentation. You can paste either the code itself or the entire redirect URL from the browser address bar — the code=... part is extracted automatically. All sharing — including invitations to people outside the organization — runs under this connected account's identity through OneDrive's own invitation flow; the Microsoft 365 tenant must allow it (see the CtrlShare release notes for the required external sharing and guest invite settings).

Treat this value as a password. Do not share it or store it in a ticket.

Generated from CtrlShare 2.26.8.0.