Getting Verified
Verification ensures only real union members have access to your space. The process is quick, secure, and designed to prevent infiltration.
How Verification Works
Grassroots uses a member-vouching system. Instead of a central authority deciding who gets in, existing members vouch for coworkers they know personally.
🔐 Why This Matters
This decentralized verification prevents employers from using fake accounts to infiltrate your union. You have to know real members in person to get verified.
Requirements
To get verified, you need:
- An account in the Lobby (see Creating an Account)
- To meet with existing verified members in person
- Your phone or computer with camera access (to scan QR codes)
Your union configures how many members need to vouch for you (typically 2-3). This ensures cross-validation—no single person can let someone in.
The Verification Process
Step 1: Find Verified Members
Contact your:
- Union organizer or steward
- Coworkers you know are already members
- People listed in the Lobby welcome message
Arrange to meet them in person during a break, shift change, or union meeting.
Step 2: Open the Verification Widget
In your Lobby, you'll see a Verification Widget with a button that says "Request Verification". Click it to open the QR code scanner.
Step 3: Scan QR Codes
Each verified member who vouches for you will:
- Open the verification widget on their device
- Click "Vouch for Someone"
- Show you their QR code
- You scan it with your camera
✨ Quick & Easy
The whole process takes about 30 seconds per person. No typing Matrix IDs, no mistakes.
Step 4: Wait for Confirmation
After scanning a QR code:
- The verification bot sends them a confirmation request
- They click "Yes, I vouch for this person"
- Their approval is recorded
- You see a checkmark in your verification status
Step 5: Threshold Met!
Once enough members vouch for you (e.g., 2 out of 2), you're automatically:
- Invited to the Verified Members Space
- Given access to all protected channels
- Able to verify others yourself
- Eligible to vote on motions
Security Features
In-Person Requirement
QR codes prove you're physically present with the verifier. This prevents:
- Remote account creation by bad actors
- Bulk fake account generation
- Social engineering over the phone
Nonce Validation
Each QR code contains a unique, single-use token that expires in 5 minutes. Even if someone takes a photo of a QR code, it can't be reused.
Cross-Validation
Requiring multiple verifiers from different departments/sites makes it harder for a small group of colluding members to admit infiltrators.
Troubleshooting
Can't Find Verified Members
Contact your union organizer directly. They can:
- Connect you with members at your worksite
- Announce your need for verification in member channels
- Schedule verification sessions at meetings
QR Scanner Not Working
- Ensure your browser has camera permissions
- Try using a different device or browser
- Make sure there's good lighting
- Hold the QR code steady and centered
Verification Not Completing
If you've scanned QR codes but aren't getting verified:
- Ask the verifiers if they clicked "Confirm" in the bot's message
- Check if the QR code expired (they're only valid 5 minutes)
- Try the process again with fresh QR codes
Lost Access After Verification
If you lose access to verified channels, you may have been revoked. Contact your union moderators or organizers to understand why and discuss next steps.
For Verifiers
If you're a verified member helping someone new:
Before Vouching
- Verify their identity: Make sure you actually know them
- Confirm membership: Are they actually a union member?
- Meet in person: Never vouch remotely via screenshots
Daily Limits
To prevent abuse, each member can only verify a limited number of people per day (typically 5-10). This prevents bulk vouching.
Your Responsibility
When you vouch for someone, you're saying "I personally know this person is a legitimate union member." Take this seriously—the security of your union's space depends on it.
Next Steps
Once verified, you're ready to start using Grassroots! Check out: