CrowdProof-Observe-Chrome/CWS/CWS.md

128 lines
4.3 KiB
Markdown

# CrowdProof Observe - Chrome Web Store Submission
## Extension Details
**Name:** CrowdProof Observe
**Summary (132 chars max):**
Quick-add observations to your CrowdProof instance. Submit photos, URLs, emails, logs, and statements from your browser.
**Category:** Productivity
**Language:** English
---
## Description
CrowdProof Observe is the official browser companion for CrowdProof, a collaborative evidence, observation management, intelligence collection, and publication platform.
### Features
- **Side Panel Interface** - Submit observations without leaving your current page
- **Multiple Observation Types** - Photos, URLs, emails (.msg/.eml), logs, and statements
- **Quick Capture** - Right-click images or links to send directly to CrowdProof
- **Paste to Submit** - Paste screenshots directly from clipboard
- **Access Management** - Set public access levels for your observations
- **Server Flexibility** - Connect to any CrowdProof instance
### How It Works
1. Configure your CrowdProof server URL in settings
2. Log in with your CrowdProof credentials
3. Use the side panel or right-click context menus to submit observations
4. Manage public access settings for your observations
Note: This extension defaults to use the public instance of CrowdProof by design and intent, however, requires the configurability to point to other instances for SaaS and self-hosted clients and their users.
---
## Permissions Justification
| Permission | Reason |
|------------|--------|
| `storage` | Stores the user's configured server URL locally in browser storage. |
| `activeTab` | Captures the current page's URL and title when user clicks "Capture Current Page" for URL observations. |
| `cookies` | Maintains authenticated session cookies with the user's CrowdProof server. |
| `contextMenus` | Provides right-click menu options ("Send Image to CrowdProof", "Send Link to CrowdProof"). |
| `sidePanel` | Displays the observation submission interface in Chrome's native side panel. |
### Host Permissions
| Permission | Reason |
|------------|--------|
| `<all_urls>` | Necessary to communicate with user-configured CrowdProof server instances hosted at arbitrary domains. The extension does not access or modify page content on other sites. |
---
## Privacy Policy
**Last Updated:** 2025-12-30
### Data Collection
CrowdProof Observe does not collect, store, or transmit any user data to third parties.
### Server Communication
The extension communicates exclusively with the CrowdProof server URL configured by the user. All data submitted through the extension (observations, images, credentials) is sent only to this user-specified server.
### Local Storage
The extension stores only the following data locally in browser storage:
- The configured server URL
- Temporary pending image/URL data for context menu actions (cleared after use)
### Cookies
Session cookies are used to maintain authentication with the configured CrowdProof server. These cookies are managed by the browser and scoped to the server domain.
### No Tracking
This extension does not include any analytics, telemetry, or tracking functionality.
### Contact
For privacy inquiries, contact SILO GROUP at `pr@silogroup.org`
---
## Screenshots
Recommended screenshots for submission (located in `screenshots/` directory):
1. **main_sidebar.png** - Main side panel showing the photo observation form
2. **access_manager.png** - Access management screen with observation list
3. **context-menu-1.png** - Right-click "Send Image to CrowdProof" option
4. **context-menu-2.png** - Right-click "Send Link to CrowdProof" option
---
## Technical Notes for Reviewers
- Manifest V3 compliant
- Source code is unobfuscated and readable
- No external scripts or CDN dependencies
- No data exfiltration - only communicates with user-configured server
- Uses Chrome Side Panel API for native browser integration
- Server URL defaults to `https://crowdproof.silogroup.org` but is user-configurable
---
## Links
- **Homepage:** https://crowdproof.silogroup.org
- **Support Email:** crowdproof-support@silogroup.org
- **Privacy Policy URL:** https://www.silogroup.org/legal/privacy/
---
## Packaging
To create the submission zip (excludes CWS directory and markdown files):
```bash
cd crowdproof-observe-chrome
zip -r crowdproof-observe-chrome.zip . -x "*.git*" -x "CWS/*" -x "CWS" -x "*.md"
```