Skip to content

Join Tokens

Overview

Join Tokens provide secure access to video consultations.

Rather than exposing meeting rooms directly, participants must obtain a temporary join token before entering a consultation.


Token Flow

sequenceDiagram

    participant User

    participant VideoService

    participant AppointmentService

    participant Jitsi

    User->>VideoService: Request Join Token

    VideoService->>AppointmentService: Validate Access

    AppointmentService-->>VideoService: Authorized

    VideoService-->>User: Join Token

    User->>Jitsi: Join Meeting
Hold "Alt" / "Option" to enable pan & zoom

Validation Rules

A token may be issued only when:

  • Appointment exists
  • Appointment is confirmed
  • User belongs to appointment
  • Consultation window is open

Consultation Window

VitalBridge allows participants to join consultations shortly before the scheduled appointment time.

flowchart LR

    LOCKED["Join Disabled"]

    WINDOW["Consultation Window"]

    ENABLED["Join Enabled"]

    LOCKED --> WINDOW

    WINDOW --> ENABLED
Hold "Alt" / "Option" to enable pan & zoom

This prevents unauthorized early access.


Token Characteristics

Join tokens are:

  • Short-lived
  • Appointment scoped
  • User scoped
  • Non-transferable

Security Benefits

flowchart TB

    TOKEN["Join Token"]

    USER["Authorized User"]

    SESSION["Video Session"]

    TOKEN --> USER

    USER --> SESSION
Hold "Alt" / "Option" to enable pan & zoom

Tokens prevent unauthorized access to consultation rooms.