vivaXite

Tenant Cockpit

Help

Guides and answers for the Tenant Cockpit. Search for a keyword or choose a topic.

Frequently asked questions from IT admins

Which Graph permissions does the Tenant Cockpit need and why?

Only read-only Microsoft Graph application permissions (including Group.Read.All, Sites.Read.All, User.Read.All, AuditLog.Read.All, Reports.Read.All, Application.Read.All, Organization.Read.All, ServiceHealth.Read.All, ServiceMessage.Read.All). An Entra administrator grants consent once (admin consent) and can revoke it at any time under “Enterprise applications”. Reason for each permission: Security.

Are mails or files read?

No. The Tenant Cockpit only reads metadata (names, owners, activity and expiry dates, licences), no files, emails or chat content, and changes nothing in the tenant. Details: Security, Privacy.

Where is the data stored?

In Europe: website, API and scans run on Microsoft Azure (EU), the database at Supabase on AWS in Zurich (Switzerland, adequacy decision of the European Commission). No processing takes place outside Europe. Service providers: Security and DPA.

Who may do what? Which roles exist?

You control access via Entra groups: for each page of the Tenant Cockpit, an administrator defines which group may see it. Tenant Cockpit administrators manage assignments and settings. The reporting API works with its own revocable keys. See “Who can use the Tenant Cockpit” under Getting started.

Does it work with conditional access and MFA?

Users sign in via Microsoft Entra ID (MSAL). Your conditional access policies and MFA requirements therefore apply as for any other Entra application. There are no passwords and no client secret at vivaXite (Security).

Which Microsoft clouds are supported?

Currently the Microsoft 365 standard cloud (sign-in via login.microsoftonline.com). GCC, GCC High or sovereign clouds are not part of the offering; if needed, ask us: support@tenant-cockpit.com.

What happens when an earlier 30-day trial ends?

The trial ends automatically. After that, no data can be retrieved and scans stop until a licence is in place; assignments and settings are kept. Export your data beforehand (see Full export). Pricing and licence: Pricing.

How do I revoke access or uninstall the Tenant Cockpit?

Under “Administration”, an administrator disconnects: all stored data of your tenant is deleted immediately (only the tenant ID and tenant name with the status “disconnected” remain). In addition, remove the enterprise application in Entra. See Disconnect.

How do I reach support and how quickly does it respond?

By email (support@tenant-cockpit.com) and phone (+43 677 615 799 10) during normal business hours. Binding response times and availability are agreed in the offer (Terms of Use §7).

Getting started

How do I start?

Sign in with your Microsoft account. An Entra administrator grants consent once (read permissions only). The first scan then runs; you usually see the results after a few minutes. The checklist on the overview guides you through the next steps.

How can I try the Tenant Cockpit?

Under Hands On right now the Tenant Cockpit runs after a short release (name and confirmed email address, phone optional), using sample data of a fictitious company. No real tenant is connected and no data of your company is stored; changes are not possible. For your own tenant you need a licence (request an offer).

Who can use the Tenant Cockpit and how do I share pages?

Members of the Entra groups an administrator enables per page. Open Administration, choose a group for each page and save. Guest accounts are never allowed. Anyone not in an enabled group sees “No licence”.

How often is the data updated?

Daily at night. With “Scan now” at the top you trigger a scan immediately; it finishes after a few minutes.

The setup checklist is in the way. How do I hide it?

“Hide now” only hides it for the current session. “Hide permanently” applies to the whole tenant. To show it again: Settings, section “Setup checklist”. It disappears by itself once all checkable steps are done.

Ratings and checks

What do green, yellow, red and dark red mean?

Yellow (“Review”): inactive for a longer time. Red (“Urgent”): inactive for even longer or too few owners. Dark red (“Critical”): inactive for a very long time or without owners. You can see the exact thresholds in the object's detail panel.

How is tenant health calculated?

Average over all objects: green counts 100, yellow 60, red 25, dark red 0. Deferred objects and Microsoft's own apps do not count.

What is “Defer”?

You take an object out of the rating with a justification (and optionally until a date). It appears under Reports, “Deferred”, and does not count in status indicators and reports. You can defer several objects at once in the object list using the checkboxes.

What is “Contact owner” for?

The Tenant Cockpit asks the owners by email whether the object is still needed. The answer (keep or no longer needed) is stored with the object.

How does the Action Plan work?

Open an object and choose “Assign”: search for the person in the directory and set the due date and action. The person receives an email immediately and, after signing in to the Tenant Cockpit, sets the status to “In progress” or “Done”. All tasks are listed under Overview → Action Plan, sorted by severity and due date. The person is reminded before the due date and when overdue; an administrator sets the timing under Administration → Portal settings. Hovering over a name shows the contact card with photo and contact details.

How do I save filters and work with several objects?

Set filters in the object list and choose “Save view”. Your browser remembers saved views. Use the checkboxes in front of the rows to select objects and defer them together or export the selection as CSV.

What does the Governance page check?

Objects without owners, with only one owner, without a sensitivity label, with external members, publicly visible groups and inactive guests. Each category is collapsed and shows the affected objects on click. Tenant hardening is shown below.

What is tenant hardening and why does it say “Permission missing”?

Hardening checks conditional access (MFA for all, legacy block), global administrators (number, guests, PIM), external sharing in SharePoint and app registrations with far-reaching permissions. It only reads. For this the Tenant Cockpit needs three additional read permissions: Policy.Read.All, RoleManagement.Read.Directory and SharePointTenantSettings.Read.All. If they are missing, it says “Permission missing”. An administrator grants them under Administration, “Set up access rights”, and then starts a scan. The data is collected at night.

What does the “Security” section show?

It shows, read-only, how secure and tidy your tenant is: MFA per user, risky accounts, administrator accounts, devices (compliance, encryption), Secure Score, open Defender alerts, mailboxes and OneDrive, forwarding rules to external addresses (checked on a rotating basis over several hours in large tenants; known target domains can be accepted) and SPF, DKIM and DMARC of your domains. Each finding has a status indicator, an explanation (“Why”) and a fix. The data is collected once a day; the “History” shows the trend.

Additional read permissions (all optional): IdentityRiskyUser.Read.All, DeviceManagementManagedDevices.Read.All, Device.Read.All, SecurityEvents.Read.All, SecurityAlert.Read.All and MailboxSettings.Read. If one is missing, only the affected area shows “Permission missing”. An administrator grants them under Administration → Set up access rights → “Grant consent again”. Some areas need licences (Entra ID P2, Intune, Defender).

What does the Compliance page show?

It maps the automatic checks to ten controls and names, for each control, the reference to NIS2 (Art. 21), ISO/IEC 27001:2022 (Annex A) and DORA, each with a link to the official text. Clicking the number in the “Findings” column shows the affected objects. “Print / PDF” creates a landscape page with a repeated header. This is guidance, not a certification and not legal advice. The Tenant Cockpit cannot check organisational measures.

What does the “Changes” page show?

What has changed since the last nightly run: newly appeared, removed, better or worse in status. You can choose from “Since yesterday” to “Last 60 days”. The data is available from the second nightly run.

What is the Remediation add-on and which role do I need for it?

The optional Remediation add-on lets you fix individual findings from “Configuration & Policies” (Best Practice Analysis) directly in the Tenant Cockpit with one click – using solely your own signed-in Microsoft Entra role, never a technical account belonging to vivaXite. If your role is not sufficient, the Tenant Cockpit shows which role is needed and offers text for a request to the right person. The add-on is activated under Administration, after accepting the additional legal annexes.

Which setting needs which role (always the least privileged; Global Administrator only appears where Microsoft provides no alternative):

Loading …

Reports and alerts

Which emails does the Tenant Cockpit send?

Weekly report, alerts for new urgent items or expiring secrets, monthly report for management and questions to owners. You set recipients and frequency under Settings, “Alerts and reports”. Recipients must belong to your own domains. The language of all emails is set under Settings, “Language of emails”.

Can I use my own sender?

Yes, a shared mailbox of your company; the “Send mail” right is limited to exactly this mailbox. Guide to your own sender

How do I get alerts in Microsoft Teams or my ticketing system?

Teams:

  1. In Teams, choose the channel, open Workflows and use the template “Post to a channel when a webhook request is received”.
  2. Copy the generated address (ends in logic.azure.com or powerplatform.com).
  3. In the Tenant Cockpit under Settings, “Alerts and reports”, section “Teams or ticketing system (webhook)”: type “Microsoft Teams”, paste the address, save and “Send test message”.

Ticketing system or SIEM: choose type “Generic”. The Tenant Cockpit then sends JSON via POST:

{
  "event": "tenant-cockpit.alert",
  "test": false,
  "tenant": "Contoso",
  "total": 2,
  "portalUrl": "https://tenant-cockpit.com",
  "items": [ { "kind": "expiring", "type": "AppReg", "name": "HR Portal", "when": "2026-11-01" } ]
}

The address is a secret and is only shown masked. Internal addresses (e.g. 10.x, 192.168.x) are not allowed for security reasons; only https is accepted.

How do I create the management report?

Open “Management report” on the overview, then “Print / Save as PDF”. The report contains the overall score, value, status per area, governance, compliance, risks and actions.

API and automation

The API: create keys, call it and what it can do

Overview

The Tenant Cockpit API is a read-only REST API that returns JSON (and CSV for objects). Use it to bring results into Power BI, Excel, scripts, a SIEM or your ticketing system. The API returns exactly the data of your own tenant. Nothing can be changed through it.

Base address: https://tenant-cockpit.com/api/v1

1. Get a token (API key)

No Microsoft Entra token or OAuth is needed. The “token” is an API key that a Tenant Cockpit administrator creates:

  1. Sign in to the Tenant Cockpit and open Administration in the menu at the top (visible to administrators only).
  2. Expand the section “API keys (export and automation)”.
  3. Enter a name, e.g. “Power BI”, and choose “Create key”.
  4. Copy the key shown immediately. It starts with vxk_ and is shown in plain text only this once. The Tenant Cockpit stores only a hash.

Up to 10 keys per tenant are possible, ideally one per application. In the same list you see when a key was last used and can block it immediately with “Revoke”. Treat the key like a password: do not put it in source code or chats but in a vault (e.g. Azure Key Vault). If it was exposed, revoke it and create a new one.

2. Calling the API

The key is sent as a bearer token in the Authorization header.

curl

curl -s https://tenant-cockpit.com/api/v1/summary \
  -H "Authorization: Bearer vxk_YOUR_KEY"

PowerShell

$key = "vxk_YOUR_KEY"
$r = Invoke-RestMethod -Uri "https://tenant-cockpit.com/api/v1/objects?status=Urgent" `
  -Headers @{ Authorization = "Bearer $key" }
$r.objects | Select-Object name, type, reasons | Format-Table

Python

import requests
h = {"Authorization": "Bearer vxk_YOUR_KEY"}
r = requests.get("https://tenant-cockpit.com/api/v1/objects", headers=h, params={"type": "Team"})
r.raise_for_status()
for o in r.json()["objects"]:
    print(o["name"], o["status"])

Power BI / Excel (web query): “Get data”, source “Web”, Advanced. URL https://tenant-cockpit.com/api/v1/objects?format=csv, header Authorization with the value Bearer vxk_…. The CSV is semicolon-separated and UTF-8 with BOM; it opens directly in Excel.

3. Endpoints

PathReturns
GET /objectsAll rated objects (teams, groups, sites, guests, app registrations, enterprise apps, Power Apps, flows, agents). Filters: ?type=, ?status=, ?format=csv
GET /summaryKey figures: number of objects, overall score (0 to 100), distribution by status and by type
GET /governanceGovernance checks with affected objects (owners, classification, external users, guests)
GET /complianceTen controls with status, findings and reference to NIS2, ISO 27001 and DORA
GET /hardeningHardening checks: conditional access, administrator roles, external sharing, app permissions
GET /changesChanges of the last 60 days: new, removed, better, worse
GET /licensesLicense inventory per product, license changes and licenses without use (savings potential)
GET /securitySecurity overview: key figures, findings per area and the most important open items
GET /security/{area}All findings of one security area with status, reason and fix. Areas: identity, devices, office, score, storage, domains, powerplatform, powerbi, sharing (sharing and guests), policies (configuration, policies and change log), usage (usage and adoption), audit (audit and sign-ins), copilot (Copilot readiness)
GET /security/trendDaily history of the security figures (score, MFA coverage and more)

4. Fields and values

An entry from /objects:

{
  "count": 1,
  "objects": [ {
    "id": "…", "type": "Team", "name": "Project Alpha", "status": "Red",
    "reasons": "Inactive>=180d;FewOwners", "ageDays": 212,
    "owners": "anna@contoso.com", "ownerCount": 1,
    "createdAt": "2024-02-01T08:00:00Z", "lastActivity": "2026-03-15T00:00:00Z",
    "lastScan": "2026-10-13T04:35:00Z", "url": "https://…", "deferred": false
  } ]
}
  • type: Team, M365Group, Site, Guest, AppReg, EntApp, PowerApp, ModelApp, Agent, Flow
  • status: Green (OK), Yellow (review), Red (critical), Urgent (action required)
  • reasons: reasons separated by semicolons, e.g. NoOwner, FewOwners, Inactive>=180d, CredExpiringSoon, CredAllExpired
  • deferred: true if the object has been deliberately deferred

Example for /summary:

{ "objects": 274, "score": 23,
  "byStatus": { "Urgent": 112, "Red": 80, "Yellow": 53, "Green": 29 },
  "byType": { "Team": 40, "Guest": 120, "AppReg": 35 } }

5. Limits and errors

  • Limit: 120 calls per minute per key owner (tenant) and 120 per minute per IP address. If exceeded, you get 429 with the header Retry-After (seconds until the next attempt).
  • Freshness: the data comes from the nightly scan; querying more often does not return newer values. One call per day or hour is enough.
  • Licence: the tenant must be connected and licensed (or in the trial).
  • Language: error messages follow the Accept-Language header (German or English).
CodeMeaning
401Header missing, key invalid or revoked. Format: Authorization: Bearer vxk_…
403Tenant not connected or no valid licence, or trial expired
404Unknown path. Allowed are objects, summary, governance, compliance, hardening, changes
429Too many requests, observe Retry-After

Note on data: if you process the data further, protect CSV cells beginning with =, +, - or @ against formula evaluation in Excel yourself. The Tenant Cockpit prefixes such cells with an apostrophe in its own exports.

How do I handle API keys securely?

One key per application, with a meaningful name. Store keys in a vault and renew them regularly: create a new key, switch the application over, revoke the old one. “Last used” in the list shows whether a key is still needed. All create and revoke actions are recorded in the administrative action log (Administration).

Ask with Claude or Microsoft 365 Copilot (MCP)

With the optional MCP module, people query their tenant directly in Claude (as a connector or in Claude Code) or in Microsoft 365 Copilot (as an agent) or Copilot Studio, for example "Which objects are urgent?". Access is read-only and shows only what the person may also see in the portal.

Setup, administrator consent, the server address and the app package for Teams to download are here: Connect Tenant Cockpit to Claude and Copilot.

Data and export

How do I export data as CSV?

The object list has “Export as CSV” (the current filter applies). Governance and Compliance also have a CSV export. For automation, use the API.

How do I take all my data with me (exit)?

Administrators download all stored data as JSON under Settings, “Data export and exit”: inventory, history, changes, exceptions, settings and log. Secrets are not included. This also works after the trial has expired and is limited to 5 exports per hour.

What happens on “Disconnect”?

All stored data of your tenant is deleted immediately, including API keys and the log. You can additionally revoke the granted read permissions in Entra under “Enterprise applications”. Export beforehand if you need the data.

Privacy and security

What does the Tenant Cockpit read?

Only metadata (names, owners, activity data, permission and policy settings), no content such as files, mails or chats. The Tenant Cockpit changes nothing in your tenant. Details: Security and Privacy.

Is there a DPA?

Yes: Data Processing Agreement. On request we send it signed.

Where can I see who changed what?

Under Administration in the “Administrative action log”: creating and revoking keys, settings, deferrals, export and other actions, each with time and user.

Problems

I don't see any data.

Check whether consent was granted and the first scan ran. An administrator can trigger it with “Scan now”. For apps, the scan needs the permission Application.Read.All.

I get “No licence”.

Your account is not assigned to an enabled group. Contact your administrator (under Administration they can see which group applies to each page).

The MFA report is empty.

Microsoft's MFA report requires Entra ID P1 or P2.

The API responds with 401, 403 or 429.

401: check the key (format Authorization: Bearer vxk_…, not revoked). 403: tenant not connected or licence expired. 429: limit of 120 calls per minute reached, wait for Retry-After. See the article “The API”.

How do I reach support?

support@tenant-cockpit.com or +43 677 615 799 10.