> ## Documentation Index
> Fetch the complete documentation index at: https://docs.porcia.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser Extension

> Detects SaaS logins in the background — privacy-first, lightweight, and automatic.

# Browser Extension

The extension runs quietly in the background and detects when your team logs into SaaS tools. It's how your agent catches shadow IT and identifies licenses nobody's opening.

## Why Install the Extension?

<CardGroup cols={2}>
  <Card title="Login Detection" icon="chart-line">
    See which apps your team actually logs into vs. what they have access to
  </Card>

  <Card title="Shadow IT Detection" icon="eye">
    Discover SaaS tools being used outside of official channels
  </Card>

  <Card title="License Optimization" icon="dollar-sign">
    Identify underutilized licenses and potential cost savings
  </Card>

  <Card title="Privacy-First" icon="shield">
    All analysis happens locally - only domain names, detection method, and a work email boolean are shared
  </Card>
</CardGroup>

## Installation Guide

<Steps>
  <Step title="Open Chrome Web Store">
    Go to the [Chrome Web Store](https://chrome.google.com/webstore) and search for "Porcia"
  </Step>

  <Step title="Add to Chrome">
    Click **Add to Chrome** button on the extension page
  </Step>

  <Step title="Confirm Installation">
    Click **Add extension** in the confirmation popup

    The extension will be installed and you'll see the Porcia icon in your browser toolbar
  </Step>

  <Step title="Sign In">
    Click the Porcia extension icon in your toolbar

    Sign in with your Porcia account credentials
  </Step>

  <Step title="Grant Permissions">
    The extension will request permissions to:

    * Monitor login events on web pages
    * Access active tab information

    Click **Allow** to enable login detection
  </Step>

  <Step title="Start Detecting">
    The extension will automatically start detecting SaaS logins

    Log into any SaaS application to begin collecting data
  </Step>
</Steps>

<Info>
  The extension detects login events — form submissions, OAuth clicks, and SSO redirects. Consumer domains like google.com, youtube.com, and reddit.com are automatically excluded.
</Info>

## Browser Compatibility

### Supported Browsers

<Tabs>
  <Tab title="Chrome">
    **Fully Supported**

    * Chrome 88+ (recommended)
    * All Chrome features available
    * Automatic updates
    * Best performance
  </Tab>

  <Tab title="Edge">
    **Supported via Chrome Web Store**

    * Microsoft Edge 88+ (Chromium-based)
    * Install from Chrome Web Store
    * All features available
    * May require enabling Chrome Web Store access
  </Tab>

  <Tab title="Brave">
    **Supported via Chrome Web Store**

    * Brave 1.20+
    * Install from Chrome Web Store
    * All features available
    * Privacy features compatible
  </Tab>

  <Tab title="Other Browsers">
    **Not Currently Supported**

    * Firefox: Planned for future release
    * Safari: Under consideration
    * Opera: May work via Chrome Web Store
  </Tab>
</Tabs>

### System Requirements

* **Operating System:** Windows 10+, macOS 10.14+, Linux (Ubuntu 18.04+)
* **RAM:** 4GB minimum (8GB recommended)
* **Storage:** 50MB free space
* **Network:** Internet connection required for data sync

## Extension Permissions

### What the Extension Can Access

**Login Event Detection:**

* ✅ Domain name where a login event occurred
* ✅ Detection method (login form, OAuth, SSO redirect, URL pattern)
* ✅ Whether a work email was used (boolean only — the email itself is never stored)
* ✅ Timestamp of the login event

### What the Extension CANNOT Access

* ❌ **Page content** - Never reads what's on the page
* ❌ **Email addresses** - Only checks if an email matches a corporate domain, never stores the address
* ❌ **Passwords** - Never captures passwords or credentials
* ❌ **Personal browsing** - Consumer domains (google.com, youtube.com, reddit.com, etc.) are excluded
* ❌ **Downloads** - Never accesses downloaded files
* ❌ **Bookmarks** - Never reads your bookmarks
* ❌ **Other extensions** - Cannot interact with other extensions

<Warning>
  The extension monitors login events (form submissions, OAuth clicks, SSO redirects) on all pages except excluded consumer domains. It does not track general browsing or page visits.
</Warning>

## Privacy & Security

### Data Collection

**What gets tracked:**

* Domain name (e.g., "slack.com")
* Detection method (login\_form, oauth\_google, oauth\_microsoft, saml\_sso, url\_pattern)
* Whether a work email was used (boolean only)
* Timestamp of the login event

**What doesn't get tracked:**

* Specific page URLs or paths
* Page content or text
* Email addresses or passwords
* Personal browsing
* Consumer domains (google.com, youtube.com, reddit.com, etc.)

### Local Processing

All analysis happens locally in your browser:

1. **Extension monitors** login events (form submissions, OAuth clicks, SSO redirects)
2. **Local analysis** determines if a login or authentication event occurred
3. **Event data** is queued locally for batch sync
4. **Events are sent** to Porcia in batches every 5 minutes (domain + detection method + work email boolean)

### Data Transmission

Only login event data is sent to Porcia:

```json theme={null}
{
  "eventId": "uuid",
  "domain": "slack.com",
  "startTime": "2026-03-04T10:00:00Z",
  "endTime": "2026-03-04T10:00:05Z",
  "duration": 5,
  "detectionMethod": "oauth_google",
  "workEmailUsed": true
}
```

<Info>
  No personally identifiable information or specific page data is ever transmitted. Email addresses are checked locally but never stored or sent.
</Info>

## Extension Settings

### Accessing Settings

1. Click the Porcia extension icon
2. Click the **Settings** gear icon
3. Configure your preferences

### Available Settings

**Detection Control:**

* ✅ **Pause detection** - Temporarily stop all login detection
* ✅ **Resume detection** - Resume detection after pause

**Domain Management:**

* ✅ **Exclude domains** - Add domains to never detect logins on

**Privacy Settings:**

* ✅ **Incognito mode** - Enable/disable detection in private browsing

**Sync Settings:**

* ✅ **Offline mode** - Continue detecting when offline, events sync when connection is restored

<Tip>
  You can pause detection anytime by clicking the extension icon and toggling "Pause Detection".
</Tip>

## Team Deployment

### IT Administrator Setup

For organizations deploying to multiple users:

**Chrome Enterprise:**

1. Go to **Google Admin Console → Devices → Chrome → Apps & extensions**
2. Click **Add Chrome app or extension**
3. Search for "Porcia" in the Chrome Web Store
4. Set **Installation policy** to **Force install**
5. Configure **Extension settings** (optional)
6. Apply to organizational units

**Microsoft Edge for Business:**

1. Go to **Microsoft 365 Admin Center → Settings → Microsoft Edge**
2. Add Porcia extension to **Allowed extensions**
3. Configure via Group Policy if needed

**Deployment Script:**

```bash theme={null}
# Chrome deployment via registry (Windows)
# Replace EXTENSION_ID with the Porcia extension ID from the Chrome Web Store
reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist" /v 1 /t REG_SZ /d "EXTENSION_ID;https://clients2.google.com/service/update2/crx"

# Chrome deployment via plist (macOS)
defaults write com.google.Chrome ExtensionInstallForcelist -array "EXTENSION_ID;https://clients2.google.com/service/update2/crx"
```

### User Onboarding

**For team rollouts:**

1. **Send installation guide** to all team members
2. **Provide Porcia account credentials** or signup links
3. **Set expectations** about privacy and data collection
4. **Offer training session** on extension features
5. **Create support channel** for questions

<Accordion title="Sample team email template">
  **Subject:** Install Porcia Browser Extension - Track Our SaaS Usage

  Hi team,

  We're rolling out the Porcia browser extension to help us understand which SaaS tools we're actually using and optimize our software spending.

  **What it does:**

  * Detects logins to business applications (like Slack, Salesforce, etc.)
  * Helps identify unused licenses we can cancel
  * Discovers shadow IT tools we should evaluate

  **Privacy:**

  * Only detects login events, not general browsing
  * Consumer domains (Google, YouTube, etc.) are excluded
  * No page content, passwords, or email addresses are captured
  * You can pause detection anytime

  **Installation:**

  1. Go to \[Chrome Web Store link]
  2. Click "Add to Chrome"
  3. Sign in with your Porcia account
  4. Start browsing normally

  Questions? Reply to this email or ask in #it-support.

  Thanks!
  \[Your Name]
</Accordion>

## Troubleshooting

### Extension Not Working

**Extension icon not visible:**

1. Check if extension is installed: `chrome://extensions/`
2. Ensure extension is enabled
3. Pin extension to toolbar: Click puzzle piece icon → Pin Porcia

**Not detecting logins:**

1. Verify you're signed in to Porcia account
2. Check if detection is paused in extension settings
3. Ensure you're logging into a SaaS application (not just visiting)
4. Check browser permissions are granted

**Data not syncing:**

1. Check internet connection
2. Verify Porcia account is active
3. Try manual sync from extension popup
4. Check for browser console errors

### Performance Issues

**Browser running slowly:**

1. Check if multiple tracking extensions are installed
2. Clear extension local storage
3. Restart browser

**High memory usage:**

1. Check extension memory usage: `chrome://task-manager/`
2. Exclude high-traffic domains if needed
3. Update to latest extension version

### Privacy Concerns

**Accidentally tracked personal site:**

1. Add domain to exclusion list in settings
2. Clear local data for that domain
3. Contact support to remove from account

**Want to review tracked data:**

1. Go to Porcia dashboard → Usage Analytics
2. View all tracked domains and time spent
3. Export data if needed
4. Delete specific entries if required

<Info>
  **Need Help?** Check our [FAQ](/troubleshooting/faq) or contact [support@porcia.org](mailto:support@porcia.org) for assistance.
</Info>

## Uninstalling the Extension

### Remove Extension

1. Go to `chrome://extensions/`
2. Find Porcia extension
3. Click **Remove**
4. Confirm removal

### Clear Data

To remove all local data:

1. Before uninstalling, open extension settings
2. Click **Clear all local data**
3. Confirm data deletion
4. Then uninstall extension

<Info>
  Uninstalling the extension will stop login detection but won't delete your historical data in Porcia. Contact support if you want to delete all usage data.
</Info>

## Next Steps

<CardGroup cols={2}>
  <Card title="Extension Usage Guide" icon="mouse-pointer" href="/integrations/extension/usage">
    Learn how to use the extension effectively
  </Card>

  <Card title="Privacy Details" icon="shield" href="/integrations/extension/privacy">
    Read detailed privacy information
  </Card>

  <Card title="View Usage Analytics" icon="chart-line" href="/features/spend-analytics">
    See your usage data in Porcia
  </Card>

  <Card title="Manage Team" icon="users" href="/workspace/team-management">
    Deploy to your team
  </Card>
</CardGroup>