Skip to content

Create and manage guest accounts

Guest accounts are user names and passwords for visitors, contractors and event attendees. Guests use them on a guest portal of type Guest login, or directly on an SSID that accepts PEAP or PAP against the [Guest User Repository]. This guide covers creating accounts (single, batch, CSV import), the tenant defaults, and day-to-day management.

  • An administrator role with guest:write: Tenant Administrator, Network Administrator, Help Desk or Guest Operator (the receptionist role, which can only manage guests).
  • A way for guests to use the accounts: a guest portal, or an access policy for the guest SSID that checks accounts in [Guest User Repository] (the Guests policy template in Access › Access policies).
  • Optional: e-mail and SMS delivery to send credentials to guests.

Open Guests › Guest accounts and select the Defaults tab. These values apply to accounts created in the console (single and bulk) and to accounts without a portal. Portals carry their own settings.

Card Field Default
Generated credentials Username prefix (up to 16 letters, digits, ., _, -) g
Username length (4 to 32) 7
Password format (Digits (0-9), Letters, Letters and digits) and Password length (4 to 64) Digits, 8
Account lifetime Default lifetime none set: accounts get no expiry unless you choose one
When an account expires Delete and logout (4)
Keep expired accounts (days) (0 = 90) 90
When a device’s MAC cache lapses while it is online Reauthenticate (default)
Receipts for accounts without a portal E-mail and SMS templates, Send on approval see receipts

Select Save defaults. The Microsoft Teams card on the same tab configures sponsor delivery.

The expire actions:

Action What happens at expiry
Stop authenticating (0) The account is kept but can no longer log in.
Disable (1) State becomes expired; the account is kept.
Disable and logout (2) Disable, plus a CoA Disconnect of the guest’s active sessions.
Delete (3) The account is deleted.
Delete and logout (4) Delete, plus a CoA Disconnect of the guest’s active sessions.

Airgate checks expiry every 30 seconds. In every case the guest’s MAC caches are revoked, so devices released by a portal lose access at their next authentication.

  1. On Guests › Guest accounts, select Create account.
  2. Visitor details: Visitor name, Company, E-mail, Mobile phone, Sponsor name, Sponsor e-mail.
  3. Credentials:
    • Username: leave empty to use the e-mail address, or a generated name (prefix and length from the defaults).
    • Password: Generate (shown once), Set a password… (at least 4 characters) or No password (web-login / MAC caching only).
  4. Access:
    • Role: empty uses the tenant default ([Guest]).
    • Account state: Active, Pending approval or Disabled.
    • Account expires: a preset, a date, or Tenant default.
    • Activates at (optional): the account cannot log in before this time.
    • When the account expires: an expire action or Tenant default.
    • Expire after first login: minutes after the first login (0 = off). The account then expires at that time or its normal expiry, whichever comes first.
    • Simultaneous sessions: 0 = unlimited.
    • Portal (receipt templates): which portal’s receipt templates to use.
    • Send receipt to the guest: E-mail and/or SMS.
  5. Optional, under Device, custom fields & notes: Device MAC (the guest’s device; also learnt at first login), Custom fields (available in policy as GuestUser:<name> and in receipt templates) and Notes.
  6. Select Create account.

The Guest credentials window shows the user name and password. Passwords are shown only once: use Print receipts, Download CSV or the copy button now. Afterwards a password can only be re-sent (if Airgate still has it) or reset.

For an event or a training class:

  1. Select Create multiple.
  2. Set Number of accounts (1 to 500), Username prefix, Username length, Password format, Password length and Simultaneous sessions.
  3. Optionally fill in Company / event, Role, Sponsor name, Sponsor e-mail, Accounts expire, When the accounts expire, Portal (receipt templates), Custom fields (applied to every account, for example event = Expo) and Notes.
  4. Select Create N accounts, then print or download the credentials.
  1. Select Import CSV.

  2. Choose the CSV file: UTF-8, comma, semicolon or tab separated, with a header row, at most 1,000 accounts and 5 MiB. Recognised columns:

    username, password, name, email, phone, company, sponsor_name, sponsor_email,
    role, start_time, expire_time, expire_after, expire_action, notes, mac

    Other columns become custom fields. expire_after is a number of hours (up to 87,600). Missing user names and passwords are generated.

  3. Set Default role, Default lifetime (hours, for rows without expire_time or expire_after), When the accounts expire and Portal (receipt templates).

  4. Select Check file. Airgate lists new accounts, rows that already exist (existing user names are skipped, never updated) and invalid rows with the reason.

  5. Select Import N accounts. Generated passwords are shown once.

Example file:

name,email,company,sponsor_email,expire_after
Ann Visitor,ann@fabrikam.com,Fabrikam,jane.host@contoso.com,8
Ben Auditor,ben@northwind.com,Northwind,jane.host@contoso.com,40

The accounts list has tiles (All accounts, Active, Scheduled, Expiring < 24h, Pending approval, Disabled, Expired) and filters for source, portal, role and Sponsor e-mail (exact). Sponsored by me shows the accounts whose sponsor is you.

Row actions:

Action What it does
Extend Adds time (+1 hour to +30 days, Custom…) or sets an exact expiry (Set exact time…). Expired accounts are re-activated.
Send receipt Re-sends the credentials by e-mail and/or SMS.
Disable / Enable Disabling revokes the guest’s MAC caches. An expired account must be extended before it can be enabled.
Edit Changes details, role, state or expiry. Renaming or a role change updates the guest’s cached devices; a role change also re-authenticates them.
Delete Deletes the account and revokes its device access.

Select several rows for the bulk actions Extend, Enable, Disable, Send receipts, Export (CSV) and Delete (up to 500 at a time).

  • The account appears with status Active (or Scheduled if Activates at is in the future).
  • Access › Test access with A person signing in, the guest’s user name and password: the result shows the matching policy and rule.
  • Monitor › Sign-in log: the guest’s sign-ins, with Account from [Guest User Repository].
Symptom Cause Fix
Sign-in log: No account named “…” The user name is wrong, or the policy does not check [Guest User Repository]. Check the spelling; add [Guest User Repository] to the policy’s Check accounts in.
Sign-in log: Wrong password Wrong password, or an old one saved on the device. Open the account and select Reset password; forget the network on the device.
Sign-in log: The account has expired The expiry or Expire after first login time has passed. Extend the account.
Sign-in log: The account is disabled The account is disabled, or Activates at is still in the future. Enable the account or wait for the start time.
Sign-in log: The device used a sign-in method this network doesn’t allow PEAP on a guest network whose policy only allows PAP, or the reverse. Allow the method in the access policy.
Import: the CSV file must be UTF-8 The file was saved in another encoding. Save as “CSV UTF-8”.
Import: at most 1000 accounts per import The file has more rows. Split the file.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security