Smart Banners reads each incoming email through your provider's API and adds the banner to it. A tenant administrator grants this access once. The step stays red until the access is granted.
- What does Smart Banners require?
- A · Microsoft 365
- B · Google Workspace
- How do I check the access was granted?
- How do I revoke it?
- Can I limit Smart Banners to some mailboxes?
What does Smart Banners require?
- Microsoft 365: an admin consent to the application LibraCyber Banners, which reads and modifies the emails in your users' mailboxes and reads user profiles.
- Google Workspace: domain-wide delegation to a service account that LibraCyber creates for your company, with five Gmail scopes.
Every permission, what it lets Smart Banners do and why: Permissions requested.
To grant it, follow the flow of your provider: A · Microsoft 365 or B · Google Workspace.
A · Microsoft 365
Do
- In API Access Setup, click Grant Provisioning Permissions. It opens General Settings › Office Users Provisioning.
- On the row Allow LibraCyber to display banners on incoming emails., click Grant Email Process Consent to LibraCyber.
- The dialog Warning: Granting Consent reminds you that a Microsoft Global admin account is required. Click Grant Consent, or click Copy link and send the link to your Global Administrator. When you work on a company other than your own (for example as an MSP), only Copy link is available.
- On the Microsoft page, sign in as Global Administrator and accept the permissions requested by the application LibraCyber Banners.
- Back in the console, open Smart Banners › Setup.
A step-by-step guide with screenshots is available: Setup for Microsoft Banners.
General Settings › Office Users Provisioning · on the banners row, Grant Email Process Consent to LibraCyber; the status reads Not granted yet until the consent is accepted
Expected result
The row shows Already granted, and API Access Setup shows It works! with a green tick.
API Access Setup on Microsoft 365 once the consent is granted: It works!
If the step still shows Not connected, the consent was not completed: start again from action 1.
Not connected: the consent of step 2A has not been granted yet
B · Google Workspace
On Google Workspace, Smart Banners uses a service account created by LibraCyber for your company. You authorise it in your Google Admin console with domain-wide delegation.
Do
- In API Access Setup, check that User Service Account setup has a green tick and note the AccountID shown next to it.
- Click How to grant Consent: it opens the step-by-step guide.
- Follow the guide in your Google Admin console as super administrator, with the AccountID of action 1 and the scopes listed in Permissions requested › Google Workspace.
- Back in the console, tick I confirm I have given access to the service account.
API Access Setup on Google Workspace: the service account AccountID, How to grant Consent and the confirmation to tick
Expected result
The step turns green.
If the step shows User Service Account not setup, the service account has not been created on LibraCyber's side yet: contact support.
User Service Account not setup: the service account does not exist yet on LibraCyber's side
How do I check the access was granted?
In the console, the step turns green. In your tenant, the access is listed where your provider shows third-party access:
- Microsoft 365: the step shows It works!, and General Settings › Office Users Provisioning shows Already granted. In the Microsoft Entra admin center, Enterprise applications lists LibraCyber Banners; its Permissions page shows the permissions granted with admin consent.
- Google Workspace: in the Google Admin console, Security › Access and data control › API controls › Domain-wide delegation lists the client ID of the Smart Banners service account with all the scopes. In the console, the tick only records your confirmation: the console does not check your Google configuration. The real check is Step 3: Test Deployment.
How do I revoke it?
Revoke the access only as part of offboarding, after turning Smart Banners off (see Turning it off and offboarding). Smart Banners then stops processing your emails.
- Microsoft 365: remove LibraCyber Banners from the enterprise applications of your tenant (or revoke its permissions) in the Microsoft Entra admin center. Grant Direct Message Injection Consent to LibraCyber is shared with the rest of the platform (phishing simulations, test and notification emails): remove it only if you leave the platform altogether.
- Google Workspace: delete the Smart Banners service account from Domain-wide delegation in the Google Admin console. The account the platform uses to deliver its emails (phishing simulations, notifications) is separate: leave it in place if you keep using the platform.
Can I limit Smart Banners to some mailboxes?
Yes: only the users you activate in Smart Banners › Users have their emails processed. In your tenant, the access itself can be restricted on Microsoft 365, not on Google Workspace:
- Microsoft 365: the consent covers every mailbox of the tenant. Your Exchange Online administrator can restrict the application to the members of a group, before the consent is granted (procedure below).
- Google Workspace: domain-wide delegation applies to every user of the domain; it cannot be restricted to some organisational units.
Microsoft 365: restrict the application to a group
- In the Exchange admin center, create a mail-enabled security group and add the users to protect. A new group can take up to a few hours to be visible to Exchange Online.
- Ask LibraCyber support for the application ID of LibraCyber Banners and the procedure. Then create the Exchange Online application access policy for that group.
- Wait before granting the consent: the policy can take more than an hour to apply.
- To check the restriction, run
Test-ApplicationAccessPolicyin Exchange Online PowerShell with the application ID, for a user inside the group and for one outside it. Access must be granted for the first and denied for the second.
With such a restriction, activate in the console only the members of the group. Microsoft 365 refuses access to any other mailbox: such a user receives no banners and may still show Active in Smart Banners › Users.
Details: Permissions requested