Accessing Documents
How survivors decrypt, download, and verify documents after threshold authentication in Burning Ash Protocol.
Accessing Documents
Once the threshold is met, survivors can access the decrypted will documents. This guide covers the process.
Prerequisites
Before accessing documents, you must:
- Be a designated survivor
- Have verified your identity via OTP or backup code
- Have threshold (K-of-N) survivors authenticated
Access Notification
When threshold is met, you'll receive notification:
Burning Ash Protocol
The threshold has been met! You can now access [Host Name]'s will documents.
Visit the portal to view and download: [link]
The Access Portal
Initial Screen
┌─────────────────────────────────────────────────────────────┐
│ WILL DOCUMENTS │
├─────────────────────────────────────────────────────────────┤
│ │
│ Congratulations! The access threshold has been met. │
│ │
│ ──────────────────────────────────────────────────────── │
│ │
│ PERSONAL MESSAGE FROM HOST: │
│ ──────────────────────────────────────────────────────── │
│ "Dear Family, │
│ │
│ If you're reading this, I'm gone. I wanted to │
│ make sure you had access to these important │
│ documents. I love you all..." │
│ │
│ ──────────────────────────────────────────────────────── │
│ │
│ YOUR DOCUMENTS: │
│ ──────────────────────────────────────────────────────── │
│ │
│ 📄 last_will_and_testament.pdf 2.4 MB ✅ Verified │
│ 📄 insurance_policy_details.pdf 1.1 MB ✅ Verified │
│ 📄 account_passwords.odt 340 KB ✅ Verified │
│ 📄 letter_to_family.docx 125 KB ✅ Verified │
│ │
│ [Download All as ZIP] [View Individual] │
│ │
│ ──────────────────────────────────────────────────────── │
│ │
│ ⚠️ Access expires in 5 days, 12 hours │
│ │
└─────────────────────────────────────────────────────────────┘Document List
Each document shows:
- Icon — Based on file type
- Filename — Original name as uploaded
- Size — File size
- Status — ✅ Verified or ⚠️ Warning
Viewing Documents
Individual Viewing
Click on any document to view in-browser:
- PDFs can be viewed in browser
- Images display directly
- Text files shown as plain text
Download Options
Download All (ZIP)
Creates a ZIP archive of all documents:
- Click "Download All as ZIP"
- System creates archive (may take time for large files)
- Browser downloads ZIP file
- Extract to view individual files
Individual Download
Click document row to download single file:
- Click document
- Download starts automatically
- File saves to your device
Document Integrity
Verification Status
Each document shows verification status:
| Status | Meaning |
|---|---|
| ✅ Verified | SHA-256 hash matches; document intact |
| ⚠️ Warning | Hash mismatch; document may be modified |
Hash Verification
When documents are encrypted:
- SHA-256 hash of original is computed
- Hash is stored in database
- When decrypted, hash is recomputed
- If match → ✅ Verified
- If mismatch → ⚠️ Warning
If Warning Shown
If you see ⚠️ Warning:
- Document may have been tampered with
- Access is still provided
- Consider investigating
- Log was created for security team review
Download Expiry
Time Limit
Access window is 7 days (default) from threshold met.
Expiry Notification
You'll see:
- Countdown timer on portal
- Email notifications as deadline approaches
After Expiry
When access window ends:
- Documents are re-encrypted
- New SSS shares generated
- Portal shows "Access Expired"
- New transfer would need to be initiated
Download URLs
Presigned URLs
Documents are accessed via presigned URLs:
- Time-limited (typically 1 hour)
- Single-use option available
- Specific to your session
URL Properties
- Cannot be shared publicly
- Expire after set time
- Tied to your verified session
File Types Supported
Viewable In-Browser
| Type | Extension | Viewer |
|---|---|---|
| Built-in PDF viewer | ||
| Images | .jpg, .jpeg, .png | Built-in image viewer |
| Text | .txt | Plain text display |
Download Required
| Type | Extension | Notes |
|---|---|---|
| Word | .doc, .docx | Download to open |
| OpenDocument | .odt | Download to open |
| Rich Text | .rtf | Download to open |
Personal Message
What's Included
The personal message is text you wrote when the host added you as survivor. It's displayed at the top of the access portal.
Example
"Dear Jane,
If you're reading this, I'm gone. I want to thank you for being part of my life. These documents contain everything you need to settle my affairs.
Take care of each other. I love you all."
Access Window Management
Extending Access
Currently, access window cannot be extended. After 7 days:
- Documents are re-sealed
- New transfer would need to start
Downloading Early
Download documents early in the access window:
- Don't wait until the last day
- Store securely on your device
- You can download multiple times during window
Sharing Documents
With Other Survivors
The portal shows which survivors have authenticated:
- You can see who else has access
- Documents can be shared among verified survivors
With Others
Not recommended to share outside survivors:
- Documents may contain sensitive information
- Other survivors may have different views
- Host may have intended limited distribution
Troubleshooting
"Documents not loading"
- Check your authentication is valid
- Refresh the page
- Try downloading instead
"Download failed"
- Check internet connection
- Try individual downloads
- Check storage space
"Access expired"
- Access window has closed
- Contact other survivors
- May need to initiate new transfer
"Document corrupted"
- May show ⚠️ warning
- Try downloading again
- Contact other survivors to compare
Best Practices
After Access
- Download immediately — Don't wait
- Verify documents — Check expected files present
- Read personal message — May contain instructions
- Store securely — Keep private, share carefully
Security
- Don't share credentials
- Protect downloaded files
- Consider encryption for local storage
What Next
After accessing documents:
- Review all documents
- Follow any instructions from host
- Coordinate with other survivors
- Settle affairs per will
Summary
Accessing documents is straightforward:
- Receive notification that threshold met
- Visit portal
- View personal message
- Download/view documents
- Verify integrity
- Access for 7 days
Next Steps
- Receiving Access — Initial notification
- OTP Verification — Authentication process