UltimateCloser.Ai — session token authentication
Proof of resolution for App Store review requirement 1.1.1 · November 17, 2026
What was wrong
The embedded app relied on cookie-based authentication. With third-party cookies blocked, opening the app inside Shopify Admin bounced the merchant through the OAuth flow repeatedly instead of loading the app.
What changed
The embedded app now authenticates with Shopify session tokens end to end:
- App Bridge is loaded as a static script tag in the document head, with the
shopify-api-keymeta tag, and supplies a fresh session token for embedded requests. - The server verifies every session token before use: signature, audience (the app's API key), issuer and destination (the shop), expiry, and binding to the shop the request claims to be for.
- Authorization is scoped to the verified shop's linked store. A token for one store cannot read or change another store's data.
- Authentication does not depend on third-party cookies or local storage anywhere in the embedded flow, and the app never redirects to a login page inside the iframe.
- Opening the app from Shopify Admin routes an installed, linked store directly to its embedded dashboard. The OAuth install flow runs only for stores that are not yet installed or linked.
How it was verified
On a development store (uc-review-proof.myshopify.com), November 17, 2026:
- Uninstalled the app and reinstalled it fresh from the Developer Dashboard. The install completed and the store connected.
- Opened the app cold from the Shopify Admin apps menu: the embedded dashboard loaded directly, showing the store as Connected with its catalog synced and the order webhook installed.
- Reloaded the page repeatedly: the dashboard reloaded in place every time. No OAuth redirect loop, no login page, no error.
- Navigated between the dashboard's tabs (Performance, Agent & catalog, Connect store, Settings) inside the frame without leaving the app.
- Confirmed in the app's database that the verification opens created no new install or claim records: the store's session resolves from its existing linked store on every open.
Also in this submission
- All REST Admin API calls removed from the install and validation paths; the app uses the GraphQL Admin API exclusively (requirement 2.2.4).
- Off-Shopify install initiation removed: the dashboard no longer accepts a typed shop domain, and installation starts on Shopify only (requirement 2.3.1).
- Added
app/uninstalledwebhook handling: the subscription is ensured at install, and store credentials are cleared when a store uninstalls. - Compliance webhooks completed:
shop/redactandcustomers/redacterase personal data across every table that holds it, andcustomers/data_requestdelivers the data held. - Closed a legacy-token hole: a stored token with no recorded expiry is no longer treated as live.
UltimateCloser.Ai · Support: daniel.toth@ultimatecloser.ai