Skip to main content

​
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.
Connection Method: Admin Credentials Setup Time: 10 minutes Access Required: Censornet Super User account

​
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

Web Filtering Monitoring

Monitor web filtering policies and blocked access attempts

Security Policy Validation

Verify web security policies are enforced across devices

Compliance Tracking

Track web access compliance with organisational policies

Risk Assessment

Assess web-based security risks and policy violations

​
Setup instructions

1

Log in to Censornet Admin Console

Access the Censornet Console using an account with Super User permissions.
2

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
ThreatAware requires Super User permissions to access all necessary data
3

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
4

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

​
Required credentials

Field Name: Censornet Username Type: String Description: Username for Censornet Super User accountFormat: Email address or username format (e.g., threatawareapi@youremaildomain.com) Placeholder: threatawareapi@youremaildomain.com
The account must have Super User permissions in Censornet
Field Name: Censornet Password Type: Password (encrypted) Description: Password for the Censornet Super User account
Store this credential securely in your organisation’s password manager for future reference

​
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

Symptoms: Integration status shows authentication failureSolutions:
  • 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
Symptoms: Connection succeeds but no web filtering data appearsSolutions:
  • 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 for required permissions
  • Consider creating a dedicated admin account with full permissions
Symptoms: Integration fails to connect or times outSolutions:
  • 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
Symptoms: Integration shows active but no web filtering data appearsSolutions:
  • 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
Symptoms: Login fails after multiple attemptsSolutions:
  • 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

​
Additional resources

Censornet API Documentation

Official Censornet documentation for detailed API and permission information

ThreatAware Support

Contact ThreatAware support for integration assistance

​
Best practices

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
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