Profile — Integrations ▸ Extensions
The Profile ▸ Integrations ▸ Extensions page is the user-facing pairing surface for the Athenty Snap browser extension. Snap detects identity-verification requests on any web page and lets users submit them without leaving the tab — pairing this page authorizes Snap to call the Athenty API as the signed-in user.

Anatomy of the page
Section titled “Anatomy of the page”1. Page header
Section titled “1. Page header”Standard PageHeader with the title Browser Extension and a one-line description. Sits at the top of the right-hand content panel under the Profile left-nav.
2. Install banner
Section titled “2. Install banner”A static informational banner explaining the install step (browser web
store) with an inline link to the Snap getting-started doc on
athenty.com. The banner is always visible — the user might not have
installed Snap yet.
3. Pair Extension button + active code
Section titled “3. Pair Extension button + active code”A single button that emits a 6-digit pairing code on click. While the code is live, a card appears above the button showing:
- The 6 digits in fixed-width tiles
- A countdown bar for the 5-minute expiry
- An expired state when the timer reaches zero
- A Dismiss action
4. Paired list
Section titled “4. Paired list”Below the button, a list of every browser currently paired with the user’s account:
- Pairing name (auto-derived from the user-agent)
- Who paired it (the user themselves, in nearly every case)
- Last-used timestamp
- A small Expired pill if the pairing has aged out
- A revoke icon button (top-right of each row)
Revoking opens a confirm dialog — pairings are not soft-deleted, so the revoke is destructive.
Pairing flow
Section titled “Pairing flow”The end-to-end flow:
- User installs Snap from the browser web store
- User opens Snap and clicks Pair
- Snap displays a 6-digit input
- User opens this page and clicks Pair Extension
- Server emits a fresh 6-digit code with a 5-minute TTL
- User types the code into Snap within the TTL
- Snap calls the validation API; on success, a new token is minted and the pairing appears under Paired here
The code is single-use and bound to the user’s session — a teammate cannot generate a code on your behalf.
Code semantics
Section titled “Code semantics”- Length: 6 digits
- TTL: 300 seconds (5 minutes)
- Single-use: consumed on first valid submission
- Auto-expired: replaced if the user clicks Pair Extension again while one is live
Pairing lifecycle
Section titled “Pairing lifecycle”Each pairing has its own row in the paired list with this lifecycle:
created ─▶ active ─▶ revoked ↘ expired (after inactivity window)The inactivity window defaults to 90 days. Activity is any API call Snap makes on the user’s behalf — not just opening Snap.
Permissions and scope
Section titled “Permissions and scope”| Role | Pair | Revoke own | Revoke others |
|---|---|---|---|
| Owner / Admin | ✓ | ✓ | ✓ (via Settings ▸ Compliance) |
| Member | ✓ | ✓ | ✗ |
| Viewer | ✗ | ✗ | ✗ |
Pairings are user-scoped. Owners and admins can see and revoke other users’ pairings only via the admin surface; this Profile page shows just the user’s own.
Audit trail
Section titled “Audit trail”Every pairing emits audit events:
extension.code_generatedextension.pairedextension.revokedextension.expired
These events surface in Settings ▸ Audit Log for admins and in the user’s own Profile ▸ Security ▸ Activity tab.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Most likely cause | Fix |
|---|---|---|
| Snap rejects the code | Code already expired | Click Pair Extension again for a fresh code |
| Pairing missing from list | Network race after Snap submitted | Refresh the page |
| Code never typed | User dismissed the card | Click Pair Extension again |
| Snap calls fail post-pair | User signed out of Athenty | Sign back in; pairings persist across logouts |
| Inactivity-expired pairing | No Snap activity in 90 days | Re-pair to refresh the token |
Related pages
Section titled “Related pages”- Profile ▸ Integrations ▸ Add-ins — Outlook + Gmail add-in pairings
- Profile ▸ General — your activity feed shows pairing events
- Athenty Snap getting started — install guide for Chrome/Firefox
- Settings ▸ Compliance — admin-side pairing policy