Installing LamaniSync: Complete Workstation Connection Guide

Overview

The LamaniSync Workstation Synchronizer connects your authenticated web-based Clinic Management System (CMS) to LamaniHub and WhatsApp Automation in real-time.

Unlike legacy healthcare synchronizers that require intrusive Windows background services, database drivers, or open inbound firewall ports, LamaniSync executes as a secure Manifest V3 Chrome Extension directly within the front-desk browser user-space.

[Patient on WhatsApp] 
         │
         ▼
[LamaniHub Cloud Engine] 
         │ (TLS 1.3 Outbound Encrypted Stream)
         ▼
[Front-Desk Workstation (LamaniSync Chrome MV3)]
         │ (In-Memory Page-World Bridge)
         ▼
[Authenticated CMS Tab (Dentrix / eCW / Pulse)]
         │
         ▼ (Readback Verification & SHA-256 Receipt)
[Instant Confirmation to Patient]

---

Prerequisites

Before beginning installation on a clinic workstation, ensure your setup meets these criteria:

---

Step 1: Install the Extension from Chrome Web Store

1. Open Google Chrome on the clinic workstation where staff manage appointments.
2. Navigate to the official extension listing on the Chrome Web Store:
   • Search for "LamaniSync Bridge" or use the direct installation link provided in your LamaniHub onboarding email.
3. Click the blue Add to Chrome button.
4. When prompted by Chrome permissions dialog, click Add Extension.
5. Pin the extension to your browser toolbar:
   • Click the Extensions puzzle icon in the top-right corner of Chrome.
   • Click the Pin icon next to LamaniSync so the badge is always visible to reception staff.

Security Note: LamaniSync runs under Manifest V3 and requests zero broad host permissions by default. It operates with strictly declarative sandboxing and never loads external JavaScript.

---

Step 2: Retrieve Your Clinic Pairing Token from LamaniHub

Each clinic location possesses a unique, cryptographically signed pairing token that authenticates the workstation to LamaniHub's synchronization pipeline.

1. In a separate tab, log into LamaniHub at https://lamanihub.com/login.
2. Select your clinic location from the organization selector.
3. In the left navigation menu, go to Settings → Integrations → LamaniSync Bridge.
4. Click Generate Workstation Pairing Token.
5. Select the primary CMS adapter for this workstation (e.g., Dentrix Ascend, eClinicalWorks, or LamaniPulse EHR).
6. Click Generate Token and click the copy icon to copy the alphanumeric token:

LMN-SYNC-v1-98a2f1c84b7e09d3-550e8400-e29b-41d4-a716-446655440000

Important: Pairing tokens are one-time credentials with a 15-minute expiration window. If you do not pair the workstation within 15 minutes, generate a fresh token from the dashboard.

---

Step 3: Perform the WebCrypto Ed25519 Handshake

1. On the clinic workstation, click the LamaniSync extension icon in the Chrome toolbar.
2. In the pairing input field, paste the Pairing Token copied from LamaniHub.
3. Click Initiate Secure Pairing.
4. The extension automatically generates a local WebCrypto Ed25519 keypair inside browser memory:
   • The private key remains locked inside your local workstation's secure storage.
   • The public key is transmitted to LamaniHub to establish mutual end-to-end cryptographic payload signing.
5. The extension status badge will switch from Unpaired to Paired & Handshaking.

---

Step 4: Grant Exact-Origin Host Permission

To allow LamaniSync to bridge appointments with your CMS, Chrome requires an explicit origin grant for the specific website your clinic uses.

1. When prompted in the extension popup, click Grant Origin Access.
2. Select or verify the exact URL of your clinic's web portal (e.g., https://live.dentrixascend.com or https://clinicname.eclinicalweb.com).
3. Click Allow.

Zero Walled-Garden Access: LamaniSync adheres strictly to Rule #3 of our Security Architecture: Host permissions are never broader than the exact paired CMS origin. The extension will never have access to your personal browsing, email, or other open tabs.

---

Step 5: Verify Active Tunnel Status

Once origin permissions are granted and the authenticated CMS tab is open:

1. Open your clinic CMS in an active Chrome tab and log in as normal.
2. Click the LamaniSync extension badge.
3. Confirm that all three status indicators are green:
   • Tunnel State: Active Bridge (Connected)
   • Lease Role: Primary Active Leader (15s Heartbeat)
   • CMS Session: Authenticated (Ready for Slot Reads & Booking)
4. The extension icon in your Chrome toolbar will display a green checkmark dot indicating synchronization readiness.

---

Step 6: Test Real-Time Slot Ingestion & Writeback

To verify end-to-end functionality without affecting real patient schedules:

1. In the LamaniHub Dashboard, go to Integrations → LamaniSync Bridge → Test Dispatch.
2. Click Run Diagnostic Ping.
3. LamaniHub will transmit an encrypted read request to the workstation.
4. Observe the LamaniSync popup: the diagnostic counter will increment, showing:
   • Round-Trip Handshake Latency: Typically 120ms–350ms.
   • Readback Verification: State hash confirmed.
   • Active Write Capability: Verified.

Your workstation is now fully operational. Appointments booked via LamaniHub on WhatsApp will now synchronize automatically into your clinic calendar.