Guest accounts
The Guest accounts page manages the accounts of visitors, contractors and event guests: the [Guest User Repository]. Operators create accounts one at a time, in bulk or from a CSV file, and self-registration portals add accounts here too. The page also holds the delivery log of receipts and the tenant-wide guest defaults.
What this page shows
Section titled “What this page shows”Guests › Guest accounts has three tabs:
- Accounts: the list of guest accounts, with a count of all accounts on the tab.
- Delivery log: every receipt and notice sent by e-mail, SMS or Microsoft Teams.
- Defaults: the defaults for accounts created in the console, and the Microsoft Teams settings for sponsors.
Accounts tab
Section titled “Accounts tab”The toolbar filters the list:
| Filter | Meaning |
|---|---|
| Name, user, e-mail, company, phone, sponsor… | Free-text search. |
| All sources | Operator, Bulk, Self-registration or Accept terms. |
| All portals | Accounts linked to one guest portal. |
| All roles | Accounts with one role. |
| Sponsor e-mail (exact) | Accounts whose sponsor e-mail matches exactly. |
| Sponsored by me | Fills the sponsor filter with your own e-mail address. Shown when your console account has an e-mail. |
| Clear filters | Resets all filters. |
The account count and the page size (25, 50, 100 or 200 / page, default 50) are on the right. Select a column header with a sort arrow to sort by it. Select a row to open the Guest account panel.
Guest account panel
Section titled “Guest account panel”The panel shows the user name, visitor details, status and a live expiry countdown. It has two tabs:
- Details: Visitor (name, e-mail, phone, company, sponsor), Access (role, state, credentials, activation and expiry times, what happens on expiry, simultaneous use, device MAC), Activity (first and last login, source, portal, created, updated, expired at), custom fields and notes. The device MAC links to the endpoint in Devices.
- Receipts: the receipts and notifications sent to this guest (when, kind, channel, recipient, status).
Delivery log tab
Section titled “Delivery log tab”Lists every receipt, sponsor request, approval notice and Teams sponsor notice sent. Message bodies, which may hold credentials, are never stored. Rows are kept for 180 days. Filter by Username, recipient or error…, by status (All, Sent, Failed, Skipped) and by channel (All channels, E-mail, SMS, Teams). Select a user name to open that guest’s panel.
E-mail and SMS delivery are configured under Tenant Settings.
Defaults tab
Section titled “Defaults tab”Defaults for accounts created in this console (single and bulk) and for accounts without a portal. Portals carry their own settings. The tab also holds the Microsoft Teams card for sponsor delivery.
Fields and columns
Section titled “Fields and columns”Account list
Section titled “Account list”| Column | Meaning |
|---|---|
| Username | The login name. A no password badge marks password-less accounts. Name and company (or e-mail) appear below. |
| Status | Active, Scheduled (activation time in the future), Pending, Disabled or Expired. Flips live when the expiry or activation time passes. |
| Role | The role the account gets in policy. |
| Expires | A live countdown (red under 1 hour, amber under 24 hours) and the expiry date, or No expiry. |
| Sponsor | Sponsor name and e-mail. |
| Source | How the account was created (Operator, Bulk, Self-registration, Accept terms) and the portal, if any. |
| Last login | Time since the last login, or Never. |
| Created | Time since creation; hover for the date and creator. |
Create guest account and edit form
Section titled “Create guest account and edit form”| Field | Meaning |
|---|---|
| Visitor name, Company | Visitor details. |
| Must be a valid address when set. | |
| Mobile phone | For SMS receipts, for example +1 555 010 0000. |
| Sponsor name, Sponsor e-mail | The host who sponsors the guest. |
| Username | Leave empty to use the e-mail address, or a generated name. A MAC address cannot be a user name; the name must not contain %{. Renaming updates the guest’s cached endpoints. |
| Password | Generate (shown once) (create only), Set a password… (4 to 72 characters), No password (web-login / MAC caching only). When editing: Keep current password or Keep password-less. |
| Role | The role for the account. Empty uses Tenant default ([Guest]). When you change the role of an active account, Airgate re-authorizes its cached devices with a CoA. |
| Account state | Active, Pending approval or Disabled. Pending and disabled accounts cannot log in. An expired account shows Expired; use Extend to re-activate it. |
| Account expires / Change expiry | Tenant default (or Keep current), 1 hour, 4 hours, 8 hours, 1 day, 3 days, 1 week, 30 days, Pick date… or Never. The form previews the resulting expiry in your local time. |
| Activates at | Optional. The account cannot log in before this time. |
| When the account expires | Stop authenticating (0), Disable (1), Disable and logout (2), Delete (3) or Delete and logout (4). On create, empty uses the tenant default. The logout variants send a CoA Disconnect to active sessions. |
| Expire after first login | Minutes after the first login, 0 = off. Up to 5,256,000. |
| Simultaneous sessions | 0 = unlimited. Up to 1000. |
| Portal (receipt templates) | Links the account to a portal, whose receipt templates are then used. None uses the tenant default templates. |
| Send receipt to the guest | Create only. E-mail and/or SMS. E-mail needs an e-mail address, SMS needs a phone number. |
| Device MAC | Under Device, custom fields & notes. The guest’s registered device, for example aa:bb:cc:dd:ee:ff. Also learnt at first login. |
| Custom fields | Name and value pairs, at most 64. Exposed to policy as GuestUser:<name> and usable in receipt templates. |
| Notes | Free text. |
Create multiple guest accounts
Section titled “Create multiple guest accounts”User names and passwords are generated, and the credentials are shown once after creation.
| Field | Meaning |
|---|---|
| Number of accounts | Required. 1 to 500. Default 10. |
| Username prefix | Up to 16 letters, digits, ., _ or -. Empty uses the tenant default. |
| Username length | 4 to 32. Default 7. |
| Password format | Digits (0-9), Letters or Letters and digits. |
| Password length | 4 to 64. Default 8. |
| Simultaneous sessions | 0 = unlimited. |
| Company / event | Applied to every account, for example Partner Summit. |
| Role, Sponsor name, Sponsor e-mail | Applied to every account. |
| Accounts expire | As for a single account. Default 1 day. |
| When the accounts expire | As for a single account. |
| Portal (receipt templates) | As for a single account. |
| Custom fields, Notes | Applied to every account, for example event = Expo. |
Import guest accounts
Section titled “Import guest accounts”| Field | Meaning |
|---|---|
| CSV file | Required. A CSV file with a header row, comma, semicolon or tab separated, UTF-8. 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. Up to 1,000 accounts per file. |
| Default role | For rows without a role. |
| Default lifetime | Hours, 1 to 87,600, for rows without expire_time or expire_after. Empty uses the tenant default. |
| When the accounts expire | For rows without expire_action. |
| Portal (receipt templates) | Links the imported accounts to a portal. |
Missing user names and passwords are generated and shown once after the import. Existing user names are skipped, never updated.
Extend dialog
Section titled “Extend dialog”| Field | Meaning |
|---|---|
| Extend by | +1 hour, +4 hours, +8 hours, +1 day (default), +3 days, +1 week, +30 days, Custom… (minutes, hours or days) or Set exact time…. Each account is extended from the later of now and its current expiry. Expired accounts are re-activated. |
Send receipt dialog
Section titled “Send receipt dialog”| Field | Meaning |
|---|---|
| Channels | E-mail and/or SMS. Each selected channel needs a recipient. |
| Send e-mail to, Send SMS to | Leave empty to use the guest’s own address or number. |
| Include the password in the receipt | Off for password-less accounts. |
The receipt uses the templates of the guest’s portal, else the tenant defaults.
Reset password dialog
Section titled “Reset password dialog”Generate a new password or Set a password (4 to 72 characters). Outstanding web-login one-time passwords are revoked. A password-less account stops being password-less.
Credentials dialog
Section titled “Credentials dialog”After you create an account with a generated password, create multiple accounts, import accounts with generated passwords or reset a password, Airgate shows the credentials once. Print receipts opens a printable sheet (allow pop-ups for the console), Download CSV saves user names and passwords, and Copy list copies them (several accounts). Closing without saving asks for confirmation; afterwards you can only re-send a receipt or reset the password.
Defaults tab
Section titled “Defaults tab”| Field | Meaning |
|---|---|
| Username prefix, Username length | Generated credentials. Prefix up to 16 characters; length 4 to 32. |
| Password format, Password length | Generated credentials. Length 4 to 64. |
| Default lifetime, Lifetime (minutes) | Account lifetime: No expiry or a preset from 1 hour to 30 days, or minutes (0 to 5,256,000). |
| When an account expires | Default expiry action. Default Delete and logout (4). |
| Keep expired accounts (days) | 0 to 36,500; 0 = 90 days. |
| When a device’s MAC cache lapses while it is online | Reauthenticate (default): the network device re-runs MAC authentication and redirects the device to the portal. Disconnect: send a CoA Disconnect. Do nothing: the session runs until the network device re-authenticates. |
| Receipts for accounts without a portal | E-mail receipt (subject and body) and SMS receipt (message), each with a Send on approval toggle. Templates use placeholders such as {{username}}, {{password}}, {{name}} and {{expire_time}}. SMS needs an SMS gateway in Tenant Settings. |
| Sponsor request e-mail | Subject and body of the e-mail sent to a sponsor. Placeholders include {{review_url}}, {{approve_url}}, {{deny_url}} and {{approval_expires}}. Opening a link never decides: the sponsor confirms with a button on the page. |
Microsoft Teams card (Defaults tab)
Section titled “Microsoft Teams card (Defaults tab)”Self-registration portals with sponsors send the visitor’s password to the chosen sponsor as a Teams chat message instead of showing it to the visitor.
| Field | Meaning |
|---|---|
| Teams delivery enabled / disabled | Turns Teams delivery on or off. |
| Workflow URL | Required while Teams delivery is enabled. The https:// HTTP POST URL of a Power Automate trigger. Stored encrypted. |
| Send a test card | The e-mail address (UPN) of a Teams user, for example alice@contoso.com. The test uses the saved settings. |
The card’s setup notes describe the flow: trigger When a Teams webhook request is received, action Post card in a chat or channel as Flow bot to the sponsor_email of the request.
Actions
Section titled “Actions”| Action | Where | What it does |
|---|---|---|
| Refresh | Page header | Reloads the list. |
| Export | Page header | Downloads the filtered list as CSV (up to 20,000 accounts). Passwords are never exported. |
| Import CSV | Page header | Opens Import guest accounts. Check file runs a dry run and lists the rows that would be skipped or are invalid; Import creates the accounts. |
| Create multiple | Page header | Opens Create multiple guest accounts. |
| Create account | Page header | Opens Create guest account. |
| Extend | Row, panel, bulk bar | Opens the Extend dialog. |
| Send receipt | Row, panel | Opens Send receipt. Disabled when the guest has no e-mail or phone. |
| Disable / Enable | Row, panel, bulk bar | Sets the account state. Enable is offered for disabled accounts; an expired account must be extended first. |
| Edit | Row, panel | Opens the edit form. |
| Delete | Row, panel, bulk bar | Deletes the accounts and their registered devices and revokes cached MAC authorizations. Optionally, Also disconnect the guest’s devices that are online now (CoA Disconnect). This cannot be undone. |
| Reset password | Panel | Opens Reset password. |
| Send receipts | Bulk bar | Sends each selected guest a receipt to their own address. Guests without an e-mail or phone are skipped; delivery problems are listed in the Delivery log. |
| Export | Bulk bar | Downloads the selected rows as CSV. |
| Clear | Bulk bar | Clears the selection. |
| Discard, Save defaults | Defaults tab | Discards or saves the guest defaults. |
| Discard, Save, Send test | Microsoft Teams card | Discards or saves the Teams settings, or sends a test card to the address you enter. |
Bulk actions apply to the rows selected on the current page.
Permissions
Section titled “Permissions”- View:
guest:read: Tenant Administrator, Network Administrator, Help Desk, Guest Operator, Read-only Administrator and Platform Administrator. - Change:
guest:write: Tenant Administrator, Network Administrator, Help Desk, Guest Operator and Platform Administrator. Without it, the create, import, bulk and row actions are hidden and the Defaults tab is read-only.
The Role pickers list the tenant’s roles when you also hold identity:read; otherwise they list the roles from the guest settings and accept a typed role name.