Skip to main content

v0.11.0: Secure Report Sharing with Share Links

· 3 min read
TestPlanIt Team
TestPlanIt Team
Contributor

We're excited to announce TestPlanIt v0.11.0, introducing Share Links - a new feature for securely sharing reports with team members, clients, and stakeholders without requiring them to have a TestPlanIt account.

Share Links enable you to distribute reports through secure, customizable URLs with three access modes:

Access Modes​

Authenticated Mode

  • Requires login with project access
  • Full interactive experience with all report features
  • Best for internal stakeholders and sensitive data

Public Mode

  • No authentication required
  • Read-only view with filtered data (emails and IDs removed)
  • Perfect for public dashboards and transparency reports

Password-Protected Mode

  • Requires password to access
  • Rate limiting (5 attempts per 15 minutes)
  • Auth bypass for logged-in team members
  • Ideal for client reports and confidential sharing

Configuration Options​

  • Custom titles and descriptions
  • Expiration dates for time-limited access
  • Password protection with bcrypt hashing
  • Notify on view to receive notifications when accessed
  • Project or cross-project sharing

Access Management​

Manage shares from three locations:

  • Project Settings → Shares
  • Admin Panel → Shares (cross-project view)
  • Share Dialog → "My Shares" tab

Available actions:

  • Copy share URLs to clipboard
  • Edit titles, descriptions, passwords, and expiration dates
  • Toggle notifications on/off
  • Revoke or delete shares

Access Analytics​

View Tracking

  • View counter per share
  • Last viewed timestamp
  • Session-based tracking

Access Logs

  • Viewer name/email or "Anonymous"
  • IP address and user agent
  • Access timestamp
  • Authentication status

Notifications

  • In App/Email notifications when links are accessed
  • Includes viewer info and access timestamp
  • Toggle on/off anytime

Security Features​

  • 256-bit entropy share keys (43 characters)
  • Bcrypt password hashing (10 rounds)
  • Rate limiting on password attempts
  • Automatic expiration and revocation enforcement
  • Data filtering for public shares
  • Complete audit logging
  • Multi-tenant security
  1. Configure and generate your report in Report Builder
  2. Click the Share button
  3. Choose access mode (Authenticated, Public, or Password-Protected)
  4. Set title, description, expiration, and other options
  5. Click Create Share and copy the link

Share URL format: https://app.testplanit.io/share/{shareKey}

Common Use Cases​

  • Client Reporting: Password-protected links with expiration dates
  • Public Dashboards: Open metrics for transparency
  • Team Collaboration: Authenticated links for project members
  • Stakeholder Updates: Weekly/monthly reports with notifications
  • Executive Summaries: High-level metrics with full context

Upgrade Instructions​

To upgrade to v0.11.0:

git pull origin main
pnpm install
pnpm generate
pnpm build

For Docker deployments:

docker pull ghcr.io/testplanit/testplanit:latest

Documentation​

Comprehensive documentation is available in the user guide:

  • Share Links User Guide - Complete feature documentation
  • Security best practices and recommendations
  • Troubleshooting guide for common issues
  • API reference for ShareLink models

Get Involved​

Thank you for using TestPlanIt!