Set up your own sender
By default, reports, alerts and owner questions come from notification@tenant-cockpit.com. With your own shared mailbox in your tenant, they appear under your name, for example as cockpit@your-company.com. This increases acceptance by owners and reduces spam filing.
The process at a glance
- Create a shared mailbox in Exchange Online (no licence needed).
- Give the Tenant Cockpit the “Send mail” right only for this one mailbox (Exchange script below).
- In the Tenant Cockpit, enter the address under Settings → Email sender and check it with “Send test mail”.
Takes about 10 minutes. You need the Exchange Administrator role (or membership in the “Organization Management” role group) and access to Microsoft Graph PowerShell to look up an ID. The Tenant Cockpit needs no new consent in Entra for this and gets no access to other mailboxes.
Step 1: Create a shared mailbox
In the Exchange admin center under Recipients → Mailboxes → Add a shared mailbox, or with PowerShell. The address must belong to a verified domain of your tenant.
Connect-ExchangeOnline
New-Mailbox -Shared -Name "Tenant Cockpit" -DisplayName "Tenant Cockpit" -PrimarySmtpAddress {{MAILBOX}}The display name is visible to recipients. Choose a name your colleagues will recognise.
Step 2: Grant “Send mail” for this mailbox only
This uses RBAC for Applications in Exchange Online (the successor of “Application Access Policies”). The right applies only to this one mailbox. The app can neither read mail nor send from other mailboxes.
Connect-ExchangeOnline
Connect-MgGraph -Scopes 'Application.Read.All'
$Mailbox = '{{MAILBOX}}'
$AppId = '{{APPID}}' # vivaXite Tenant Cockpit (enterprise application in your tenant)
# Look up the object ID of the enterprise application (not that of the app registration)
$sp = Get-MgServicePrincipal -Filter "appId eq '$AppId'"
# 1. Create a pointer to the application in Exchange
New-ServicePrincipal -AppId $AppId -ObjectId $sp.Id -DisplayName 'vivaXite Tenant Cockpit'
# 2. Scope: exactly this one mailbox
New-ManagementScope -Name 'TenantCockpit-Absender' -RecipientRestrictionFilter "PrimarySmtpAddress -eq '$Mailbox'"
# 3. Assign "Send mail" limited to this scope
New-ManagementRoleAssignment -App $sp.Id -Role 'Application Mail.Send' -CustomResourceScope 'TenantCockpit-Absender'
# 4. Check: InScope must be True
Test-ServicePrincipalAuthorization -Identity $sp.Id -Resource $Mailbox | Format-Table RoleName, GrantedPermissions, InScope- The application “vivaXite Tenant Cockpit” already exists in your tenant once you have connected the Tenant Cockpit.
- Exchange applies changes after 30 minutes to 2 hours (cache). The check with
Test-ServicePrincipalAuthorizationshows the result immediately. - Do not grant organisation-wide
Mail.Sendin Entra for this application. It would cancel the scope because both rights add up.
Step 3: Enter and test in the Tenant Cockpit
- Open the Tenant Cockpit, Settings → Email sender.
- Enter and save the address of the shared mailbox. Only addresses of your verified domains are allowed.
- Choose Send test mail. The mail arrives within about 5 minutes. The card then shows “Checked” with the date.
Optionally you can choose whether a copy of every sent mail is saved in the “Sent Items” folder of the shared mailbox (default: off). No additional right is needed for this.
If sending fails, the card shows the error message. Reports and alerts continue to go out via the default sender in the meantime, so nothing is lost.
Which mails will come from your address?
| Sender | |
|---|---|
| Weekly and monthly report, alerts (secrets, new urgent items) | Your shared mailbox |
| Licence alerts (changes, low stock), test mails | Your shared mailbox |
| Questions to owners (replies still go to the person who asked) | Your shared mailbox |
| Notice when the licence quota is exceeded (also goes to vivaXite) | notification@tenant-cockpit.com |
Troubleshooting
| Message | Cause and solution |
|---|---|
ErrorAccessDenied / 403 | Right not yet active (wait up to 2 hours) or wrong scope. Test-ServicePrincipalAuthorization must show InScope = True. |
MailboxNotEnabledForRESTAPI / ErrorInvalidUser | The address is not a mailbox in Exchange Online or was just created. Wait a few minutes, check the spelling of the address. |
| “does not belong to the verified domains” | The domain of the address is not registered as a verified domain in the tenant. |
New-ServicePrincipal reports “already exists” | The pointer already exists. Run steps 2/3/4 anyway. |
| Mail ends up in spam | Allow the sender address and domain in your mail security (SPF and DKIM of your domain apply as for any Exchange mail). |
Back to the default sender
Clear the address in the Tenant Cockpit and save. Optionally remove the right:
Get-ManagementRoleAssignment -RoleAssignee 'vivaXite Tenant Cockpit' | Remove-ManagementRoleAssignment Remove-ManagementScope -Identity 'TenantCockpit-Absender' Remove-ServicePrincipal -Identity 'vivaXite Tenant Cockpit'
