Skip to content

Directories

The Directories page connects Airgate to the places where user accounts live: Active Directory, LDAP, Microsoft Entra ID, Google Workspace, Okta, SQL databases, REST APIs and RADIUS or token servers. After you add a directory, pick it under Access › Access policies › a policy › Check accounts in to use it.

Access › Directories lists your directories. By default it shows Your directories; switch the origin filter to see the built-in repositories that exist in every tenant (local users, endpoints, guest accounts, guest devices, time source and session history).

Select a row to open the Directory panel. It has these tabs:

  • Overview: type, enabled state, authorization settings, cache timeout, filter count, Enable as role aliases, creation and update times, and the connection settings grouped by section. Secrets show as Stored securely.
  • Filters & attributes: the queries Airgate runs against the directory and the attributes they map to policy aliases. The filter named Authentication is the user search.
  • Test user: looks a user up, or verifies a password, live. See Actions.
  • Domain join: Active Directory only, and only for Platform Administrators. Joins the Airgate server to the domain for PEAP-MSCHAPv2 without a site connector, with Realm (AD DNS domain), NetBIOS domain, Computer name, Domain controller, OU, Join account and Password. A joined server shows Test and Leave.
Column Meaning
Name The directory name and description. Badges mark Built-in and Disabled directories.
Type The directory type.
Server / target Where Airgate connects: ldaps://dc01.contoso.com:636, a database server, a base URL, a tenant ID, a RADIUS server or proxy target, or the MAC lists of a Static Host List source. +N backup counts backup servers.
Authorization Yes when the directory supplies authorization attributes, +N chained for additional authorization sources, and the number of enabled filters and attribute aliases.
Cache How long authorization attributes are cached per user, Off, or n/a for types that are never cached.
Status No driver when this deployment has no driver for the type, the result of the last connection test, or Disabled.

The Add directory picker groups the types by category. Each card shows what the type can do: Lookup (find a user without a password: authorization, MAC authentication, EAP-TLS), Verify (check a cleartext password: PAP, portal, TACACS+), MSCHAP/CHAP (return a hash so MS-CHAPv2 and CHAP work), Attributes and MAC auth.

Type What it is Connection fields
Active Directory LDAP(S) to domain controllers: search, user bind and memberOf group expansion. Supports backup servers. Hostname, Port (default 389; 636 for LDAP_SSL), Connection security (None, StartTLS, LDAP_SSL), Verify server certificate, Trusted CA (PEM), Bind DN and Bind password (both required), Base DN, Search scope, Verify passwords by user bind, Follow referrals, User certificate attribute, Max pooled connections, NetBIOS domain, Always use NetBIOS name, Expand nested groups.
Generic LDAP OpenLDAP, 389-DS or eDirectory. Supports backup servers. As Active Directory, with Bind DN optional and, instead of the NetBIOS and nested-group fields, Password attribute, Password type and Password header so MS-CHAP and CHAP can be verified.
Microsoft Entra ID Microsoft Graph for user attributes and groups; ROPC for password verification. Directory (tenant) ID, Application (client) ID, Credential type (secret or certificate), Client secret or Client certificate (PEM) and Client certificate key (PEM), Login endpoint, Graph endpoint, Verify passwords (ROPC), ROPC scope, Transitive group membership.
Google Workspace Google Secure LDAP with the LDAP client certificate from the Admin console. Passwords by user bind (PAP, EAP-TTLS/PAP); no MS-CHAP or PEAP-MSCHAPv2. Primary domain, LDAP client certificate (PEM), LDAP client key (PEM), Base DN (optional), Max pooled connections.
Okta Okta authn API for passwords; Users and Groups API for attributes. Okta org URL, API token (SSWS), Accept password when MFA is required.
Generic SQL DB PostgreSQL, MySQL, MariaDB or MSSQL. Supports backup servers. Database type, Server, Port, Database, Login username, Login password, Password type (User_Password column), Password header, TLS, Max connections.
HTTP (REST) A JSON REST API with an optional password-verify endpoint. Base URL, Authentication (None, Basic, Bearer, Header, SSWS), Username, Password, Token, Token header name, Extra headers, Secret headers, Secret parameters, Filter method, Filter POST body (template), Verify server certificate, Trusted CA (PEM), User lookup path, Password verify path and its verify settings, User-not-found HTTP status.
RADIUS server PAP proxy to another RADIUS server; Access-Accept attributes become authorization attributes. Supports backup servers. Server, Port (default 1812), Shared secret, NAS-Identifier, NAS-IP-Address, Retransmissions, Require Message-Authenticator in replies, Treat Access-Reject as unknown user.
Token server (RADIUS) An OTP or MFA server over RADIUS. As RADIUS server.
Static Host List MAC and IP lists from MAC lists as a MAC-authentication source. Static host lists.

Every type except Static Host List also has Server timeout (s) (default 5).

Tab Fields
General Name (required), Type, Description, the type’s capabilities, Enabled, Use for authorization (fetch this directory’s filter attributes for users it authenticates), Additional authorization sources (queried in order for users this directory authenticates), Cache timeout (seconds) (0 to 604800; default 10 hours) and a Preset list.
Connection The type’s connection fields above, grouped into sections such as Server, Credentials and Directory search.
Filters & attributes Each filter has a name, an Enabled switch, a query (an LDAP filter, SQL query, request path, Graph or Okta query, depending on the type) and Attributes → aliases rows. Variables such as %{Authentication:Username} can be inserted.
Backup servers Types that support them. Extra hosts (and, for RADIUS, a shared secret) tried when the primary does not answer.

Built-in repositories keep their name and type; you can change their description, filters, cache timeout and authorization chaining.

Action What it does
Add directory Opens the type picker, then the editor. Create source saves it and opens its panel.
Search name, description, server… Filters the list.
All types Filters by type.
Origin filter All sources, Your directories, Built-in, Used for authorization, Disabled or Driver missing.
Clear filters Resets search, type and origin.
Refresh Reloads the list and the type catalogue.
Test connection (lightning icon) Connects to the saved directory and reports the result and latency. In the editor, Test connection tests the unsaved settings.
Test a user (person icon) Opens the Test user tab. Enter a Username and select Look up, or add a Password (optional) and select Verify. The test also runs the authorization chain. The username is recorded in the audit log; the password is not.
Enable / Disable (power icon) A disabled directory is skipped for authentication and authorization. Built-in sources cannot be disabled.
Edit Opens the editor. Save changes saves (Ctrl+S also saves).
Clone Opens a copy named Copy of <name>. Secrets are not copied and must be entered again.
Delete After confirmation, removes the directory. A directory still used by a policy or by another directory’s authorization chain cannot be deleted; Airgate lists where it is used. Built-in sources cannot be deleted.
Restore default filters In the editor, replaces all filters with the type’s defaults after confirmation.
Bulk Test connection, Enable, Disable, Delete Select rows, then choose an action. Built-in sources are skipped.
  • View: policy:read: Tenant Administrator, Network Administrator, Help Desk, Read-only Administrator and Platform Administrator. These roles can also run Test connection on a saved directory.
  • Change: policy:write: Tenant Administrator, Network Administrator and Platform Administrator. Test a user and testing unsaved settings also need policy:write.
  • Domain join tab: Platform Administrator only.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security