vivaXite

Tenant Cockpit

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

  1. Create a shared mailbox in Exchange Online (no licence needed).
  2. Give the Tenant Cockpit the “Send mail” right only for this one mailbox (Exchange script below).
  3. 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

Step 3: Enter and test in the Tenant Cockpit

  1. Open the Tenant Cockpit, Settings → Email sender.
  2. Enter and save the address of the shared mailbox. Only addresses of your verified domains are allowed.
  3. 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?

MailSender
Weekly and monthly report, alerts (secrets, new urgent items)Your shared mailbox
Licence alerts (changes, low stock), test mailsYour 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

MessageCause and solution
ErrorAccessDenied / 403Right not yet active (wait up to 2 hours) or wrong scope. Test-ServicePrincipalAuthorization must show InScope = True.
MailboxNotEnabledForRESTAPI / ErrorInvalidUserThe 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 spamAllow 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'