Skip to content
Download PDF

Chaster Account Integration

KeyShare operates as a community extension within the Chaster ecosystem, which means it has specific limitations and requirements for how it interacts with Chaster accounts.

Community Extension Limitations

As a community extension, KeyShare does not have direct access to Chaster's authentication system. This is an important security and privacy feature that prevents third-party extensions from accessing your full Chaster credentials.

However, this limitation creates some requirements when mandates are configured to require Chaster accounts for mandatees.

Account Registration Process

When a mandate is configured with "Require Chaster Account for Mandatee" enabled, mandatees must first register their Chaster account with KeyShare before they can use mandate links.

What Registration Actually Does

KeyShare registration is very simple - it only stores your Chaster username in your browser's local storage. No passwords, no personal data, no server-side account creation. It's purely a local browser setting that tells KeyShare "this browser belongs to username X".

Per-Browser Registration Required

Since the registration only stores your username locally in each browser, you need to register separately on every browser and device you want to use KeyShare with. Your phone, work computer, home laptop - each needs its own registration.

The preferred and most convenient way to register your Chaster account with KeyShare is through OAuth authentication:

  1. Access OAuth Registration: Visit the KeyShare OAuth registration page at /keyshare/oauth-register
  2. Click "Login with Chaster": You'll be redirected to Chaster's secure authentication page
  3. Authorize KeyShare: Grant KeyShare permission to access your Chaster username
  4. Automatic Registration: You'll be redirected back and automatically registered

Advantages of OAuth Registration: - Works even when you're currently locked and cannot modify your lock extensions - Faster and more convenient than manual registration - No need to have an active KeyShare session

Manual Registration

If OAuth is not available or you prefer manual registration, you can register through the KeyShare extension interface:

  1. Access KeyShare Extension: Open KeyShare as either:
  2. Keyholder: Through any active lock where you are the keyholder with KeyShare enabled

  3. Wearer: Through any active lock where you are the wearer with KeyShare enabled

  4. Click Registration Button: Look for and click the "Register account with KeyShare" button on the extension page

  5. Account Registered: Your Chaster account is now registered and linked with KeyShare

Important: Simply accessing the KeyShare extension page is not sufficient - you must actively click the registration button.

Registration for Users Without Active Sessions

If you need to register but don't have an active lock session with KeyShare enabled:

Option 1: OAuth Registration (Recommended) - Simply visit /keyshare/oauth-register and use the OAuth login method - No active session required

Option 2: Manual Registration with Test Lock 1. Creating a Test Lock: Set up a temporary lock with KeyShare extension active 2. Starting the Session: Begin the lock session 3. Opening KeyShare: Access the extension page 4. Click Registration: Click the "Register account with KeyShare" button 5. Account Registered: Their Chaster account is now registered with KeyShare

Test Lock Registration

The test lock can be very short (even 1 minute) and can be ended immediately after registration. The goal is simply to establish the connection between the Chaster account and KeyShare.

Multi-Device Usage

Since registration is stored locally in each browser:

  • Home Computer: Register once, works until you clear browser data
  • Phone Browser: Needs separate registration
  • Work Computer: Needs separate registration
  • Tablet: Needs separate registration
  • Different Browsers: Chrome, Firefox, Safari each need separate registration

Browser Data Clearing

If you clear your browser's data, cookies, or local storage, you'll need to register again in that browser. The registration doesn't persist across browser resets.

New User Protection

The "Exclude New Users" setting provides protection against abuse by preventing newly created Chaster accounts from using mandates immediately.

Purpose

This protection is designed to prevent:

  • Throwaway Accounts: Someone creating multiple new accounts to repeatedly use mandates
  • Abuse Prevention: Limiting access to established community members
  • Trust Building: Encouraging engagement with the broader Chaster community before participating in KeyShare