Se rendre au contenu
  •  +49 (861) 88 00 32 00
COD powered by extocode GmbH
  • 0
  • Se connecter
  • English (US) Français Deutsch Español Türkçe
  • Ouvrir la démo
  • Accueil
  • Aperçu COD
    Plateforme
    AperçuPlateforme : mandants et marqueFonctionnalitésProblèmes & solutionsArchitectureDocumentationIntégrationsTarifs
    Exploitation & Réseau
    MonitoringRéseauNetwork Access Control (NAC)TACACS+Captive PortalFirewall
    Sécurité & Résilience
    Governance, Risk & ComplianceBackupHypervisorOTPPasskeeprAutomatisation
    Solutions & Plus
    NIS2 & CompliancecodPassDocumentation par IA (module InfraScan)Ouvrir la démoRéférencesTéléchargementsFAQ
  • Tarifs
  • Actualités
    • Blog
    • Feuille de route
  • FAQ
  • À propos
    • À propos
    • Carrières
    • Partenaires
    • Références
  • Academy
  • Contact
COD powered by extocode GmbH
  • 0
    • Accueil
    • Aperçu COD
    • Tarifs
    • Actualités
      • Blog
      • Feuille de route
    • FAQ
    • À propos
      • À propos
      • Carrières
      • Partenaires
      • Références
    • Academy
    • Contact
  •  +49 (861) 88 00 32 00
  • English (US) Français Deutsch Español Türkçe
  • Se connecter
  • Ouvrir la démo
  1. Home
  2. Documentation
  3. Modules
  4. Captive Portal

Captive Portal

This page describes how COD creates guest vouchers for the captive portal of an OPNsense firewall, what you need to set up and where the limits are.

What the module does is described on the module page.

As of: November 2026, COD 3.8.6

Documentation contents
  • Overview
  • Getting started
  • Requirements
  • Names and addresses
  • Network devices
  • Time and DNS
  • Installation
  • Deployment shapes
  • Initial setup
  • Updates
  • Modules
  • Network and MikroTik
  • Automation
  • NAC
  • TACACS+
  • Firewall
  • Captive Portal
  • Monitoring
  • Backup
  • Hypervisor
  • OTP
  • Passkeepr
  • GRC
  • Inventory and CMDB import
  • Troubleshooting
  • Security
  • Versions
  • Version history
  • Support

Documentation

  • Overview
  • Getting started
  • Requirements
  • Names and addresses
  • Network devices
  • Time and DNS
  • Installation
  • Deployment shapes
  • Initial setup
  • Updates
  • Modules
  • Network and MikroTik
  • Automation
  • NAC
  • TACACS+
  • Firewall
  • Captive Portal
  • Monitoring
  • Backup
  • Hypervisor
  • OTP
  • Passkeepr
  • GRC
  • Inventory and CMDB import
  • Troubleshooting
  • Security
  • Versions
  • Version history
  • Support

Overview

ItemValue
PurposeCreate, hand out and invalidate guest vouchers for the firewall’s captive portal
FirewallOPNsense only
Connection and directionCOD server to the firewall through its API. The firewall is connected in the Firewall module
VouchersValidity period, expiry time, group label. Many vouchers in one step
OutputQR code for guest login, QR code for joining the Wi-Fi, PDF individually or in bulk
RightsRead, create, change and delete can be granted separately
StorageVoucher passwords encrypted in COD’s database
Firewall rulesCustomers and partners receive the list of connections and firewall rules as part of the project.

Requirements

RequirementWhere
OPNsense connected in the Firewall module, with asset type “Firewall” and API accessCOD
Captive portal with a zone set up on the OPNsenseFirewall
Guest Wi-Fi with SSID and PSKWi-Fi
Voucher configuration on the firewall asset with zone, SSID, PSK, gateway and redirectCOD
Captive Portal module enabled for the tenant, roles for handing out vouchersCOD

Setup

  1. Connect the OPNsense in the Firewall module. See Firewall.
  2. Set up the captive portal with a zone on the OPNsense.
  3. In COD, create the voucher configuration on the firewall asset. Fill in zone, SSID, PSK, gateway and redirect completely.
  4. Create a role for the people who hand out vouchers, for example reception. Grant only the rights needed, usually read and create.
  5. Create vouchers: number, validity period, expiry time and group label.
  6. Hand out the vouchers as QR code or PDF.

The voucher configuration then appears on the firewall asset in the “References” tab.

Technical details

ItemValue
ExpiryEach voucher expires on the firewall by itself after its expiry time
Invalidate at once“Expire” for single vouchers, “Drop Expired” for expired ones
Clean-upA nightly run cleans up COD’s database
QR codesone for guest login, one for joining the Wi-Fi via SSID
DelegationRights for read, create, change and delete separated. The person handing out vouchers needs no access to the firewall
SearchVouchers are among the sources of the global search. The result opens the record

Known limits

LimitWhat you can do
OPNsense onlyFor other firewalls use their own guest management
The voucher configuration needs zone, SSID, PSK, gateway and redirectFill in all values before you create vouchers
Rights apply per location, not per firewallAnyone allowed to create vouchers can do so for all firewalls of the location. Split locations accordingly

Further reading

  • Captive Portal module page
  • Connecting a firewall
  • What your network needs for Firewall and Captive Portal
  • Troubleshooting
  • Questions about the modules
  • Support: your partner is your first point of contact. Technical questions to extocode go through the helpdesk form.
← Previous: FirewallNext: Monitoring →
Folgen Sie uns
​
  • Aperçu COD
  • Fonctionnalités
  • Demo
  • Tarifs
  • Intégrations
  • NIS2
  • codPass
  • Références

Help

  • FAQ
  • Documentation
  • Téléchargements
  • Contact

Kotzinger Straße 21 • 83278 Traunstein • Deutschland

  • ​+49 (861) 88 00 32 00
  • ​info@extocode.com
Datenschutz Impressum ​
Copyright © extocode GmbH
English (US) Français Deutsch Español Türkçe

Nous utilisons des cookies pour vous offrir une meilleure expérience utilisateur sur ce site. Politique de confidentialité

Refuser Accepter