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.
Before you begin
Section titled “Before you begin”- 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.
Step 1: Set the defaults
Section titled “Step 1: Set the defaults”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.
Step 2: Create one account
Section titled “Step 2: Create one account”- On Guests › Guest accounts, select Create account.
- Visitor details: Visitor name, Company, E-mail, Mobile phone, Sponsor name, Sponsor e-mail.
- 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).
- 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.
- Role: empty uses the tenant default (
- 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. - 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.
Step 3: Create many accounts
Section titled “Step 3: Create many accounts”Create multiple
Section titled “Create multiple”For an event or a training class:
- Select Create multiple.
- Set Number of accounts (1 to 500), Username prefix, Username length, Password format, Password length and Simultaneous sessions.
- 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. - Select Create N accounts, then print or download the credentials.
Import a CSV file
Section titled “Import a CSV file”-
Select Import CSV.
-
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, macOther columns become custom fields.
expire_afteris a number of hours (up to 87,600). Missing user names and passwords are generated. -
Set Default role, Default lifetime (hours, for rows without
expire_timeorexpire_after), When the accounts expire and Portal (receipt templates). -
Select Check file. Airgate lists new accounts, rows that already exist (existing user names are skipped, never updated) and invalid rows with the reason.
-
Select Import N accounts. Generated passwords are shown once.
Example file:
name,email,company,sponsor_email,expire_afterAnn Visitor,ann@fabrikam.com,Fabrikam,jane.host@contoso.com,8Ben Auditor,ben@northwind.com,Northwind,jane.host@contoso.com,40Step 4: Manage accounts
Section titled “Step 4: Manage accounts”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).
Verify
Section titled “Verify”- 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].
Troubleshooting
Section titled “Troubleshooting”| 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. |