# Bsure Documentation ## Version 1 - [Welcome](https://docs.bsure.io/v1/welcome.md): Bsure Insights is a business app that gives organizations full visibility into their Microsoft Entra identities. - [Overview](https://docs.bsure.io/v1/installation/overview.md): A brief description of our product, Bsure Insights. - [Prerequisites](https://docs.bsure.io/v1/installation/prerequisites.md): Before starting the installation, make sure to have all prerequisites in place. - [Installation Instructions](https://docs.bsure.io/v1/installation/installation-instructions.md): How to install the Bsure Insights Marketplace app - [Installation Guide](https://docs.bsure.io/v1/getting-started/installation-guide.md) - [Design Principles](https://docs.bsure.io/v1/technical-description/design-principles.md): Why and how Bsure Insights differentiates from many other offerings. - [Azure Managed Application](https://docs.bsure.io/v1/technical-description/azure-managed-application.md): Description of Bsure Insights Data Collector application. - [Permissions Required](https://docs.bsure.io/v1/technical-description/permissions-required.md): by the Bsure Insights Data Collector Managed Application - [Security​](https://docs.bsure.io/v1/technical-description/security.md) - [Public IP and Storage Account Key considerations](https://docs.bsure.io/v1/technical-description/security/public-ip-and-storage-account-key-considerations.md) - [Technical Architecture](https://docs.bsure.io/v1/technical-description/technical-architecture.md) - [Dataflow and visibility](https://docs.bsure.io/v1/technical-description/dataflow-and-visibility.md) - [Overview](https://docs.bsure.io/v1/user-guides/overview.md) - [Main Dashboard](https://docs.bsure.io/v1/user-guides/main-dashboard.md) - [Users](https://docs.bsure.io/v1/user-guides/users.md) - [Dashboard](https://docs.bsure.io/v1/user-guides/users/dashboard.md): The Users Dashboard has two parts. Tiles showing your tenant's users - types and state. And a user data quality section showing status over time for some of the most commonly used user properties. - [Members](https://docs.bsure.io/v1/user-guides/users/members.md): Report showing active, inactive and disabled member users. Entra ID Member accounts are all user accounts controlled and owned by your Entra ID. Your internal users. - [Guests](https://docs.bsure.io/v1/user-guides/users/guests.md): Report showing active and inactive guest users. Entra ID guest accounts are external user accounts invited to your tenant/EntraID where they typically have access to Teams or Sharepoint sites. - [Data Quality](https://docs.bsure.io/v1/user-guides/users/data-quality.md): Use this report to get the insights you need to improve your users data quality - [Properties](https://docs.bsure.io/v1/user-guides/users/properties.md): This pages offers insights into more user properties than users main dashboard - [Sign-in Map](https://docs.bsure.io/v1/user-guides/users/sign-in-map.md): Simply a world map showing which countries your member users have successfully signed in from the last 14 days. - [Sign-in Locations](https://docs.bsure.io/v1/user-guides/users/sign-in-locations.md): Showing users successful sign-in locations for selected sign-in period - [Drilldown](https://docs.bsure.io/v1/user-guides/users/drilldown.md): In this report we combine the information from the previous reports and give you the chance to drill down on all member and guest users statuses. - [Microsoft Licenses](https://docs.bsure.io/v1/user-guides/microsoft-licenses.md): We've created subpages per report with explanations and short videos to help you navigate and understand the different reports under the Licenses section. - [Cost Dashboard](https://docs.bsure.io/v1/user-guides/microsoft-licenses/cost-dashboard.md) - [Licenses Overview](https://docs.bsure.io/v1/user-guides/microsoft-licenses/licenses-overview.md) - [Subscription Overview](https://docs.bsure.io/v1/user-guides/microsoft-licenses/subscription-overview.md) - [Inactive and Disabled Users](https://docs.bsure.io/v1/user-guides/microsoft-licenses/inactive-and-disabled-users.md) - [Overlapping licenses](https://docs.bsure.io/v1/user-guides/microsoft-licenses/overlapping-licenses.md) - [Cost Allocation](https://docs.bsure.io/v1/user-guides/microsoft-licenses/cost-allocation.md) - [Drilldown](https://docs.bsure.io/v1/user-guides/microsoft-licenses/drilldown.md) - [Price Settings](https://docs.bsure.io/v1/user-guides/microsoft-licenses/price-settings.md) - [Add Your Own Prices](https://docs.bsure.io/v1/user-guides/microsoft-licenses/add-your-own-prices.md): By default the prices in our Power Bi App are standard Microsoft list prices in USD. These prices will not be accurate for many organizations. This page will show you how you can add your own prices! - [Average SKU Price Calculator](https://docs.bsure.io/v1/user-guides/microsoft-licenses/add-your-own-prices/average-sku-price-calculator.md): Use this Excel spreadsheet to calculate your average SKU price. - [Applications](https://docs.bsure.io/v1/user-guides/applications.md): The reports under application will give you insight into your Entra ID Enterprise applications. - [Usage](https://docs.bsure.io/v1/user-guides/applications/usage.md): Applications showing in this report consume applications, data and other resources your end-users will have to authenticate by using their Entra ID credentials - [Cost](https://docs.bsure.io/v1/user-guides/applications/cost.md) - [Sign-in Locations](https://docs.bsure.io/v1/user-guides/applications/sign-in-locations.md): The sign-in locations reports will give you insights into from where your users consume your Entra ID applications - [Successful sign-ins from blocked countries?](https://docs.bsure.io/v1/user-guides/applications/sign-in-locations/successful-sign-ins-from-blocked-countries.md) - [Groups](https://docs.bsure.io/v1/user-guides/groups.md): This page gives you the opportunity to see members in one or more Entra ID groups, and by giving a cost to a group it makes it easy to allocate costs. - [Security](https://docs.bsure.io/v1/user-guides/security.md): This report section will bring insights into Entra ID role assignments, status on MFA and sign-in related content, all in an identity related context - [Dashboard](https://docs.bsure.io/v1/user-guides/security/dashboard.md): The Security Dashboard has two parts. The upper part shows you key security related content, while the lower part has a sign-in map displaying where your users sign in from. - [Authentiation Methods](https://docs.bsure.io/v1/user-guides/security/authentiation-methods.md) - [Entra ID Roles](https://docs.bsure.io/v1/user-guides/security/entra-id-roles.md): This page displays active assignments of Entra ID roles assigned to users, groups or service principals. - [Service Principals](https://docs.bsure.io/v1/user-guides/security/service-principals.md): Apps or Service Principals should be considered as a user account and should be monitored closely - [Devices](https://docs.bsure.io/v1/user-guides/devices.md): Reports on Devices from Entra ID - [Windows Dashboard](https://docs.bsure.io/v1/user-guides/devices/windows-dashboard.md): View and manage Windows devices in Microsoft Entra ID with metrics on activity, security, and management status. - [Windows Inactive Devices](https://docs.bsure.io/v1/user-guides/devices/windows-inactive-devices.md): View inactive Windows devices in Microsoft Entra ID with priority details for removal. - [Windows OS](https://docs.bsure.io/v1/user-guides/devices/windows-os.md): Identify devices with out-of-support Windows versions in Microsoft Entra ID. - [Windows Management](https://docs.bsure.io/v1/user-guides/devices/windows-management.md): Assess management status of Windows devices in Microsoft Entra ID to prioritize enrollment. - [Devices per Person](https://docs.bsure.io/v1/user-guides/devices/devices-per-person.md): Analyze the number of devices per user in Microsoft Entra ID. - [Drilldown](https://docs.bsure.io/v1/user-guides/devices/drilldown.md): Analyze devices in Microsoft Entra ID with customizable focus areas for flexible insights. - [Share the Power BI App](https://docs.bsure.io/v1/user-guides/share-the-power-bi-app.md): This guide describes how you can share the Bsure Insights Power Bi App within your organization or externally. - [Share App only](https://docs.bsure.io/v1/user-guides/share-the-power-bi-app/share-app-only.md): This is the method we recommend using when you share Bsure Insights with others in your organization. - [Give Access to the Power BI Workspace](https://docs.bsure.io/v1/user-guides/share-the-power-bi-app/give-access-to-the-power-bi-workspace.md): Giving access to the workspace where Bsure Insights is installed is another option. - [Share the Storage Account Access Key](https://docs.bsure.io/v1/user-guides/share-the-power-bi-app/share-the-storage-account-access-key.md): This method is not recommended. - [Share with External Users](https://docs.bsure.io/v1/user-guides/share-the-power-bi-app/share-with-external-users.md): You can share the Power BI app with external users (guests) in your Azure Active Directory. - [Update Power BI App](https://docs.bsure.io/v1/user-guides/update-power-bi-app.md): We will release quite frequent updates to the Power BI template app based on customer feedback or general improvements. You will need to update your version follow this instruction - [Glossary](https://docs.bsure.io/v1/user-guides/glossary.md) - [Pricing](https://docs.bsure.io/v1/pricing-and-billing/pricing.md): Description of how standard billing works in Bsure Insights. - [Billing](https://docs.bsure.io/v1/pricing-and-billing/billing.md) - [Support](https://docs.bsure.io/v1/support/support.md) - [Frequently Asked Questions](https://docs.bsure.io/v1/support/frequently-asked-questions.md): Common questions and answers - [Troubleshooting](https://docs.bsure.io/v1/support/troubleshooting.md) - [Release Notes](https://docs.bsure.io/v1/support/release-notes.md) - [New features](https://docs.bsure.io/v1/support/new-features.md): Bsure are continously developing new functionalities - [User purpose property](https://docs.bsure.io/v1/support/new-features/user-purpose-property.md): The purpose of the mailbox. Differentiates a mailbox for a single user from a shared mailbox and equipment mailbox in Exchange Online. Possible values are: user, linked, shared, room, equipment, other - [Partners](https://docs.bsure.io/v1/partners.md): A few tips to ease governance when using the app for multiple customers. - [Partner sell an offering including the app to the customers](https://docs.bsure.io/v1/partners/partner-sell-an-offering-including-the-app-to-the-customers.md): Value add service like advices and projects based on insights given by Bsure Insights - [Customer have a strict data protection regime](https://docs.bsure.io/v1/partners/customer-have-a-strict-data-protection-regime.md): If customer don't want to export data to partner environment - [Partner uses the app without customer knowledge](https://docs.bsure.io/v1/partners/partner-uses-the-app-without-customer-knowledge.md) - [General considerations](https://docs.bsure.io/v1/partners/general-considerations.md): This section will elaborate over the topic responsibility in Entra ID - [Recommended actions](https://docs.bsure.io/v1/recommended-actions/recommended-actions.md) - [Review Entra ID role assignments and create a strategy to offer such roles](https://docs.bsure.io/v1/recommended-actions/recommended-actions/review-entra-id-role-assignments-and-create-a-strategy-to-offer-such-roles.md): Review all privileged accounts and remove any unnecessary permissions - [Review and remove all inactive or unwanted accounts](https://docs.bsure.io/v1/recommended-actions/recommended-actions/review-and-remove-all-inactive-or-unwanted-accounts.md): Reduce both security risk and license spend - [Bulk deletion of users in Entra ID](https://docs.bsure.io/v1/recommended-actions/recommended-actions/review-and-remove-all-inactive-or-unwanted-accounts/bulk-deletion-of-users-in-entra-id.md) - [Protect all users with MFA](https://docs.bsure.io/v1/recommended-actions/recommended-actions/protect-all-users-with-mfa.md): This is the starting point of securing your environment - [Review and clean up applications with excessive permissions](https://docs.bsure.io/v1/recommended-actions/recommended-actions/review-and-clean-up-applications-with-excessive-permissions.md) ## Version 2 - [Welcome](https://docs.bsure.io/welcome.md): Bsure Insights is a business app that gives organizations full visibility into their Microsoft Entra ID. - [Overview](https://docs.bsure.io/getting-started/overview.md): Learn how to install and set up Bsure Insights in your Azure environment. - [Installation Guide](https://docs.bsure.io/getting-started/installation-guide.md): Follow this step-by-step guide to install Bsure Insights from Azure Marketplace. - [Prerequisites](https://docs.bsure.io/getting-started/installation-guide/prerequisites.md): Review and prepare all necessary subscriptions, roles, and resources to ensure a smooth installation of Bsure Insights. - [Azure Marketplace](https://docs.bsure.io/getting-started/installation-guide/azure-marketplace.md): This step covers how to deploy Bsure Insights from the Azure Marketplace. - [First-run Config](https://docs.bsure.io/getting-started/installation-guide/first-run-config.md): After deployment, complete the first-run configuration to finish setting up Bsure Insights. - [Design Principles](https://docs.bsure.io/technical-description/design-principles.md): Why and how Bsure Insights differentiates from many other offerings. - [Azure Managed Application](https://docs.bsure.io/technical-description/azure-managed-application.md): Description of Bsure Insights Data Collector application. - [Permissions Required](https://docs.bsure.io/technical-description/permissions-required.md): by the Bsure Insights Data Collector Managed Application - [Security + Public SQL](https://docs.bsure.io/technical-description/security-+-public-sql.md) - [Public Endpoint and Azure SQL (Entra-only) Considerations](https://docs.bsure.io/technical-description/security-+-public-sql/public-endpoint-and-azure-sql-entra-only-considerations.md) - [Technical Architecture](https://docs.bsure.io/technical-description/technical-architecture.md) - [Dataflow and visibility](https://docs.bsure.io/technical-description/dataflow-and-visibility.md) - [Overview](https://docs.bsure.io/user-guides/overview.md): Overview of the dashboards and reports in Bsure Insights, and how to use them in practice. - [Impact Dashboard](https://docs.bsure.io/user-guides/impact-dashboard.md) - [KPI Dashboard](https://docs.bsure.io/user-guides/impact-dashboard/kpi-dashboard.md) - [My Team](https://docs.bsure.io/user-guides/impact-dashboard/my-team.md) - [My Organization](https://docs.bsure.io/user-guides/impact-dashboard/my-organization.md) - [Application Owner](https://docs.bsure.io/user-guides/impact-dashboard/application-owner.md) - [AI Chat](https://docs.bsure.io/user-guides/ai-chat.md): Connect your organisation's OpenAI API key to enable AI Chat, and understand what data is shared with OpenAI. - [Users](https://docs.bsure.io/user-guides/users.md) - [Dashboard](https://docs.bsure.io/user-guides/users/dashboard.md): The Users Dashboard has two parts. Tiles showing your tenant's users - types and state. And a user data quality section showing status over time for some of the most commonly used user properties. - [Members](https://docs.bsure.io/user-guides/users/members.md): Report showing active, inactive and disabled member users. Entra ID Member accounts are all user accounts controlled and owned by your Entra ID. Your internal users. - [Guests](https://docs.bsure.io/user-guides/users/guests.md): Report showing active and inactive guest users. Entra ID guest accounts are external user accounts invited to your tenant/EntraID where they typically have access to Teams or Sharepoint sites. - [Data Quality](https://docs.bsure.io/user-guides/users/data-quality.md): Use this report to get the insights you need to improve your users data quality - [Properties](https://docs.bsure.io/user-guides/users/properties.md): This pages offers insights into more user properties than users main dashboard - [Sign-in Map](https://docs.bsure.io/user-guides/users/sign-in-map.md): Simply a world map showing which countries your member users have successfully signed in from the last 14 days. - [Sign-in Locations](https://docs.bsure.io/user-guides/users/sign-in-locations.md): Showing users successful sign-in locations for selected sign-in period - [Drilldown](https://docs.bsure.io/user-guides/users/drilldown.md): In this report we combine the information from the previous reports and give you the chance to drill down on all member and guest users statuses. - [Microsoft Licenses](https://docs.bsure.io/user-guides/microsoft-licenses.md): We've created subpages per report with explanations and short videos to help you navigate and understand the different reports under the Licenses section. - [Cost Dashboard](https://docs.bsure.io/user-guides/microsoft-licenses/cost-dashboard.md) - [Licenses Overview](https://docs.bsure.io/user-guides/microsoft-licenses/licenses-overview.md) - [Subscription Overview](https://docs.bsure.io/user-guides/microsoft-licenses/subscription-overview.md) - [Inactive and Disabled Users](https://docs.bsure.io/user-guides/microsoft-licenses/inactive-and-disabled-users.md) - [Overlapping licenses](https://docs.bsure.io/user-guides/microsoft-licenses/overlapping-licenses.md) - [Cost Allocation](https://docs.bsure.io/user-guides/microsoft-licenses/cost-allocation.md) - [Recommendations](https://docs.bsure.io/user-guides/microsoft-licenses/recommendations.md) - [Covered licenses for recommendations](https://docs.bsure.io/user-guides/microsoft-licenses/recommendations/covered-licenses-for-recommendations.md): Bsure analyses the usage of these specific licenses to generate cost-saving recommendations. - [Drilldown](https://docs.bsure.io/user-guides/microsoft-licenses/drilldown.md) - [License History](https://docs.bsure.io/user-guides/microsoft-licenses/license-history.md) - [Price Settings](https://docs.bsure.io/user-guides/microsoft-licenses/price-settings.md) - [Applications](https://docs.bsure.io/user-guides/applications.md): The reports under application will give you insight into your Entra ID Enterprise applications. - [Usage](https://docs.bsure.io/user-guides/applications/usage.md): Applications showing in this report consume applications, data and other resources your end-users will have to authenticate by using their Entra ID credentials - [Cost](https://docs.bsure.io/user-guides/applications/cost.md) - [Sign-in Locations](https://docs.bsure.io/user-guides/applications/sign-in-locations.md): The sign-in locations reports will give you insights into from where your users consume your Entra ID applications - [Successful sign-ins from blocked countries?](https://docs.bsure.io/user-guides/applications/sign-in-locations/successful-sign-ins-from-blocked-countries.md) - [Credential Expiry](https://docs.bsure.io/user-guides/applications/credential-expiry.md) - [Unused Applications](https://docs.bsure.io/user-guides/applications/unused-applications.md) - [Drilldown](https://docs.bsure.io/user-guides/applications/drilldown.md): Give you an overview of all your appllications in Entra ID their related sign-in events - [Application Overview](https://docs.bsure.io/user-guides/applications/application-overview.md): Give you an overview of all your appllications in Entra ID their related sign-in events - [Groups](https://docs.bsure.io/user-guides/groups.md): This page gives you the opportunity to see members in one or more Entra ID groups, and by giving a cost to a group it makes it easy to allocate costs. - [Security](https://docs.bsure.io/user-guides/security.md): This report section will bring insights into Entra ID role assignments, status on MFA and sign-in related content, all in an identity related context - [Dashboard](https://docs.bsure.io/user-guides/security/dashboard.md): The Security Dashboard has two parts. The upper part shows you key security related content, while the lower part has a sign-in map displaying where your users sign in from. - [Authentiation Methods](https://docs.bsure.io/user-guides/security/authentiation-methods.md) - [Entra ID Roles](https://docs.bsure.io/user-guides/security/entra-id-roles.md) - [Service Principals](https://docs.bsure.io/user-guides/security/service-principals.md): Apps or Service Principals should be considered as a user account and should be monitored closely - [Devices](https://docs.bsure.io/user-guides/devices.md): Reports on Devices from Entra ID - [Windows Dashboard](https://docs.bsure.io/user-guides/devices/windows-dashboard.md): View and manage Windows devices in Microsoft Entra ID with metrics on activity, security, and management status. - [Windows Inactive Devices](https://docs.bsure.io/user-guides/devices/windows-inactive-devices.md): View inactive Windows devices in Microsoft Entra ID with priority details for removal. - [Windows OS](https://docs.bsure.io/user-guides/devices/windows-os.md): Identify devices with out-of-support Windows versions in Microsoft Entra ID. - [Windows Management](https://docs.bsure.io/user-guides/devices/windows-management.md): Assess management status of Windows devices in Microsoft Entra ID to prioritize enrollment. - [Devices per Person](https://docs.bsure.io/user-guides/devices/devices-per-person.md): Analyze the number of devices per user in Microsoft Entra ID. - [Drilldown](https://docs.bsure.io/user-guides/devices/drilldown.md): Analyze devices in Microsoft Entra ID with customizable focus areas for flexible insights. - [Intune Drilldown](https://docs.bsure.io/user-guides/devices/intune-drilldown.md): If You use Intune as deployment system, this report will give you information on all devices. - [System Health](https://docs.bsure.io/user-guides/system-health.md) - [Settings](https://docs.bsure.io/user-guides/settings.md) - [System](https://docs.bsure.io/user-guides/settings/system.md) - [AI Recommender](https://docs.bsure.io/user-guides/settings/system/ai-recommender.md) - [Multi-tenancy](https://docs.bsure.io/user-guides/settings/system/multi-tenancy.md) - [Recreate Workspace](https://docs.bsure.io/user-guides/settings/system/recreate-workspace.md) - [Retention Time](https://docs.bsure.io/user-guides/settings/system/retention-time.md) - [Configuration](https://docs.bsure.io/user-guides/settings/configuration.md) - [Subscriptions](https://docs.bsure.io/user-guides/settings/configuration/subscriptions.md) - [Users Management](https://docs.bsure.io/user-guides/settings/configuration/users-management.md) - [Organization](https://docs.bsure.io/user-guides/settings/configuration/organization.md) - [Groups](https://docs.bsure.io/user-guides/settings/configuration/groups.md) - [Applications](https://docs.bsure.io/user-guides/settings/configuration/applications.md) - [Customer Settings](https://docs.bsure.io/user-guides/customer-settings.md) - [Subscriptions](https://docs.bsure.io/user-guides/customer-settings/subscriptions.md): By default the prices in our app are standard Microsoft list prices in USD. These prices will not be accurate for many organisations. This page will show you how you can add your own prices! - [Applications](https://docs.bsure.io/user-guides/customer-settings/applications.md): To add applications you want to monitor in the Application reports and/or distribute to Application Owners - follow this guide - [Groups](https://docs.bsure.io/user-guides/customer-settings/groups.md): Use this guide to configure whats displayed in the Groups report - [User Management](https://docs.bsure.io/user-guides/customer-settings/user-management.md): Here you add users to Bsure Insights. After adding a new user, please provide the url new user and they will get instant access. More granular access possibilities in under development. - [System status page](https://docs.bsure.io/user-guides/customer-settings/system-status-page.md) - [Glossary](https://docs.bsure.io/user-guides/glossary.md) - [Support](https://docs.bsure.io/support/support.md) - [Frequently Asked Questions](https://docs.bsure.io/support/frequently-asked-questions.md): Common questions and answers - [Device Code Flow in the Bsure Installation Process](https://docs.bsure.io/support/frequently-asked-questions/device-code-flow-in-the-bsure-installation-process.md): Overview of Device Code Flow in Bsure installation, with uses, risks, and best practices for secure access in headless systems. - [Grant new permissions](https://docs.bsure.io/support/frequently-asked-questions/grant-new-permissions.md) - [Troubleshooting](https://docs.bsure.io/support/troubleshooting.md) - [Migration](https://docs.bsure.io/support/migration.md): This page guides existing Bsure Insights customers through migrating their data to version 2. It outlines the requirements and steps needed to securely transfer existing data. - [Release Notes](https://docs.bsure.io/support/release-notes.md) - [Recommended actions](https://docs.bsure.io/recommended-actions/recommended-actions.md) - [Review Entra ID role assignments and create a strategy to offer such roles](https://docs.bsure.io/recommended-actions/recommended-actions/review-entra-id-role-assignments-and-create-a-strategy-to-offer-such-roles.md): Review all privileged accounts and remove any unnecessary permissions - [Review and remove all inactive or unwanted accounts](https://docs.bsure.io/recommended-actions/recommended-actions/review-and-remove-all-inactive-or-unwanted-accounts.md): Reduce both security risk and license spend - [Bulk deletion of users in Entra ID](https://docs.bsure.io/recommended-actions/recommended-actions/review-and-remove-all-inactive-or-unwanted-accounts/bulk-deletion-of-users-in-entra-id.md) - [Protect all users with MFA](https://docs.bsure.io/recommended-actions/recommended-actions/protect-all-users-with-mfa.md): This is the starting point of securing your environment - [Review and clean up applications with excessive permissions](https://docs.bsure.io/recommended-actions/recommended-actions/review-and-clean-up-applications-with-excessive-permissions.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://docs.bsure.io/welcome.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.