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.
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.
openid — sign the user inemail — the user's email addressprofile — 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 directoryUser.Read — sign in and read the signed-in user's own profileAirgentic does not request access to mail, files, or other organisational data. Nothing is stored beyond what is needed to sign the user in.
d4fa8e79-2ee2-4ad2-80ab-d9821c907b96If 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.
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:
d4fa8e79-2ee2-4ad2-80ab-d9821c907b96The 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:
openid, email, profile, offline_access, and User.ReadThe 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.
No additional data access is requested.
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.
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.
AADSTS65001Your 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.
AADSTS50105 errorThe application requires user assignment. Go to Enterprise applications > Airgentic Console > Properties and either:
This can happen if:
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).
If you have questions or need assistance, contact the Airgentic support team:
Email: support@airgentic.com