Applies to: CyBlock Directory Agent (installer fails with “iawin32.dll not found” or a Fatal Application Error)
When you run the Directory Agent Installer on some newer versions of Windows, the installation may fail with an error. The installer framework doesn’t recognize the Windows version it’s running on, so it can’t complete the install. The fix is to tell the installer it’s running on a Windows version it does recognize, then run it from the same Command Prompt window.
What you’ll see
You’ll get one of these two errors:
iawin32.dll not found
A Fatal Application Error pop-up that says: “This Application has Unexpectedly Quit. Invocation of this Java Application has caused an InvocationTargetException. This application will now exit.”
Both errors have the same cause and the same fix.
The fix
The fix: Set a temporary Java override that reports the operating system as Windows Server 2016, then run the installer from that window.
Open Command Prompt as an administrator: right-click Command Prompt and choose Run as administrator. Use Command Prompt, not PowerShell, because the set command below doesn’t work the same way in PowerShell.
Enter the following command:
set JAVA_TOOL_OPTIONS="-Dos.name=Windows Server 2016"
Change to the folder where you downloaded the installer. For example:
cd /d "C:\Users\<username>\Downloads\cbda"
Start the installer:
.\cbsa.exe
Complete the installation as usual.
The override only applies inside that Command Prompt window. Nothing changes on the server, and the setting goes away when you close the window.
If the installer still fails, contact Wavecrest Technical Support. Include your Windows version and a screenshot of the error.
Quick summary
“iawin32.dll not found” or “InvocationTargetException” → Run the installer from an admin Command Prompt with JAVA_TOOL_OPTIONS set as shown above.
You used PowerShell and the error is still there → Use Command Prompt (cmd.exe) instead.
It still fails in Command Prompt → Contact Wavecrest Technical Support.
How to Point Your Browser at CyBlock (Manual Settings and PAC File)
Applies to: CyBlock · Connecting browsers to your CyBlock web filter — manual settings for testing, PAC file via Group Policy for production.
CyBlock is a web filter that businesses use to control and monitor employee web access. To have a browser send its traffic through CyBlock, you point the browser at your CyBlock server using its connection settings. There are two ways to do this: for production, push CyBlock’s PAC file to all browsers using Group Policy (GPO) so every machine is configured automatically and stays consistent; for quick testing on a single machine, enter the connection settings manually in the browser.
Before you begin
You’ll need your CyBlock connection settings:
The server address and port for your CyBlock filter
Your PAC file URL (for PAC-based setup) — see Finding your PAC file URL below
Where to find your connection settings: These are specific to your deployment. Find the server address and port in the product under Settings → Proxy. If you’re on the CyBlock Cloud service, use the connection details Wavecrest provided when your account was set up. If you can’t locate them, contact us at 321-953-5351 or support@wavecrest.net.
Finding your PAC file URL
Your PAC file URL is available in CyBlock at:
Settings → Proxy → PAC File
Use this URL wherever a PAC or automatic-configuration URL is required below.
Which method should I use?
Production → push the PAC file via Group Policy. It’s centrally managed, consistent across all machines, and updates everywhere when the PAC file changes.
Testing / a single machine → enter the connection settings manually in the browser.
Manual setup (for testing)
Google Chrome, Microsoft Edge, and Internet Explorer (Windows connection settings)
Chrome, Edge, and Internet Explorer all use the Windows system connection settings, so configuring them once covers all three. (Chrome’s and Edge’s own buttons simply open these Windows settings.)
Windows 10 / 11:
Open Settings → Network & Internet → Proxy.
To connect directly: under Manual proxy setup, turn on Use a proxy server and click Set up. Enter your CyBlock server address and port, then click Save.
To use the PAC file instead: under Automatic proxy setup, turn on Use setup script, enter your PAC file URL, then click Save.
Classic dialog (any Windows version):
Press Win + R, type inetcpl.cpl, and press Enter to open Internet Options.
On the Connections tab, click LAN settings.
To connect directly: check Use a proxy server for your LAN, enter your CyBlock server address and port, and clear the other checkboxes.
For the PAC file: check Use automatic configuration script and enter your PAC file URL in the Address field.
Click OK, then OK again.
Mozilla Firefox
Firefox keeps its own connection settings, separate from Windows.
Click the menu button (☰) and choose Settings.
In the General panel, scroll down to Network Settings and click Settings….
To connect directly: select Manual proxy configuration, enter your CyBlock server address in the HTTP Proxy field, enter your port, and check Also use this proxy for HTTPS.
For the PAC file: select Automatic proxy configuration URL and enter your PAC file URL.
Click OK.
To have Firefox follow the Windows setting instead, choose Use system proxy settings.
Pushing the PAC file via Group Policy (for production)
Use Group Policy to deploy the PAC file to all managed browsers automatically. The correct method depends on the browser.
Google Chrome and Microsoft Edge (ADMX policies)
Import the Chrome and/or Edge ADMX templates into your domain Central Store (if not already present).
In Group Policy Management, edit the GPO that targets your users or computers.
Go to Computer Configuration → Policies → Administrative Templates → Google → Google Chrome → Proxy server (for Edge: Microsoft Edge → Proxy server).
Enable Choose how to specify proxy server settings and set it to Use a .pac proxy script.
Enable URL to a proxy .pac file and enter your PAC file URL.
Apply the GPO. Clients pick it up on the next policy refresh, or immediately with gpupdate /force.
Windows connection settings / Internet Explorer (Group Policy Preferences)
For browsers that rely on the Windows system connection settings (Internet Explorer, and Chrome/Edge where their own ADMX policies aren’t used):
In Group Policy Management, edit your GPO.
Go to User Configuration → Preferences → Control Panel Settings → Internet Settings and create a new item for your Windows/IE version.
Enable the Use automatic configuration script option and enter your PAC file URL. Press F5 so the setting applies (it turns green).
Apply the GPO.
The exact controls vary by Windows version; if the Internet Settings preference doesn’t expose the auto-config field on your build, push the PAC URL by setting the AutoConfigURL value under HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings with a Registry preference instead.
Note on older documentation: Earlier guides configured this through Internet Explorer Maintenance (User Configuration → Windows Settings → Internet Explorer Maintenance → Automatic Browser Configuration). That method no longer applies — Microsoft removed Internet Explorer Maintenance for managing Windows 8 and later, and Internet Explorer was retired in June 2022. Use the ADMX or Internet Settings methods above.
Deploying Cyfin or CyBlock in Azure, AWS, Docker, or Other Environments
Applies to: Cyfin · CyBlock · Choosing a deployment format or requesting a non-standard environment.
Cyfin and CyBlock are delivered by default as a VMware OVA file, a Hyper-V installer, or as a hosted Cloud service. Azure is not one of the standard self-service deployment options — but Wavecrest can support it. If you want to run the Cyfin trial (or CyBlock) in Microsoft Azure, contact Wavecrest and we’ll provide the correct image and setup guidance for your environment.
Standard deployment options
Both Cyfin and CyBlock ship in these formats by default:
VMware OVA file
Hyper-V installer
Cloud service (hosted by Wavecrest)
If your environment supports one of these, use the matching option and follow its standard installation guide.
Other supported environments
Need something different? We can support additional environments — they’re just not self-service downloads. These include:
Microsoft Azure
Amazon Web Services (AWS)
Docker containers
Other VMware-compatible virtualization platforms
For any of these, contact Wavecrest so we can supply the correct image and setup guidance for your platform.
How to get help
To request a deployment for Azure, AWS, Docker, or another environment, reach out to us:
Is Cyfin Receiving Syslog from Your Firewall or Proxy? A Troubleshooting Guide
If you’ve configured a firewall, proxy, or gateway — a SonicWall, Palo Alto, Checkpoint, WatchGuard, Cisco Firepower, Zscaler, or similar device — to send syslog to Cyfin, but your reports are empty, a device isn’t showing up, or the traffic you expect isn’t appearing, this guide will help you pin down where the problem is.
Almost every “Cyfin isn’t showing my firewall data” issue comes down to one question:
Is the syslog data actually reaching Cyfin?
That single question splits the problem into two very different situations, each with a different fix:
The data isn’t arriving. The stream isn’t reaching Cyfin at all. This is almost always something in how the sending device is configured to forward syslog, or something on the network path between it and Cyfin. We’ll show you how to confirm this and what to check.
The data is arriving, but Cyfin isn’t turning it into reports. The stream is reaching Cyfin, but Cyfin either doesn’t have a parser for that device’s log format, or the format isn’t quite what the parser expects. This is the case where we can help you directly — often quickly.
Work through the guide in order. The first job is simply to find out which of those two situations you’re in.
What Cyfin can parse
Cyfin reads log data from many firewall, proxy, and gateway devices, but it reads a specific set of log formats. When a device sends syslog in a format Cyfin recognizes, Cyfin parses it into users, sites, and categories automatically. When it sends a format Cyfin doesn’t yet recognize, the data can arrive perfectly and still produce nothing — because Cyfin doesn’t know how to read it.
Devices and formats Cyfin parses out of the box:
Palo Alto Network
Check Point
Cisco Firewall
Cisco Firepower
FortiGate
SonicWall
WatchGuard
Zscaler
If your device isn’t on that list, that doesn’t necessarily mean Cyfin can’t read it — it means we may need to add or adjust a parser for your specific format. See “The data is arriving, but nothing shows up” below; that’s a fast turnaround when we have a sample of your log.
Step 1: Confirm whether Cyfin is receiving the syslog
You can check this yourself, directly in Cyfin — no command-line or server access required. This works the same whether Cyfin is running in a VM on your own network or hosted in the cloud, so you don’t need to touch the underlying machine either way.
In Cyfin, go to:
System Status → Syslog → Syslog Status
This screen shows statistics on the syslog Cyfin is receiving, along with a live sampling of the incoming data. It’s the definitive, self-service answer to “is anything arriving?”:
You see stats climbing and sample data on the screen → syslog is reaching Cyfin. The problem, if any, is on the parsing side. Skip to “The data is arriving, but nothing shows up.” (Keep this screen open — the sample it shows is exactly what support will need, so it’s worth capturing now.)
The screen shows no activity — no stats, no sample — while the device should be sending → the data is not reaching Cyfin. Continue to Step 2.
Note for Cloud Cyfin customers: your instance is administered by Wavecrest, but you still confirm receipt yourself through this same Syslog Status screen. If the screen shows nothing and the send side checks out, Wavecrest can additionally verify at the network level on the hosted server — see Step 2.
Step 2: The data isn’t arriving — get the stream flowing
If nothing is reaching the server, the syslog isn’t leaving the sending device, isn’t addressed correctly, or is being stopped on the network in between. The exact steps to configure forwarding live in your device’s own admin interface — and because every vendor’s interface is different, those specific screens are outside what we can document for you. But the requirements the device has to meet are the same for every vendor, and you can verify each one:
1. Destination address. The device must be sending to the IP address (or hostname) of the Cyfin server. Confirm it’s pointed at the right host — not an old address, not a load balancer or gateway that drops it.
2. Port and protocol. The device must send on the port and protocol Cyfin is listening on (typically UDP/514 — but confirm against the value above). A mismatch here is one of the most common causes: the device sends on UDP/514, Cyfin listens on something else, and nothing lands.
3. A clear network path. Nothing between the device and Cyfin can be dropping the traffic. The usual culprits:
A firewall rule (often on the sending device itself, or a firewall in between) blocking outbound/inbound syslog on that port.
NAT or routing that prevents the packets from reaching the server.
The device and server being on segments that can’t reach each other.
How to localize the break: you own both ends you can actually see — the Syslog Status screen tells you nothing is arriving at Cyfin, and your sending device’s own logs or status page tell you whether it’s actually transmitting. If the device shows it’s sending but Cyfin’s Syslog Status stays empty, the packets are being lost on the network in between (firewall, NAT, or routing) — that’s the path to work through. If the device isn’t showing outbound syslog activity at all, the forwarding config on the device isn’t active yet, and that’s where to focus. For Cloud Cyfin, if you’ve confirmed the device is sending but nothing arrives, Wavecrest can capture at the network level on the hosted server to confirm definitively whether packets are reaching it.
We know that even though the sending device’s configuration is on your side of the fence, you’re looking to us to help you get this working — and we will. If you’ve verified the destination, port, and path and syslog still isn’t arriving, contact support (below) and we’ll help you work through it. What we can’t do is write the click-by-click steps for your specific vendor’s admin UI; for that, your device vendor’s syslog-forwarding documentation is the authority.means the network/firewall is eating them; not leaving the device at all means the forwarding config on the device isn’t active.
Step 3: The data is arriving, but nothing shows up
If the Syslog Status screen shows data arriving but Cyfin still produces no reports — or the data looks wrong, miscategorized, or partial — the issue is on the parsing side: Cyfin is receiving the stream but doesn’t have a parser that matches your device’s exact log format.
This is the case we can usually turn around quickly — as long as we can get a sample of your actual log. With a real sample in hand, adding or adjusting a parser for your format is fast, straightforward work. Without one, we’re guessing at a format we can’t see.
To get this resolved quickly, contact support and include:
The device sending the logs — make and model (e.g. “SonicWall TZ470”, “Palo Alto PA-440”).
A sample of the raw syslog — a handful of representative lines exactly as they arrive. The easiest place to get this is the System Status → Syslog → Syslog Status screen, which shows a live sampling of the incoming data; copy or screenshot those lines so we see the real bytes Cyfin is receiving, not a reformatted copy.
What you expected to see in Cyfin versus what you’re actually getting (nothing at all, wrong users, wrong categories, etc.).
That sample is the one thing that turns “my device doesn’t work with Cyfin” into “here’s the format, we’ll add the parser.” The faster we have it, the faster this closes.device doesn’t work with Cyfin” into “here’s the format, we’ll add the parser.” The faster we have it, the faster this closes.
Quick reference: which situation am I in?
What the Syslog Status screen shows
Where the problem is
What to do
No activity — no stats, no sample
Sending device config or network path
Step 2 — verify destination, port/protocol, and path; contact support if still stuck
Data arriving, but no reports in Cyfin
Parser / log format
Step 3 — send support a raw log sample
Data arriving, but reports look wrong
Parser needs adjustment
Step 3 — send support a raw log sample + what’s wrong
Haven’t checked yet
Unknown — check first
Step 1 — open System Status → Syslog → Syslog Status
Contact
For help confirming whether Cyfin is receiving your syslog, or to have us add or adjust a parser for your device, contact Wavecrest support:
[VERIFY — insert the canonical support contact (support email + technical support phone/extension). Per current routing: technical/syslog/parser issues go to SUPPORT, not sales. Sales — sales@wavecrest.net, 321-953-5351 — handles only licensing, renewals, and purchasing.]
When you contact us about syslog that’s arriving but not parsing, include the device make/model and a raw log sample — that’s what lets us turn it around fast.
VM on-prem deployment: syslog reception, ingestion, and report generation on one VM in the customer’s own environment. Cyblock adds live inline proxy traffic. Metric server sizing included separately. Result quality is identical to a split-tier deployment; the numbers below simply account for running these functions together.
All numbers are minimum production baselines (row 1 of each table) with headroom tiers above them. Scale up with log volume, report concurrency, and user count.
What to size for: concurrent workloads
In a VM on-prem deployment these functions run alongside each other, so provision for peak concurrency rather than any one job in isolation:
Syslog reception — light CPU, network-bound; give it burst headroom so it never drops.
Report generation — CPU-active and heap-active; a large report can use every core and a lot of heap.
Metric server — a distinct ES-backed process; include its resources when co-located.
The main case to plan for is a large report running during active ingestion — size so both run comfortably at the same time.
Cyfin (syslog + ingest + report)
Tier
vCPU
RAM (heap ≈ half)
Notes
Minimum production
4
8 GB (4 GB heap)
Light volume, few configs
Medium
8
16 GB (8 GB heap)
Comfortable report-while-ingest concurrency
Heavy
8–16
32 GB (12–16 GB heap)
Cores drive reporting parallelism
Heap past ~12–16 GB gives diminishing returns and longer GC pauses. Allocation rate, not heap size, is usually the practical ceiling — size cores and heap together rather than heap alone.
Cyblock
Everything above, plus the proxy serves user browsing in real time, so keep cores available for it. Size the proxy piece by concurrent users / request rate on top of the ingest+report sizing, and give the proxy guaranteed CPU.
Tier
vCPU
RAM
Notes
Minimum production
4–6
12 GB
Proxy + modest reporting
Medium
8
16–24 GB
Cores reserved for proxy
Heavy
12–16
32 GB+
Proxy connection state + category cache + report heap all resident
Metric server (out-of-the-box)
Distinct process powering real-time metrics/dashboards. Sizing scales with metric retention and dashboard/query concurrency. Heap guidance: keep heap ≤ 50% of RAM and under ~31 GB; the remaining RAM benefits disk caching.
Tier
vCPU
RAM (heap ≤ half)
Notes
Minimum production
4
8 GB (4 GB heap)
SSD-backed; rest of RAM aids caching
Medium
8
16 GB (8 GB heap)
Higher retention / more concurrent dashboards
Heavy
8–16
32 GB (≤16 GB heap)
Large metric volume; keep heap ~31 GB or under
When co-located, include the metric server’s resources in the box total, or give it its own CPU reservation.
VMware-specific guidance
Match vCPU to physical cores and avoid host overcommit for these VMs. CPU ready / co-stop time is invisible inside the guest and slows reporting. Prefer fewer, well-scheduled vCPUs over a large oversized count.
Set a memory reservation at (or near) full VM RAM so the JVM heap (product or metric server) is never ballooned or swapped — that keeps GC behavior predictable.
Cyblock: set a CPU reservation/shares so the live proxy always has cycles regardless of concurrent reporting.
Fast datastore — SSD-backed with PVSCSI. Report scans and metric-server indexing are disk-sensitive, so storage throughput is often the first thing to raise.
Note
To tighten these into a single recommendation, plug in the deployment’s log volume (GB/day or events/sec) and user count.
Renewing or Updating Your License (Cyfin & CyBlock)
Applies to: Cyfin and CyBlock · Renewing a license or extending a trial.
Your Cyfin or CyBlock license is renewed by contacting Wavecrest sales, who provide a new activation key. You then enter that key on the Update License Information screen to apply it. The process and screen are the same in both products.
Who needs to contact sales
Existing customers renewing their license — sales issues a new activation key once your renewal is arranged.
Trial / evaluation users — an evaluation includes a 14-day trial license. To extend the trial beyond 14 days, contact sales for an extended trial key.
In all cases, the activation key comes from sales; it isn’t self-generated in the product.
Where to find your license screen
Go to Settings → License → Update License Information.
The License Details screen shows your Organization Name, Server Alias Name, Serial Number, Activation Key, and the Key Status — the latter shows how many days remain and the expiration date (for example, “240 Day(s), until Apr 29, 2027”). Check Key Status any time to see when your license expires.
How to apply a new activation key
Contact Wavecrest sales to arrange your renewal (or trial extension). Sales provides a new activation key.
In the product, go to Settings → License → Update License Information.
Enter the new key in the Activation Key field (replacing the existing one).
Click Submit. The Key Status updates to reflect the new expiration date.
Contact
To renew, extend a trial, or ask any question about your license, contact Wavecrest sales:
There’s also a Contact Sales link on the License Details screen.
How to Change the Time Zone in Cyfin
Applies to: Cyfin · Setting the time zone for a data source.
Cyfin sets the time zone per data source, not as a single system-wide setting. There’s no global “product time zone” toggle — you set the time zone inside each data source’s configuration. This is by design: a large organization may pull logs from offices in different regions, and each data source can be interpreted in its own local time so the timestamps in reports are correct for where the activity actually happened.
You change it in the Data Source Setup wizard.
Steps
Go to Data Management → Setup. This opens the Data Source Setup wizard.
Select the data source you want to configure. Its settings screen (Data Source Setup) is displayed.
Locate the Timezone field and select the correct time zone for that data source from the drop-down (for example, America/Los Angeles).
Check the Raw Date and Parsed Date shown on the screen to confirm the offset is being applied as expected — the Parsed Date reflects the time zone you selected.
Click Next, then name the configuration and complete the wizard to save.
Notes
Set it per source. If you have multiple data sources from different regions, repeat these steps for each one and set each to its own local time zone.
Verify with Raw vs. Parsed Date. The Raw Date is the timestamp as it appears in the log; the Parsed Date is how Cyfin will interpret it after applying the selected time zone. Use the two together to confirm you’ve picked the right zone before finishing.
Cyfin — Why Are User IDs Missing From My Reports?
Applies to: Cyfin · When reports show no usernames (blank or IP addresses instead of people).
Cyfin reports on whatever is contained in the log or syslog data it ingests from your firewall or proxy. User IDs are what let Cyfin attribute web activity to specific people. If your reports show activity by IP address or blank instead of by username, the User ID is missing from the data Cyfin is receiving — and it’s almost always one of the two causes below.
(This is different from activity that appears under Ungrouped IDs — that means IDs are being captured but haven’t been organized into your Groups and IDs tree. See the Terms Glossary for Ungrouped IDs. This article is about IDs not being captured at all.)
Cause 1 — Your firewall or proxy isn’t capturing the User ID
This is the most common cause, and the key fact to understand:
The User ID is not a default field in any firewall or proxy log. A firewall or proxy only records who made a request if authentication is enabled on that device. By default, most devices log the connection (IP, URL, time, bytes) but not the authenticated username. If authentication isn’t turned on, there is simply no User ID in the log for Cyfin to report on — this is a configuration on the device, not something Cyfin can add after the fact.
The fix: enable user authentication on the firewall or proxy that generates your logs, so the authenticated User ID is written into the log/syslog. Once the device is capturing usernames, they flow into Cyfin and appear in reports.
How to do it depends on your device. Every firewall and proxy vendor has its own process and terminology for this — it may be called user authentication, user identification, User-ID, identity awareness, or similar. Consult your device’s documentation (or its vendor support) for how to enable authenticated user logging. Common examples include Palo Alto (User-ID), SonicWall, Fortinet (FSSO), and Check Point (Identity Awareness), among others.
How to confirm it’s a device issue: look at the raw log or syslog Cyfin is ingesting. If there’s no populated username field in the records themselves, the gap is on the device side — enabling authentication there is the fix.
Cause 2 — Authentication is enabled and IDs are in the log, but not in reports
If your firewall/proxy authentication is already on and you can see usernames in the raw log/syslog, but those usernames still aren’t showing up in Cyfin reports, the issue is on the parsing side: the log/syslog format or fields may have changed, so Cyfin’s parser no longer maps the User ID field correctly.
The fix: contact Wavecrest Technical Support (support@wavecrest.net). Let them know authentication is enabled and usernames are present in the raw log but not appearing in reports. The log fields may have changed and Cyfin’s parser / data configuration may need to be updated to read the User ID from the current log format.
Quick summary
Reports show IPs/blank, and the raw log has no username → enable authentication on your firewall/proxy (Cause 1). The User ID is never a default log field.
Reports show IPs/blank, but the raw log does have usernames → contact Wavecrest Support; the parser may need updating (Cause 2).
Reports show usernames but they’re all under Ungrouped IDs → that’s a grouping issue, not a capture issue; build or sync your Groups and IDs tree (see the Terms Glossary).
Applies to: Cyfin and CyBlock · Plain-language definitions of the terms used across the products and their reports.
This glossary defines the terms customers most often ask about — the reporting metrics, the categorization concepts, and the product features that shape what you see. Unless noted, a term applies to both Cyfin and CyBlock. For the full report list, see the Report Glossary; for the full category list, see the Category Glossary.
Reporting metrics
Session — A period of continuous user activity with a single application/site, reconstructed from the log. Sessions rebuild scattered proxy/firewall connection records into readable browsing events and filter out non-human background traffic (OS updates, telemetry, ad trackers), so a report reflects what a person actually did rather than raw log volume. Session count is the primary metric in high-level reports.
Session Duration — The elapsed time from the first to the last record within a session, shown as HH:MM:SS — meaningful active time, not raw connection time. Available only in the session reports. It replaces the retired Time Online metric.
Session Thresholds — The conditions activity must meet to be recorded as a session (for example, a minimum duration, a minimum number of hits, an inactivity timeout, and a maximum duration). These are Wavecrest-managed settings and should not be changed without Wavecrest’s assistance — please contact Technical Support before adjusting them.
Sessions % — A given application/site’s or category’s share of all sessions, shown as a number and a classification-colored bar.
Session Duration % — A given application/site’s or category’s share of total reporting-period time. A site with few sessions can still show a high duration % if those sessions were long.
Hit — A single log record. One page load generates many hits (images, scripts, stylesheets, and background requests). Hits are the raw material sessions are built from and appear at the deepest drill-down level, not as a headline metric. In the hit-based reports (everything outside the session reports), activity is measured in hits and bytes.
Bytes — The volume of data transferred, shown in KB or MB.
Denied Request — A request blocked by your proxy or firewall before it reached its destination. A non-zero count means access to blocked content was attempted during the period or session.
What happened to Visits and Time Online?
Both metrics have been retired. Visits have been upgraded to Sessions, which capture a user’s continuous engagement with a site rather than a single-interaction count — a clearer, more accurate picture in today’s dynamic web. Time Online has been replaced by Session Duration, which is available in the session reports. The hit-based reports now measure activity by Hits and Bytes and no longer show Visits or Time Online. This reflects how the web changed, not a correction of past reporting.
Categorization terms
Category — The content category assigned to a website (e.g., Video Streaming, Gambling, News), drawn from the shared Wavecrest URL List. See the Category Glossary for the full list and definitions.
Classification — A label — Acceptable, Unacceptable, or Neutral — that a customer assigns to each category to reflect their company policy. It appears in reports (color-coded: green / orange / gray) to give the report consumer a policy-based read on activity. Classification affects reporting only; it does not by itself block anything.
Custom Category — A category you create yourself (beyond the 70+ standard categories) and populate with URLs of your choosing — for example, to track intranet sites or to group a set of sites for filtering. Custom category and URL changes override future Wavecrest URL List downloads.
OtherWise — An optional program Cyfin and CyBlock customers can opt into to help improve categorization. When enabled, domains that are missing a category or tag are forwarded to Wavecrest’s cloud list server for review and analysis. Only the domain that needs review is sent — no other information — and the result is better list quality for everyone.
Acceptable Use Policy (AUP) — Your organization’s own policy defining acceptable web use. Cyfin and CyBlock help you monitor and enforce your AUP through their customization features (categories, classifications, and — in CyBlock — filtering).
Users and groups
User ID — The network login identifier used to attribute activity to an individual across all reports (e.g., firstname.lastname). Cyfin reads IDs from the log; CyBlock obtains an ID via NTLM when creating a proxy connection.
Groups and IDs — The tree of users and groups the product uses to organize activity. You can build it manually or sync it from Active Directory (importing your existing group and ID structure). Reporting and policies can then be organized by group.
Ungrouped IDs — Where an ID lands when it isn’t matched to an entry in your Groups and IDs tree. When Cyfin reads an ID from the log — or CyBlock receives one via NTLM — that ID is checked against the tree; if it doesn’t match a defined ID, it’s placed in Ungrouped IDs. If you never build a tree or sync from Active Directory, all IDs go into Ungrouped IDs by default. (If you’re running a report and can’t find the IDs you expect, this is often why — they’re sitting in Ungrouped IDs because the tree hasn’t been built or synced.)
Product features
Coaching(CyBlock only) — A filtering option that, when enabled, adds an override link to the block message shown when an employee reaches a blocked site. The employee can choose to bypass the block and continue to the site — and that action is logged, so the organization can later verify whether the visit was legitimate. Customers use coaching as a safety valve in case a valid site is blocked and a user genuinely needs access.
Ingestion — The process of loading raw proxy/firewall log data into the product for a given user and period. Reporting begins after ingestion completes. By default, known non-human domains (ad trackers, telemetry, OS updates, endpoint security) are excluded during ingestion; this can be disabled if a full traffic record is needed.
Application / Web Site (App/Site) — A recognized web service that groups all its related domains under one friendly name (e.g., fbcdn.com rolls up under “Facebook”), keeping reports readable for non-technical reviewers.
How to Whitelist (Allow) a URL in CyBlock
Applies to: CyBlock · Allowing specific sites through your web-filtering policy.
If CyBlock is blocking a site you want to permit — or you want to allow a set of sites regardless of their category — there are two ways to whitelist (allow) URLs. Pick based on how many sites you’re allowing and whether you want them grouped:
Method 1 — White List exception in your policy. Fastest for a few specific sites within a category you’re otherwise blocking (e.g., block Search Engines but allow Google).
Method 2 — Custom category set to allow. Best when you have many sites to allow, they span different categories, or you want them grouped and tracked as their own category.
(This is about allowing sites through the web filter — “whitelist,” “allow,” “unblock,” “stop blocking.” It is not related to certificates or SSL inspection.)
Method 1 — Add a White List exception to your blocking policy
Use this to allow specific sites while still blocking the rest of their category.
Go to Web Management → Filter → Categories. The Control Web Categories page is displayed.
Make sure the category you want the exception in is blocked as intended (the white list carves an exception out of a blocked category).
Under the White List/Black List section, in the Allowed URLs box, type the URL you want to allow — for example, *.google.com.
To add multiple URLs, type the first and press ENTER, then type the next and press ENTER, repeating until all are entered.
Click Submit to apply.
How it behaves: an entry in Allowed URLs is permitted even though its category is blocked. For example, if you’ve blocked the Search Engines category but want Google, entering *.google.com in Allowed URLs allows Google while everything else in Search Engines stays blocked. The *. wildcard covers the domain and its subdomains.
Notes:
If a URL exists in both Allowed URLs and Blocked URLs, the blocked entry wins after you click Submit.
The Blocked URLs box is the reverse (a black list) — block specific sites while allowing the rest of their category.
Method 2 — Create a custom category and set it to allow
Use this to maintain a reusable group of allowed sites — handy when you’re allowing many domains or ones that span several categories.
Step A — Create the custom category and add your URLs
Go to Categorization → Customize → URLs. The Edit URLs page is displayed.
For Category Type, leave Custom selected (the default for creating a custom category).
Name the category:
If you have no custom categories yet, type the name in the Add Category field (max 50 characters) — for example, Approved Sites.
If custom categories already exist, use the Select Category field and choose Create Custom Category, then enter the name in Add Category.
In the Custom URLs box, type each domain you want to allow. To add multiple, type one and press ENTER, then the next and ENTER, and so on. Wildcards are supported (for example, *.example.com).
Click Submit.
Step B — Make sure your policy allows that category
Go to Web Management → Filter → Categories (the Control Web Categories page).
Confirm your new custom category is set to allow (not blocked) in the policy. Because it’s a category like any other, CyBlock filters it according to the policy — so leaving it unblocked allows every URL you added to it.
Notes:
Your custom category and URL changes override future Wavecrest URL List downloads, so your allowed sites persist through updates.
Adding a URL that already exists in another category moves it — it’s removed from the other category and placed in this one.
If you use SSL Inspection, custom categories are inspected by default.
Setting a category to allow (a filtering/policy action) is separate from a category’s classification — Acceptable / Unacceptable / Neutral — which only affects how activity is color-coded in reports, not whether it’s blocked.
Which method should I use?
A few specific sites within a category you’re blocking → Method 1 (White List). Quick and self-contained.
Many sites, sites across different categories, or a reusable “approved” list you’ll maintain over time → Method 2 (custom category set to allow). More scalable and reportable.
Verify it worked
Use Categorization → Check URL to confirm a URL resolves to the category/handling you expect — useful after Method 2 to verify your URLs landed in the custom category.