The Microsoft Defender for Office 365 Recommended Configuration Analyzer (ORCA)
ORCA is a report that you can run in your environment which can highlight known configuration issues and improvements which can impact your experience with Microsoft Defender for Office 365 (formerly Office 365 Advanced Threat Protection).
- Configuration Health Index
- Configuration in EOP which can impact MDO
- SafeLinks configuration
- SafeAttachments configuration
- Antiphish and antispoof policies.
The configuration health index is a weighted value representing your configuration. Not all configuration is considered and some configuration is weighted higher than others. The index is represented as a percentage. How the configuration impacts the configuration health index is shown next to the recommendation in the report below as a positive or negative number. The impact to your security posture is a large consideration factor when rating the configuration.
You will need the Exchange Online Management module first.
- Exchange Online Management module is available via the PowerShell gallery:
Install for current user Install-Module -Name ExchangeOnlineManagement -Scope:CurrentUser
Install for all users Install-Module -Name ExchangeOnlineManagement
Then, you'll need ORCA. We publish ORCA via the PowerShell gallery to make it easy and accessible for everyone.
To install, run PowerShell as an administrator and run the following command
Install-Module ORCA
Connect to Exchange Online and then run
Get-ORCAReport
To Run ORCA you need to have necessary permissions. The "View-Only Configuration" Exchange Online role is needed to run the tool.
For example you can use the following:
- Global Reader - Azure Active Directory role
- View-Only Organization Management - built in role group in Exchange Online
It's that simple! At the conclusion, your default browser will open with a report detailing the recommendations.
Log an Issue via the Issues tab in GitHub!
Yes! We will push new rule definitions out by releasing a new version. Every time you run Get-ORCAReport, we check to see if you have the latest version and if not; we will prompt you to update via the console and also in the report.
There is definitely a lot of value in running your Office 365 environment with Microsoft Defender for Office 365, for instance:
- Automatic incident response capabilities
- Attack simulation capabilities
- Behavioural analysis (sandboxing) of malware
- Time of click protection for malicious URLs
- Advanced anti-phishing controls
However, there are also some checks within ORCA that are not Microsoft Defender for Office 365 specific which can impact the operation of Microsoft Defender for Office 365 and security within an Office 365 tenant. ORCA can still be ran on tenants without Microsoft Defender for Office 365, albeit with reduced qty. of checks..
If you have permissions to another organization, pass the -DelegatedOrganization flag to connect to it. If you are already connected to another organization, we will first disconnect you before connecting to the other org.
We now support outputting to different formats (which can be useful for different purposes, such as tracking trending over time).
If the following isn't good enough for your purpose, don't despair, the output is fully modular. You can create your own output type by creating your own "output-name.ps1" file in the outputs directory. You'll need to create a class that extends the "ORCAOutput" class, and you'll need to implement an override for the RunOutput function. Easiest way is just to copy one of the existing ps1's to make your own (if you need to, that is..)
To run specifying an alternative output module, instead of using the Get-ORCAReport command, use the Invoke-ORCA command.
Example outputting to JSON
Invoke-ORCA -Output JSON
HTML is the output format that you'll get when you run Get-ORCAReport.
Example 1 - this is the equivalent of running Get-ORCAReport:
Invoke-ORCA -Output HTML
Example 2 - output to HTML but don't load the HTML
Invoke-ORCA -Output HTML -OutputOptions @{HTML=@{DisplayReport=$False}}
- DisplayReport, Optional, Boolean - load the report at the conclusion of running ORCA
- OutputDirectory, Optional, String - path to store the outputted html file, default is an appdata directory created automatically
- EmbedConfiguration, Optional, Boolean - allows you to embed your configuration in to the HTML file for easy sharing/snapshotting
File with JSON formatted results.
Example:
Invoke-ORCA -Output JSON
Output flatted in to two CSV files, one for an overview, one for detail on each config item.
Example:
Invoke-ORCA -Output CSV
- OutputDirectory, Optional, String - path to store the outputted json file, default is an appdata directory created automatically
Useful for storing your results, trending, or displaying in a interface (PowerBI example coming soon)
We require the unofficial CosmosDB module 'CosmosDB' for this. You can find this on the PowerShell Gallery
The key that we will use is 'id' in the CosmosDB. Make sure you specify this as your key when you create your collection.
Example - To output in to MyCosmosAccount database MyCosmosDB, the default collection will be ORCA
Invoke-ORCA -Output Cosmos -OutputOptions @{Cosmos=@{Account='MyCosmosAccount';Database='MyCosmosDB';Key='YourKeyvalue'}}
Example - To output in to MyCosmosAccount database MyCosmosDB, in to a collection called MyORCA
Invoke-ORCA -Output Cosmos -OutputOptions @{Cosmos=@{Account='MyCosmosAccount';Database='MyCosmosDB';Key='YourKeyvalue==';Collection='MyORCA'}}
- Account, Required, String - The Cosmos DB account that the database is found in
- Database, Required, String - The Cosmos DB name
- Key, Required, String - One of the keys for this Cosmos DB account
- Collection, Optional, String - The collection to output in to, by default this will be ORCA
To embed configuration in to the ORCA HTML output use the EmbedConfiguration switch to Get-ORCAReport, example Get-ORCAReport -EmbedConfiguration or add EmbedConfiguration to Invoke ORCA if running manually Invoke-ORCA -Output HTML -OutputOptions @{HTML=@{EmbedConfiguration=$True}}
When embedding your configuration to the HTML file, note that the HTML file becomes confidential. It may contain sensitive information at this point, and only share it with trusted parties.
If you have a HTML ORCA report (generated after version 2.3) that has embedded configuration, run:
Get-ORCAReportEmbeddedConfig -File filename.html to read the configuration in to a hashtable.
Store that in to a PowerShell variable by running $Config = Get-ORCAReportEmbeddedConfig -File filename.html
Explore the data available by outputting the $Config variable, or enter a specific bit of config by using the key, e.g for looking at InboundConnectors, $Config['InboundConnector']
Version 2.3 introduces charting and historical information as a concept in to ORCA. When running ORCA an ORCA report, ORCA will look for previous reports in the same Output Directory for the same tenant. We will show a chart of how the recommendations progress between versions.
ORCA is developed by Product Managers at Microsoft, however, is not an official Microsoft utility.
For official, in-product configuration analysis, use the MDO config analyzer.
We're completely open source and as matter of fact we also use some open source components in our report.
We use the following components in order to generate the report
- Bootstrap, MIT License - https://getbootstrap.com/docs/4.0/about/license/
The MIT License (MIT)
Copyright (c) 2011-2021 Twitter, Inc. Copyright (c) 2011-2021 The Bootstrap Authors
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- Fontawesome, CC BY 4.0 License - https://fontawesome.com/license/free
- ChartJS, MIT License - https://github.com/chartjs/Chart.js
The MIT License (MIT)
Copyright (c) 2014-2022 Chart.js Contributors
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- MomentJS, MIT License - https://github.com/moment/moment/
Copyright (c) JS Foundation and other contributors
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
