You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix(credentials): Group B verification round — transient statuses, current Salesforce setup flow, rotation-correct mint cache
- 408/429 from token endpoints map to provider_unavailable in all three
minters (throttling never blames the customer's credentials)
- Salesforce docs lead with the External Client App flow (classic Connected
App creation is disabled by default since Spring '26)
- Mint cache validates a ciphertext fingerprint on every hit (rotation-
correct across instances), evicts deleted credentials, memoizes failures
for 30s, and skips identity lookups on execution-time mints
- Salesforce DNS failures on the My Domain host map to site_not_found
- Pipedrive pipeline-deals migrated off the sunset v1 endpoint to /api/v2
- Zoom granted scopes persisted for scope-gap debugging; docs claims
softened to match rendered UI errors; Box Enterprise ID steps per Box's
Locating Common Values doc
Box Platform apps with **Server Authentication (Client Credentials Grant)** let your workflows authenticate to Box as the app's own **Service Account** instead of through a person's OAuth login. You create the app once, a Box admin authorizes it for the enterprise, and Sim mints short-lived access tokens from the app's credentials on demand — no user consent to expire, and access that's controlled entirely by which folders the Service Account is invited into.
10
+
Box Platform apps with **Server Authentication (with Client Credentials Grant)** let your workflows authenticate to Box as the app's own **Service Account** instead of through a person's OAuth login. You create the app once, a Box admin authorizes it for the enterprise, and Sim mints short-lived access tokens from the app's credentials on demand — no user consent to expire, and access that's controlled entirely by which folders the Service Account is invited into.
11
11
12
12
This is the recommended way to use Box in production workflows: nothing depends on a user staying logged in, the app's scopes are explicit, and the Service Account's reach is auditable folder by folder.
13
13
@@ -21,9 +21,9 @@ Anyone with Developer Console access can create the app, but a Box **admin or co
21
21
22
22
<Steps>
23
23
<Step>
24
-
Go to the [Box Developer Console](https://app.box.com/developers/console), open **My Apps**, click **Create Platform App**, and choose **Server Authentication (Client Credentials Grant)**
24
+
Go to the [Box Developer Console](https://app.box.com/developers/console), open **My Apps**, click **Create Platform App**, and choose **Server Authentication (with Client Credentials Grant)**
25
25
26
-
{/* TODO(screenshot): Box Developer Console Create Platform App dialog with Server Authentication (Client Credentials Grant) selected */}
26
+
{/* TODO(screenshot): Box Developer Console Create Platform App dialog with Server Authentication (with Client Credentials Grant) selected */}
27
27
</Step>
28
28
<Step>
29
29
On the **Configuration** tab, set the **App Access Level**. **App Access Only** (the default) is sufficient — choose **App + Enterprise Access** only if the Service Account should also reach existing managed users' content via admin APIs
@@ -39,7 +39,7 @@ Anyone with Developer Console access can create the app, but a Box **admin or co
39
39
{/* TODO(screenshot): OAuth 2.0 Credentials panel showing the Client ID and the client secret reveal */}
40
40
</Step>
41
41
<Step>
42
-
Copy the **Enterprise ID** — a numeric value shown on the app's **General Settings** tab, or in **Admin Console** → **Account & Billing** → **Account Information**
42
+
Copy the **Enterprise ID** — a numeric value. In the Developer Console, click your account icon in the top right and choose **Copy Enterprise ID**; a Box admin can also find it in **Admin Console** → **Account & Billing** → **Account Information**
43
43
</Step>
44
44
</Steps>
45
45
@@ -66,7 +66,7 @@ Alternatively, the developer can click **Review and Submit** on the app's **Auth
66
66
67
67
### 3. Give the Service Account Access to Folders
68
68
69
-
The Service Account is a brand-new Box user — its email looks like `AutomationUser_AppServiceID_RandomString@boxdevedition.com` and is shown on the app's **General** tab. Its folder tree starts **empty**: a fully valid credential sees zero items and gets `404`s on real files and folders until you grant it access.
69
+
The Service Account is a brand-new Box user — its email looks like `AutomationUser_AppServiceID_RandomString@boxdevedition.com` and is shown on the app's **General Settings** tab. Its folder tree starts **empty**: a fully valid credential sees zero items and gets `404`s on real files and folders until you grant it access.
70
70
71
71
<Steps>
72
72
<Step>
@@ -87,10 +87,10 @@ Community reports indicate the Service Account can't be collaborated into a user
87
87
88
88
<Steps>
89
89
<Step>
90
-
Open your workspace **Settings**and go to the **Integrations** tab
90
+
Open **Integrations**from your workspace sidebar
91
91
</Step>
92
92
<Step>
93
-
Search for "Box" and click it, then click **Add to Sim** and choose **Add service account**
93
+
Search for "Box" and open it, then click **Add to Sim** and choose **Add service account**
94
94
95
95
{/* TODO(screenshot): Box integration page with the Add service account connect option */}
96
96
</Step>
@@ -100,7 +100,7 @@ Community reports indicate the Service Account can't be collaborated into a user
100
100
{/* TODO(screenshot): Add Box service account dialog with all three fields filled in */}
101
101
</Step>
102
102
<Step>
103
-
Click **Add service account**. Sim verifies the credentials by minting a real access token from Box — if it fails, you'll see a specific error explaining what went wrong (bad credentials, an app the admin hasn't authorized yet, or values that don't all belong to the same app and enterprise).
103
+
Click **Add service account**. Sim verifies the credentials by minting a real access token from Box — if it fails, the error tells you whether Box rejected the credentials or couldn't be reached. A rejection usually means bad credentials, an app the admin hasn't authorized yet, or values that don't all belong to the same app and enterprise.
104
104
</Step>
105
105
</Steps>
106
106
@@ -122,10 +122,10 @@ Access tokens minted from the app are short-lived (typically one hour) and there
122
122
123
123
<FAQitems={[
124
124
{ question: "Why a Service Account instead of OAuth?", answer: "The Service Account is its own Box user, owned by the app — nothing expires when someone leaves or their login lapses. Access is granted folder by folder through collaborations, which makes the credential's reach explicit and auditable." },
125
-
{ question: "The credential validates but every block returns nothing or 404s — why?", answer: "The Service Account's folder tree starts empty. It only sees folders it has been invited into as a collaborator. Invite its @boxdevedition.com email (shown on the app's General tab) as an Editor on the folders your workflows use." },
125
+
{ question: "The credential validates but every block returns nothing or 404s — why?", answer: "The Service Account's folder tree starts empty. It only sees folders it has been invited into as a collaborator. Invite its @boxdevedition.com email (shown on the app's General Settings tab) as an Editor on the folders your workflows use." },
126
126
{ question: "Adding the credential fails with 'This app is not authorized by the enterprise admin' — what now?", answer: "A Box admin or co-admin must authorize the app in Admin Console → Apps → Platform Apps Manager (or Platform → Platform Apps in some tenants) by adding its Client ID. Until then, all token requests fail." },
127
127
{ question: "I added a scope but tools still fail with 403 — why?", answer: "Authorization is a snapshot of the app's scopes at the time the admin approved it. After any scope or access-level change, the admin must re-authorize the app in Platform Apps Manager before the new scopes apply." },
128
-
{ question: "It says 'The grant type is unauthorized for this client_id' — why?", answer: "The app was created with user authentication (OAuth 2.0) instead of Server Authentication. Create a new Platform App and choose Server Authentication (Client Credentials Grant)." },
129
-
{ question: "It says 'Grant credentials are invalid' — why?", answer: "The Client ID, Client secret, and Enterprise ID don't all belong to the same Box app and enterprise — most often a mismatched ID/secret pair. Re-copy all three values from the same app in the Developer Console." },
128
+
{ question: "It says 'The grant type is unauthorized for this client_id' — why?", answer: "The app was created with user authentication (OAuth 2.0) instead of Server Authentication. Create a new Platform App and choose Server Authentication (with Client Credentials Grant)." },
129
+
{ question: "It says 'Grant credentials are invalid' — why?", answer: "Either the Client ID, Client secret, and Enterprise ID don't all belong to the same Box app and enterprise (most often a mismatched ID/secret pair), or the app hasn't been authorized in the Admin Console yet. Re-copy all three values from the same app in the Developer Console, and make sure an admin has authorized the app in Platform Apps Manager." },
130
130
{ question: "Do Box Sign operations work with a service account?", answer: "Yes, if the app has the Manage signature requests scope, the admin has (re-)authorized the app since it was added, and Box Sign is enabled on your enterprise plan. File and folder operations work regardless." },
0 commit comments