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.
What this page shows
Section titled “What this page shows”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
Authenticationis 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.
Fields and columns
Section titled “Fields and columns”List columns
Section titled “List columns”| 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. |
Directory types
Section titled “Directory types”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).
Editor tabs
Section titled “Editor tabs”| 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.
Actions
Section titled “Actions”| 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. |
Permissions
Section titled “Permissions”- 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 needpolicy:write. - Domain join tab: Platform Administrator only.