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

# Censornet

> Connect ThreatAware to Censornet for web filtering and security policy data

## Overview

The Censornet integration enables ThreatAware to collect web filtering and security policy data from your Censornet environment, providing visibility into web access controls and security posture.

<Info>
  **Connection Method**: Admin Credentials
  **Setup Time**: 10 minutes
  **Access Required**: Censornet Super User account
</Info>

## Data collected

The Censornet integration provides:

* Web filtering policy data
* Blocked access attempts
* Content filtering logs
* Security policy compliance data
* User web activity insights

## Use cases

<CardGroup cols={2}>
  <Card title="Web Filtering Monitoring" icon="globe">
    Monitor web filtering policies and blocked access attempts
  </Card>

  <Card title="Security Policy Validation" icon="shield-check">
    Verify web security policies are enforced across devices
  </Card>

  <Card title="Compliance Tracking" icon="clipboard-check">
    Track web access compliance with organisational policies
  </Card>

  <Card title="Risk Assessment" icon="triangle-exclamation">
    Assess web-based security risks and policy violations
  </Card>
</CardGroup>

## Setup instructions

<Steps>
  <Step title="Log in to Censornet Admin Console">
    Access the [Censornet Console](https://portal.censornet.com) using an account with **Super User** permissions.
  </Step>

  <Step title="Verify or Create Admin Account">
    Ensure you have or create an admin account with **Super User** permissions:

    * Navigate to **Settings** or **User Management** in Censornet
    * Either create a new dedicated admin account or identify an existing one
    * Note the **Username** and **Password** for this account
    * Confirm the account has **Super User** permissions

    <Info>
      ThreatAware requires Super User permissions to access all necessary data
    </Info>
  </Step>

  <Step title="Configure in ThreatAware">
    Complete the integration setup in ThreatAware:

    * Open ThreatAware and navigate to **Settings** > **Integrations**
    * Search for and select **Censornet**
    * Enter the required admin credentials:
      * **Username**: The Super User account username
      * **Password**: The Super User account password
    * Click **Connect** to establish the integration
  </Step>

  <Step title="Verify Connection">
    After connecting:

    * Check that the **Integration Status** shows as **Active**
    * Verify that web filtering data begins appearing in ThreatAware within 5-10 minutes
    * Check the last sync timestamp
  </Step>
</Steps>

## Required credentials

<AccordionGroup>
  <Accordion title="Username" icon="user">
    **Field Name**: Censornet Username
    **Type**: String
    **Description**: Username for Censornet Super User account

    **Format**: Email address or username format (e.g., `threatawareapi@youremaildomain.com`)
    **Placeholder**: `threatawareapi@youremaildomain.com`

    <Info>
      The account must have Super User permissions in Censornet
    </Info>
  </Accordion>

  <Accordion title="Password" icon="lock">
    **Field Name**: Censornet Password
    **Type**: Password (encrypted)
    **Description**: Password for the Censornet Super User account

    <Tip>
      Store this credential securely in your organisation's password manager for future reference
    </Tip>
  </Accordion>
</AccordionGroup>

## Verification and testing

After setup, verify the integration is working correctly:

1. **Check Integration Status**
   * Navigate to **Settings** > **Integrations** in ThreatAware
   * Confirm Censornet shows **Active** status
   * Check the last sync timestamp

2. **Verify Data Collection**
   * Wait 5-10 minutes for the initial data poll
   * Check for web filtering policy data in ThreatAware
   * Verify the data matches what you see in Censornet

3. **Test Queries**
   * Create a test query to filter devices with Censornet data
   * Verify the policy and filtering data matches your expectations

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid Credentials Error" icon="triangle-exclamation">
    **Symptoms**: Integration status shows authentication failure

    **Solutions**:

    * Verify the **Username** and **Password** are correct
    * Ensure credentials were entered without extra spaces
    * Confirm the account is not locked or expired in Censornet
    * Test the credentials by logging directly into Censornet
    * Contact your Censornet administrator if you forgot the password
  </Accordion>

  <Accordion title="Permission Issues" icon="ban">
    **Symptoms**: Connection succeeds but no web filtering data appears

    **Solutions**:

    * Verify the account has **Super User** permissions in Censornet
    * Navigate to **Settings** > **User Management** in Censornet to check permissions
    * Ensure the account is not restricted to specific organisational units
    * Review the [Censornet Documentation](https://www.censornet.com/support) for required permissions
    * Consider creating a dedicated admin account with full permissions
  </Accordion>

  <Accordion title="Connection Timeout" icon="clock">
    **Symptoms**: Integration fails to connect or times out

    **Solutions**:

    * Verify the Censornet portal is accessible and online
    * Check firewall rules allow outbound HTTPS (443) to Censornet
    * Test the Censornet URL in a browser to ensure connectivity
    * Verify your internet connection is stable
    * Try connecting again after waiting a few minutes
  </Accordion>

  <Accordion title="No Data After 10 Minutes" icon="database">
    **Symptoms**: Integration shows active but no web filtering data appears

    **Solutions**:

    * Verify there is web filtering policy data in Censornet to collect
    * Check that the admin account has visibility to all policies
    * Ensure web filtering is enabled and actively processing data in Censornet
    * Review ThreatAware integration logs for errors
    * Wait up to 30 minutes for initial data sync to complete
  </Accordion>

  <Accordion title="Account Locked" icon="lock-exclamation">
    **Symptoms**: Login fails after multiple attempts

    **Solutions**:

    * Wait 15-30 minutes before retrying
    * Contact your Censornet administrator to unlock the account
    * Verify the account is still active in Censornet user management
    * Use a different admin account if available
    * Create a new dedicated integration account with Super User permissions
  </Accordion>
</AccordionGroup>

## Additional resources

<CardGroup cols={2}>
  <Card title="Censornet API Documentation" icon="book" href="https://www.censornet.com/support">
    Official Censornet documentation for detailed API and permission information
  </Card>

  <Card title="ThreatAware Support" icon="life-ring" href="mailto:help@threataware.com">
    Contact ThreatAware support for integration assistance
  </Card>
</CardGroup>

## Best practices

<Tip>
  **Credential Management**

  * Create a dedicated Super User account specifically for ThreatAware
  * Document the account in your organisation's credential manager
  * Rotate passwords annually or per your security policy
  * Monitor for authentication failures in ThreatAware regularly
  * Do not share the account with other systems or users
</Tip>

<Tip>
  **Security Considerations**

  * Ensure the service account has only the necessary Super User permissions
  * Limit account usage to ThreatAware integration only
  * Review Censornet audit logs periodically to monitor account usage
  * Follow your organisation's principle of least privilege
  * Consider IP whitelisting if Censornet supports it
</Tip>