| name | implementing-admin-portal |
| description | Implements Scalekit's admin portal for customer self-serve SSO and SCIM configuration. Generates portal links server-side and embeds the portal as an iframe in the app's settings UI. Use when the user asks to add an admin portal, customer self-serve SCIM setup, iframe embed for directory sync config, shareable setup link, or let customers configure their own SSO or SCIM connection. |
Admin Portal with Scalekit
Adds a self-serve portal where customers configure their own SSO and SCIM settings — embedded inside your app's settings UI.
If the user only needs a quick shareable link with no code (e.g., for a one-time onboarding call), skip to the Shareable link section at the bottom.
Implementation progress
Admin Portal Implementation Progress:
- [ ] Step 1: Install SDK
- [ ] Step 2: Set environment credentials
- [ ] Step 3: Register app domain in dashboard
- [ ] Step 4: Generate portal link (server-side)
- [ ] Step 5: Render iframe (client-side)
- [ ] Step 6: Handle session expiry events
- [ ] Step 7: Verify portal loads and events fire correctly
Step 1: Install SDK
Detect the project's language/framework from existing files and install:
| Stack | Install |
|---|
| Node.js | npm install @scalekit-sdk/node |
| Python | pip install scalekit-sdk-python |
| Go | go get github.com/scalekit-inc/scalekit-sdk-go/v2 |
| Java | Add com.scalekit:scalekit-sdk to pom.xml |
Step 2: Set environment credentials
Add to .env (never hardcode):
