> ## Documentation Index > Fetch the complete documentation index at: https://docs.petrasecurity.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Changelog ## Version History for Conditional Access Policies You can now see the version history of your Conditional Access Policies in Petra. Use this when analyzing how the policy's scope has changed over time regarding users, locations, or apps in scope. You can find this on a Policy's page, under the “History” tab where you can see each time a policy has changed and the exact difference between two versions. Version History for Conditional Access Policies - View Details Version History for Conditional Access Policies - Copy Details ## Analyze Report-only Conditional Access Policies and User Groups You can now analyze Report-only Conditional Access Policies and User Groups in Petra. Use this to evaluate the potential impact of new Policies and handle exceptions for certain users. The Policy page now shows which logins “would be blocked” and allows you to click into a User Group to view or edit its members. Analyze Report-only Conditional Access Policies and User Groups ## View Conditional Access Policies You can now view your Conditional Access Policies (CAPs) across all your tenants in Petra. Use this to get a view of the status, configuration, and impact of each policy. This is available on the Policies page. Each policy can be clicked into to dive deeper into its scope and sign-ins blocked by the policy. View Conditional Access Policies ## View Which Conditional Access Policy Blocked Sign-In You can now see which Conditional Access Policy (CAP) caused a sign-in to be blocked. Use this to see exactly which CAPs were evaluated for a sign-in and what triggered the blocking policy. This is available in the Petra Activity viewer, by clicking the Information icon which will open a drawer of the CAPs on the tenant and the corresponding results. View Which Conditional Access Policy Blocked Sign-In ## Ad Hoc Cross-Tenant Phish Removal We've seen a big rise in sophisticated phishing campaigns, so we've expanded Cross-Tenant Phish Revocation and made it accessible even outside of an incident. You can now look for a malicious Subject or Sender, and remove all emails from them, before an incident occurs and across all tenants with one click. To see it in action, go to the Admin pane, click Emails, and click Cross-Tenant Phish Removal. Ad Hoc Cross-Tenant Phish Removal ## Domain Spoofing Scan Given the recent uptick in Direct Send attacks, this week we shipped a new [Domain Spoofing Scan](/investigating/domain-spoofing). Use this when a client asks about an email they received from "themself." This scan includes suggested steps to harden the environment and a new client-ready [Domain Spoofing Report](/reporting/domain-spoofing-report) to reinforce the value you're providing. You can run a Domain Spoofing Scan by going to the tenant page and selecting "Domain Spoofing" at the top. Domain Spoofing Scan Domain Spoofing Report ## User Activity Report We shipped a new [User Activity Report](/reporting/user-activity-report). This report highlights a user's sensitive M365 activity, such as accessing financial documents or sending emails to external contacts. This report is helpful for ad hoc investigations into a specific user - for example, summarizing the activity of an employee who recently quit. You can generate these reports by going to a tenant, scrolling down to the Activity logs section, and clicking the "User Activity" button. User Activity Report User Activity Report User Activity Report ## Sales Role We added a new [Sales](/settings/member-roles-and-permissions#sales) role for your team. This lets your sales team sell Petra to your customers and prospects without giving them total access to your other tenants. Sales Role ## Attack Method in Incident Report We now show how a user's credentials were stolen leading to the account compromise in the Incident Report's summary section. This helps you tell a clear story of what happened to your clients as their trusted security advisor, especially when showcasing retrospective compromises to sell Petra monitoring. Attack Method in Incident Report ## Get onboarded tenants in the API We added a new [API endpoint](/api-reference/endpoints/get-tenants) to get your tenants on Petra. > **Note:** You can get an API key by going to [Settings -> API](https://app.petrasecurity.com/settings/api-keys). Get onboarded tenants in the API ## Get failed attacks in the API We added a new [API endpoint](/api-reference/endpoints/get-failed-attacks) to get failed attack data. This allows you to build your own custom reports with the same data that powers our white-labeled monthly [Tenant Security Reports](/reporting/tenant-report). > **Note:** You can get an API key by going to [Settings -> API](https://app.petrasecurity.com/settings/api-keys). Get failed attacks in the API ## Cross-Tenant Phish Revocation Petra now searches across all of your tenants to find and revoke the phish before more users fall for it. We often see the same phishing campaign hit multiple tenants. Now when the first compromise is detected, it's kicked out of everyone's mailbox. This means every one of your clients benefits from the threat intel you get from any compromise. You'll find this below the tagged phish in an incident's Remediation Actions panel. Cross-Tenant Phish Revocation ## Get incidents in the API We added a new [API endpoint](/api-reference/endpoints/get-incidents) to get Petra incidents. This allows you to build workflows and automations. > **Note:** You can get an API key by going to [Settings -> API](https://app.petrasecurity.com/settings/api-keys). Get incidents in the API ## White Labeled Example Reports The Marketing Hub now offers these white-labeled example reports: * Incident Report * Tenant Report * Scan Report These white-labeled example reports are built to help you sell M365 monitoring to your customer base and prospective customers. > **Note:** You can set your logo in Branding settings [here](https://app.petrasecurity.com/settings/branding). White Labeled Example Reports ## Attacker Retains Password Petra now surfaces past compromises in which the attacker's session was revoked, but the account password was not reset. Even if an attacker was locked out of an account, they can get back in if the password was last set prior to the compromise. Attacker Retains Password ## View Tenant Apps You can now view a tenant's installed applications. Go to the tenant's page, scroll down to Admin, and select Apps. View Tenant Apps ## Dwell Time Tag The new "Dwell Time" gives you digestible info at a glance after onboarding new clients who have past compromises before Petra was installed. Dwell Time Tag ## Update GDAP Relationships from Partner Center You can now push new GDAP relationships to your tenants from our Partner Center portal. This allows you to more easily onboard tenants to Petra without manually setting up relationships in Microsoft Partner Center. Update GDAP Relationships from Partner Center ## Partner Center Now you can connect Microsoft Partner Center to save time by one-click adding new tenants and bulk-updating permissions to take advantage of new Petra features. Link it by clicking “Add Tenants” button in the nav bar or by [clicking here](https://app.petrasecurity.com/portal). Partner Center ## Billing Role & Granular Member Permissions We've given you more control around who can do what in Petra: * Invite your finance team under the new **Billing Only** role to give them access limited to viewing the billing page and editing payment methods. * Members can now be configured with these new permissions: * **Can onboard and modify tenants** * **Can view sensitive tenants** Billing Role & Granular Member Permissions Billing Only Portal ## PSA Billing Integrations Petra now syncs billing data directly to your PSA. Billing integrations are available for **ConnectWise**, **Autotask**, and **Halo PSA**. Configure billing sync in [Settings](https://app.petrasecurity.com/settings) and follow the updated setup guides: * [ConnectWise PSA](/integrations/connectwise) * [Autotask PSA](/integrations/autotask) * [Halo PSA](/integrations/halo) Each integration guide now includes a dedicated **Billing** section with the additional permissions and configuration required for billing sync. ## Itemized Billing Report The Billing Excel sheet now includes per-tenant tabs that break down each billable user and their prorated cost based on when they were added to Petra. You can download this sheet in [billing settings](https://app.petrasecurity.com/settings/usage). > **Note:** Itemized billing data is only available since January 2026. Prior reports only include the Summary page. Itemized Billing Report ## Custom Webhooks **Custom Webhooks** let you automatically send Petra incident alerts to any external service, like Zapier or other automation tools, whenever we detect a compromise. You can customize the HTTP method, headers, and JSON payload to fit your workflow. Find it in [Settings](https://app.petrasecurity.com/settings). Custom Webhooks ## The Autopsy Report A **Petra Autopsy** investigates the last 6 months of a tenant's activity to uncover attacks and compile forensics. Our new white-labeled **Autopsy Report** transforms 6 months of tenant forensics into a sales-ready document for your client meetings. We hope you use it to demonstrate real security gaps your clients didn't know existed and make deploying Petra a no-brainer for your client. What it reveals: > **Note:** New MSPs receive an Autopsy with their Petra trial. Cover Page Confirmed Compromises Attacker Found Late ## Redacted Incident PDF **Redacted Incident PDFs** help you demonstrate real compromises in sales pitches while protecting client data. To download this report, navigate to an incident in the Petra dashboard, click **"Download Report"**, and select **"Redacted PDF Report"** in the dropdown. > **Reminder:** When sharing your screen to showcase incidents to other clients, you can redact PII by clicking the **Anonymize** button on the top right of the Incident page. Redacted Incident PDFs Download Redacted Incident PDF ## Analyst Summary in the Incidents List The list of previous incidents now includes a detailed **Analyst Summary** section, making it easier to distinguish between incidents. This helps you select a more compelling and diverse set of previous compromises when engaging prospective clients. Analyst Summary in the Incidents List ## Incident Summary Now the incident page has an “Incident Summary” section which succinctly highlights the most important details of the attack. This enables account managers and salespeople to tell a clear story of the attack, rather than overwhelm the client or prospect with information. Incident Summary ## Tenant Onboarding Tracker When adding new tenants, you'll now see a streamlined onboarding tracker that displays real-time status updates. This gives you clearer visibility into each tenant's onboarding progress and lets you anticipate exactly when they'll be fully set up. Tenant Onboarding Tracker ## Tenant Report Redesign The Tenant Report has been redesigned! We've listened to your feedback and added the most requested features and improvements. Go check out the new [Report Generator](https://app.petrasecurity.com/report-generator). > **Reminder:** You can configure automatic sending of Tenant Reports at the end of every month by going to [Settings](https://app.petrasecurity.com/settings) and adding your organization's emails in the **"Automated Monthly Reports (Internal emails only)"** section. Tenant Report Redesign ## Anonymize Incidents You can now anonymize an incident to help you show any quickly caught incident as a victory lap, and any Autopsy as a cautionary tale. Go to an incident page, click the Anonymize button on the top right, and select which information should be hidden. Anonymize Incidents ## The Marketing Hub The Marketing Hub offers a collection of documents, slides, and waivers that are meant to help you share the value of Petra ITDR with your clients. Navigate here by clicking the "Marketing" tab in the navbar or by [clicking here](https://app.petrasecurity.com/marketing). Today, the Marketing Hub offers the following resources: Marketing Hub ## View Tenant-Wide MFA Enforcement You can now see whether MFA is enforced for every user in a tenant directly from the tenant homepage. Both legacy MFA methods and enforcement through Conditional Access Policies are shown. View Tenant-Wide MFA Enforcement ## SOC Incident Highlighting Our SOC highlights especially relevant or noteworthy incidents for your clients with a star. This helps you quickly spot the most important incidents to showcase, even when Petra detects many incidents. Read-Only Members ## Read-Only Members You can now assign read-only status to members within your organization. Read-only members are restricted to viewing content and cannot perform any actions in the app. By default, all existing users are not set to read-only, and this setting is also not set for new members unless specified. You can designate a member as read-only either when inviting them or by updating their permissions at any time in the Settings -> Access page. Read-Only Members ## Delete Malicious Inbox Rules You can now delete inbox rules from the Threat Remediation Actions panel. Delete Inbox Rules ## New Remediation Actions Panel The Threat Remediation Actions panel has been updated with a clearer layout, making it easier to find and perform the actions you need. New Remediation Actions Panel ## International Text Alerts International text alerts are now supported for UK (+44) numbers. When an incident occurs, we can send SMS notifications to members of your organization in the US and the UK. To use this feature, go to "Settings" > "Notifications" > "Texts" and choose the appropriate country code for each recipient. International Text Alerts ## Threat Remediation Report Includes Phish Improved the Threat Remediation Report to include the phish that led to the compromise. Phish in Threat Remediation Report ## Rogue Apps & Remnant Inbox Rule Incident Redesign We redesigned the Rogue Apps and Remnant Inbox Rule incidents to show all available context and remediation options. ## Historical Usage Data You can now select a past month to see historical usage data. Historical Usage Data ## Full Incidents in Tenant Report Appendix When a Tenant Report includes an Incident, the complete Incident Report will now be added to the Appendix. Full Incident in Tenant Report ## Tenant Report Bug Fixes Thanks to some helpful feedback from customers, we've fixed a few bugs in the Tenant Report. * Improved readability of the Executive Summary page * Fixed bug for particularly long usernames in the failed attacks section ## Tenant Report Redesign The Tenant Report has been redesigned! Go check out the new [Report Generator](https://app.petrasecurity.com/report-generator). Tenant Report Redesign ## Tenant Report Configuration Tenant Report Configuration * High Value Accounts: tag accounts like CEO, CFO, billing manager to see greater detail on who is targeting them. * Hidden Accounts: hide accounts that you want to be excluded from the report, like your own admin account or testing accounts. * Hidden Incidents: hide incidents that you want to be excluded from the report, like those that you've already surfaced to the client. * Other Options: customize which sections are included in the report. ## Automate Sending Monthly Tenant Reports Now you can schedule sending security reports to your tenants and your organization at the end of every month. Directly to tenants: Go to a tenant's page, click the gear icon on the top right, and add their emails in the "Tenant-Specific Monthly Reports" section. These emails will receive a tenant-specific security report at the end of every month. Tenant-Specific Automated Security Reports To your organization: Go to settings and add internal emails in the "Automated Monthly Reports" section. These emails will receive a security report for every tenant at the end of every month. *Note: These emails will receive security reports for all of your tenants. We recommend that you only add emails within your organization.* Automated Monthly Reports ## Include User Licenses in Admin Panel and Excel Export Now you can see what licenses each user has in the admin panel and when you export user lists to Excel. This is useful for right-sizing spend for your clients. User Licenses ## Edit Tenant Name Now you can edit the name of a tenant. Edit Tenant Name ## Petra Automatically Enables Audit Logs Now when you onboard a tenant, Petra automatically enables audit logs if they were not already enabled. We all know the pain of trying to enable audit logs in Purview--it lags by hours and often takes several attempts. Now onboarding in Petra is the last step in setting up monitoring. Like everything else in Petra, this is available regardless of Microsoft license level. ## Improved Threat Remediation Report Timeline We updated the summary timeline at the bottom of the Threat Remediation Report to focus on the most important events in the incident--especially how you stopped it. Improved Threat Remediation Report Timeline ## SharePoint Malicious File Removal Attackers often upload new files to SharePoint to use as a phishing lure. Petra commonly uncovers these files in baselining when latent attackers are discovered. Now you can remove them from SharePoint from within Petra without opening Microsoft. SharePoint Malicious File Removal ## Tenant Logs Excel Export You can now export tenant logs to Excel. The export includes fully enriched metadata for Exchange, including email subjects, sender, recipients, and more. The export respects any filters you have applied in the viewer, so you can get, for example: * A specific user's activity across logins, Exchange, SharePoint, Teams, etc. * All activity across a tenant for a specific time period. * All sent emails across a tenant for a specific time period. Tenant Logs Excel Export Tenant Logs Excel Export ## Halo PSA Integration You can now link your Halo PSA account to Petra. Go to [Settings](https://app.petrasecurity.com/settings) to link your Halo PSA account. Follow this guide to integrate with Halo PSA: [Halo PSA Integration](/integrations/halo). ## Phish Search & Retraction Phish search and retraction now catches replies and forwards. It's surprisingly common for the recipient of a phish to forward it to coworkers. Now Petra finds all of those replies and forwards so we can retract those too. Phish Search & Retraction ## Excel Export for Usage by Tenant The usage page in settings now includes an option to export usage data by tenant to Excel. Excel Export for Usage by Tenant ## Beta of API Endpoint for Tenant Usage We launched a beta of an API endpoint for tenant usage. Contact us if you want to try it. Read more about it in the [API documentation](/api-reference/endpoints/get-usage). ## Email Search and Removal The admin panel now includes the ability to search for emails by subject, sender, and recipient, as well as the option to remove emails. Emails Admin ## Sensitive Tenants Sensitive Tenants are tenants that only admins have access to within Petra. This is useful for safeguarding access to certain tenants, such as the MSP's own tenant. Sensitive Tenants ## Better Phish Deletion Phish Deletion Options Phish deletion now includes both soft delete and hard delete. * Soft delete moves the email to the recoverable folder within deleted items (which users are much less likely to find than just the deleted folder). * Hard delete deletes the email from the mailbox. We aim for the remediation actions taken by Petra Response to be 1) effective and 2) reversible, so we will soft delete and leave the hard delete as an option for your analyst when they review the incident. If it turns out we were wrong, your analyst would instead click "Recover" to move the emails back to the inbox. ## Delegated Activity in the Activity Viewer Delegated Activity Now when one user acts on behalf of another, the activity viewer will display both the actor and the delegated mailbox. This is critical for understanding compromises involving delegated mailboxes and administrators who have permission to act on behalf of other users. ## Deep Links & Streamlined Sign In * Deep Links: Now if you open a link to a specific page (e.g. an incident link in a ticket), you'll be taken to that same page after you sign in. * Streamlined Sign In: We removed the organization selection step during sign in, reducing sign-in flow by 1 click in 99% of cases. ## Incident Forensics Countdown Microsoft logs are often delayed by a few minutes, which could cause the forensics in the Threat Remediation Report to change in the minutes after the incident. You can now see an estimated time for all of the forensics to be published by Microsoft and included in the Threat Remediation Report. Incident Forensics Countdown ## Improvements to Self-serve Tenant Management Self-serve Tenant Management You can now remove tenants at any time without talking to anyone. Go to [Settings > Usage](https://app.petrasecurity.com/settings/usage) to manage your tenants. ## Similar Phish Retraction Similar Phish Retraction Now you can quickly see who else received a similar phish and remove it from their inbox. This stops other employees from falling for the same phish. Highlights: * The 'Current Folder' column updates in realtime as you or the employee moves the email. * The 'Interactions' column opens the Email Interactions Panel which displays all read/moved/deleted/etc. interactions with the email. ## Edit Analyst Note for Reports Edit Analyst Note for Reports This week's release gives you the ability to edit the analyst note that appears in the Threat Remediation Report PDF. We also added formatting to the notes to accommodate timelines, highlighting critical info, etc. ## Added DKIM & Mailbox Permissions to Remediation Actions Panel Added DKIM & Mailbox Permissions to Remediation Actions Panel The Remediation Actions panel now includes attacker activity in DKIM configuration and mailbox permissions. This is important for understanding what the attacker did and how to undo it. ## White-label Portal & PDF Reports White-label Portal & PDF Reports You now have the ability to use your own branding in the Petra portal and reports. Now your logo is used in the nav bar and every report, which gives your external guests a consistent experience with your brand. ## Petra Autopsy: Incident Response for BECs Active vs Autopsy panel Introducing Petra Autopsy. We now have the capability to do find and compile forensics for compromises up to 6 months before onboarding. Now when a prospect or client needs incident response for a BEC, you can offer them a full forensic incident report and Excel export delivered within 24 hours. ## Improved White-label Threat Remediation Report Improved White-label Threat Remediation Report We redesigned the PDF export. Highlights: 1. New executive summary for quick read-through. 2. Attack duration and impact (crowd favorites in the portal) are now in the PDF. 3. More compact timeline of events table on the second page. ## Tenant-specific Access Tenant-specific access You can now invite members to a subset of your tenants in Petra. This is helpful for two use-cases: 1. Giving access to a client who needs to see the portal themselves. 2. Least-privilege access to a subset of tenants for an AE or technical team member. ## Revamped Attack Timeline Revamped Attack Timeline The new attack timeline shows all of the attacker’s activity over the course of an account compromise: from the initial phish -> successful logins -> sharepoint/exchange activity. Then, we can see Petra flagging that attacker’s activity, killing current sessions, and locking the account. Afterwards, we often see failed logins as the attacker bangs on the door. The new attack timeline sits at the bottom of the incident view, just beneath the Attack Impact panel. ## Attack Impact Attack Impact in continuous monitoring Attack Impact in an incident response case. What files/emails did the attacker touch? Usually, defenders have to dig through logs and powershell scripts to find the answer. Instead, we make it easy to see what an attacker did with *Attack Impact*. You can see exactly which emails and files the attacker read, modified, sent, or deleted. This is particularly helpful for identifying things like: 1. What emails did the attacker send? To whom? (Likely to laterally phish). 2. What files did the attacker modify? 3. What did the attacker delete? Just as importantly, Attack Impact helps you identify what the attacker did NOT read or interact with. For GDPR and HIPAA clients with disclosure requirements, this is a huge time and money saver. ## Tenant-wide Email Subject Search Filter emails by subject Super fast tenant-wide search. This is useful for a variety of forensics tasks, like tracking down an email that a user vaguely remembers or getting to the root of an email thread. When you want all of the emails in a thread, use "contains" without case sensitivity to include the "Re:" and "Fwd:" messages. When you want the root, use "equals." ## Phish Similarity Search Petra identifies emails similar to the known phish We see this all the time: after a successful phish, sometimes attackers will send similar emails to other users in the organization, hoping to phish them as well. If the first one worked, there's a pretty high chance others will too. After a user has been phished, and the phishing email has been identified by Petra, Petra shows you similar emails to the phish email. In a future update, you'll be able to one-click remove these emails from mailboxes in your tenant. ## Email Interactions Panel See who has interacted with an email Via the Email Interactions Panel, you can see who has read/forwarded/replied/etc. an email. This is helpful after a user has gotten phished to see who all is in the blast radius––i.e. who all has read/clicked/replied to the phish email. In a future update, you'll be able to one-click remove all identified similar phishing emails from your environment. ### Other updates this week: ## Company IP Detection Company IP detection showing a shared IP address IP geolocation can be misleading. Just because a user logs in from a New York IP every day doesn't mean they're actually in New York. It could be the company's shared tunnel or office VPN that everyone uses. **Petra now tells you when a login is coming from a shared company IP**. Our detection engine already uses this signal to cut down on false impossible travel alerts, and now we're surfacing it in the portal so you have that context when investigating. ## Logging Received Emails 'Email Received' events are now processed in addition to the traditional operations logged in the Unified Audit Log. Now, you can see who has received an email before they interact with it at all. ## Disable Inbox Rules & App Registrations Remediate inbox rules and app registrations **You can now 1-click disable inbox rules and app registrations that the attacker added** when they had access. You'll also see audit logs that record when each action was taken, and by whom. The portal constantly syncs with the state from Microsoft, so if for some reason something was disabled or deleted directly in Microsoft, that would be reflected here too. ## Filter Auth Methods and Devices by username ## Export spotlighted investigations as PDF ## Phish Identification ## Autotask Integration ## Redesign tenant report ## Include inbox rule content in Attack Timeline ## Added Acme Corp demo tenant to the portal ## Data Center tagging in activity viewer ## Login stats sidebar ## Multi-select filters on logs ## Slack webhook integration ## Mail to UPN auto-resolution ## Make the entire app mobile-friendly ## Add filters to rare activity ## User page ## P1/P2 risk events ## Spotlighted investigations ## Report Generator ## Apply filters to log exports ## Add rare activity to tenant report ## New failed attack types: password spray and known malicious IP ## Apps, devices, auth methods, directory roles tables ## Filter by not equals ## Autocomplete some filters ## Share filter bar across all log sources ## Remediation readiness panel ## API for SIEM integration ## Users export ## Failed attacks ## Remediation controls ## Teams integration ## Third party app names ## ConnectWise integration ## Latent attacker search ## An Eventful Year