Sokol Documentation

Sokol is an analytics and security platform from KSoft.TECH. These docs walk you through integrating the tracking script, the CAPTCHA widget, and configuring the protections that sit behind both.

Quick start

  1. Create a site in the console and copy your Site ID.
  2. Add the tracking script to every page you want to protect (see Tracking Script).
  3. Optional: drop a <sokol-captcha> tag into any form (see CAPTCHA Widget).
  4. Configure Allowed Origins so only your domains can request challenges.

What's in these docs

  • Tracking Script — the unified sokol.iife.js bundle, what it collects, attributes, and CDN URL.
  • CAPTCHA Widget — the <sokol-captcha> custom element, modes and verification flow.
  • Smart Mode — how dynamic difficulty is computed from threat indicators.
  • Allowed Origins — locking challenge endpoints to your own domains.
All Sokol scripts are served from the CDN at https://sokol-static.my-k.cloud/v1. Never self-host them — updates and security patches ship through that endpoint.