Skip to content

Front-desk Wi-Fi passes with QR codes

Reception gives each visitor a Wi-Fi pass: a passphrase for the guest SSID and a QR code their phone camera can scan to join, valid for a set number of hours. When the pass ends or is revoked, its passphrase stops working. No captive portal and no guest accounts are needed.

The guest SSID is WPA2-Personal with MAC authentication against RADIUS. The access point asks Airgate about every device before the WPA2 handshake. Airgate accepts the request and sends back the passphrases that are valid now, one Tunnel-Password attribute each, plus Session-Timeout 3600. The access point lets the device in if it holds one of those passphrases. Because devices re-authenticate every hour, a revoked or expired pass stops working within an hour.

Two password modes:

Mode Behaviour
Passphrase per guest Every pass gets its own random passphrase. Airgate sends the passphrases of the newest active passes, up to Passwords sent to the access point. Best for traceability.
Shared, changes daily Everyone uses one passphrase, derived from a tenant secret for each UTC day. It changes at midnight UTC. Passes are still recorded. Simplest for a lobby sign.

Passphrases use lower-case letters and digits without look-alike characters (no 0/o, 1/l/i), so they are easy to type from a card.

  • Access points or controllers that accept the WPA passphrase from RADIUS in the Tunnel-Password attribute. Vendors call this MPSK, PPSK, iPSK or DPSK “with RADIUS”. Check that your platform accepts several Tunnel-Password values in one Access-Accept, and how many.
  • The access points or controller added under Network › Switches and APs with a RADIUS shared secret.
  • An administrator role with guest:write. Saving the settings also creates a policy, which needs policy:write.

Step 1: Create the guest SSID on the access points

Section titled “Step 1: Create the guest SSID on the access points”
  1. Create an SSID, for example Corp-Guest, with WPA2-Personal and MAC authentication against RADIUS (the per-user passphrase from RADIUS option).
  2. Point it at Airgate as RADIUS server: your Airgate RADIUS address, UDP 1812, and the shared secret from Switches and APs.
  3. Make sure the access point sends the SSID in the request (in Called-Station-Id or a vendor attribute). Airgate only hands out passphrases on the configured SSID.
  1. Open Guests › Wi-Fi passes and select Set up (or Settings).

  2. Fill in Wi-Fi pass settings:

    Field Value
    Guest SSID Corp-Guest, exactly as broadcast (case-sensitive, up to 32 bytes). Empty turns Wi-Fi passes off.
    Guest VLAN Optional. Guests are put in this VLAN; empty keeps the SSID’s own VLAN.
    Passwords Passphrase per guest or Shared, changes daily
    Default validity (hours) 1 to 720 (default 24)
    Password length 8 to 63 characters (default 12)
    Passwords sent to the access point 1 to 100 (default 20): the newest active passes. Stay within your access point’s limit.
    Devices per pass 1 to 20 (default 3). Printed on the card; a passphrase cannot count devices, so this is not enforced.
  3. Select Save.

Airgate then creates or updates the policy for this SSID: a directory Guest Wi-Fi passes, an enforcement profile and a RADIUS service named Guest Wi-Fi that matches MAC authentication requests for the SSID. It is checked before your access policies, and Access › Access policies lists it as “Set up elsewhere (for example guest Wi-Fi passes)”.

  1. On Guests › Wi-Fi passes, under Register a guest, enter the Guest name (required) and optionally E-mail, Phone and Company.
  2. Choose Valid for: 4 hours, 8 hours, 1 day, 3 days or 1 week.
  3. Select Issue pass.

The Guest pass card shows the network, the password, the validity and a QR code. Select Print to print the card, or let the visitor scan the QR code. The QR code uses the standard Wi-Fi format (WIFI:T:WPA;S:<ssid>;P:<passphrase>;;) that phone cameras join from.

In Shared, changes daily mode, the card shows the Passphrase of the day; a pass that runs past midnight UTC notes that the shared password changes daily.

  1. Select Print vouchers.
  2. Set Number of vouchers (1 to 200), Valid for (hours) (1 to 720, from now) and an optional Note printed on every voucher (for example the event name).
  3. Select Create N vouchers and print the sheet.

Vouchers are unnamed passes. In per-guest mode each voucher gets its own passphrase.

  • A pass stops working at its end time.
  • Revoke on a pass in the Passes list: the passphrase is no longer sent to the access points, and connected devices drop at their next re-authentication (within an hour).
  • Card on an active pass shows its card again for reprinting.
  • The Passes list shows the pass with status Active.
  • Monitor › Sign-in log: the guest device’s MAC authentication on Corp-Guest, handled by Guest Wi-Fi, result Accept. The trace says how many passphrases were sent.
Symptom Cause Fix
Guests cannot join; Sign-in log: reject whose reason contains SSID "…" is not the Wi-Fi pass SSID "…" The SSID in the settings differs from the broadcast SSID. Enter the exact SSID, including case and spaces.
Sign-in log: reject whose reason contains no active Wi-Fi pass No pass is valid at this moment (per-guest mode). Issue a pass, or check the validity of the existing ones.
Sign-in log: reject whose reason contains Wi-Fi passes are not configured (no guest SSID) Guest SSID is empty. Complete Wi-Fi pass settings.
Sign-in log shows nothing The access point does not send MAC authentication to Airgate, or it is not under Switches and APs. Check the SSID’s RADIUS settings and the network device’s address and secret.
Some passphrases work, others do not The access point accepts fewer passphrases than Airgate sends, and drops the rest. Lower Passwords sent to the access point.
A revoked guest stays online The device keeps its session until the next re-authentication. Wait up to an hour, or disconnect it from Monitor › Connected now.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security