Help

Overview Admin Chat Data Sync Upload Documents Search Settings Curated Answers Agents, Prompts & Functions Contact Support

Admin Console Authorisation

Airgentic Help

This guide is for IT administrators whose organisations require approval before users can sign in to third-party applications using Microsoft or Google accounts. It is also accessible at admin.airgentic.com/it-admin-setup.


Do You Need This Page?

Most organisations do not need any IT setup. Airgentic only requests the sign-in permissions listed below, which users can consent to themselves in most Entra ID configurations.

This page is needed only if your organisation has configured Azure AD / Entra ID to block all third-party applications regardless of what permissions they request — a strict security policy used by some government, education, and enterprise environments.

If your users have .gov, .gov.au, or .edu email addresses, or if your organisation enforces strict app approval policies, follow the steps below.


Microsoft / Entra ID Setup

What permissions does Airgentic request?

  • openid — sign the user in
  • email — the user's email address
  • profile — basic profile information (name). Microsoft shows this as "View users' basic profile"
  • offline_access — Microsoft shows this as "Maintain access to data you have given it access to". It does not give access to mail, files, or the directory
  • User.Read — sign in and read the signed-in user's own profile

Airgentic does not request access to mail, files, or other organisational data. Nothing is stored beyond what is needed to sign the user in.

Application details

  • Application name: Airgentic Console
  • Publisher: Airgentic Pty Ltd (verified publisher)
  • Application (client) ID: d4fa8e79-2ee2-4ad2-80ab-d9821c907b96

If your organisation also uses an Airgentic secure service, such as a chatbot on your intranet, that service has its own app registration in your tenant, often named for the service. Approving that app does not allow sign-in to the admin console. The admin console application is Airgentic Console, published by Airgentic Pty Ltd.


A Global Administrator or Application Administrator can approve Airgentic Console for the whole organisation in one step. Sign in with that administrator account and choose Accept:

Grant admin consent for Airgentic Console

Microsoft then returns you to Airgentic. You may land back on this guide. That is expected: the consent is already recorded.


Option 2: Approve the pending request

Airgentic Console does not appear under Enterprise applications until consent has been granted. Searching All applications by name or by the Application ID returns no results until then.

When someone chooses Sign in with Microsoft and your tenant requires approval, Entra keeps an admin consent request. Approve that request:

  1. Sign in to the Microsoft Entra admin center
  2. Go to Enterprise applications > Overview > Admin consent requests
  3. Open the All tab and find Airgentic Console, Application ID d4fa8e79-2ee2-4ad2-80ab-d9821c907b96
  4. Review the request and approve it

The app then appears under Enterprise applications > All applications, with the status Activated. Check that the publisher is Airgentic Pty Ltd.

If there is no pending request, use the admin consent link in Option 1. That creates the enterprise application. You can then open Airgentic Console > Permissions and click Grant admin consent if it is not already granted.

Sending a justification from the Approval required screen does not sign the user in. The same screen stays up until an administrator approves the request.


Instead of approving Airgentic Console once for the organisation, you can let users consent to low-impact permissions on apps from verified publishers:

  1. Sign in to the Microsoft Entra admin center
  2. Go to Enterprise applications > Consent and permissions > User consent settings
  3. Select Allow user consent for apps from verified publishers, for selected permissions
  4. Open Permission classifications
  5. Add these Microsoft Graph delegated permissions and classify each as low impact: openid, email, profile, offline_access, and User.Read

The user consent setting on its own is not enough. If any of those permissions is missing from the low-impact list, users still see Approval required.

Airgentic Pty Ltd is a verified publisher, so once those permissions are classified, users can accept the sign-in prompt themselves.


Google Workspace Setup

What permissions does Airgentic request?

  • Basic profile information (email address and name)
  • OpenID Connect authentication scopes

No additional data access is requested.

How to pre-approve for Google Workspace

  1. Sign in to the Google Admin Console
  2. Navigate to Security > API Controls > App access control
  3. Click Manage Third-Party App Access
  4. Search for "Airgentic" or add by Client ID (contact support@airgentic.com)
  5. Set access to Trusted for your domain

Note: Google Workspace typically allows user consent by default for basic profile scopes. Pre-approval is only needed if your organisation has restricted app access.


Troubleshooting

The app does not appear when you search Enterprise applications

Search returns no results until consent has been granted. Approve the pending request under Admin consent requests, or use the admin consent link in Option 1. Check you are approving Airgentic Console from Airgentic Pty Ltd, and not the separate app registration for an Airgentic secure service.


"Approval required", "Admin approval required", or AADSTS65001

Your organisation does not let users consent to this application themselves. The user's justification is waiting under Enterprise applications > Admin consent requests. Approve it there, use Option 1, or finish the permission classifications in Option 3.

The prompt stays on every Microsoft sign-in until an administrator approves it. Try the next sign-in in an InPrivate or Incognito window so the browser does not reuse the old session.


"You don't have permission" or AADSTS50105 error

The application requires user assignment. Go to Enterprise applications > Airgentic Console > Properties and either:

  • Set "Assignment required?" to No to allow all users, or
  • Go to Users and groups and add the specific users who need access

Login appears to work but redirects back with no error

This can happen if:

  • The user closed the Microsoft login popup before completing sign-in
  • A browser extension is blocking the OAuth callback
  • The browser is blocking third-party cookies — try disabling strict cookie blocking in your browser settings

Ensure you are signed in with a Global Administrator or Application Administrator account. Other admin roles cannot grant consent for the entire organisation.

If you see AADSTS90094, your tenant may have additional restrictions. Approve the pending request under Admin consent requests instead (Option 2).


Need Help?

If you have questions or need assistance, contact the Airgentic support team:

Email: support@airgentic.com

You have unsaved changes