HAWK

1.2.5

The Hawk module has been designed to ease the burden on O365 administrators who are performing a forensic analysis in their organization.  It accelerates the gathering of data from multiple sources in the service.

It does NOT take the place of a human reviewing the data generated and is simply here to make data gathering easier.

Hawk has moved to GitHub and is a
The Hawk module has been designed to ease the burden on O365 administrators who are performing a forensic analysis in their organization.  It accelerates the gathering of data from multiple sources in the service.

It does NOT take the place of a human reviewing the data generated and is simply here to make data gathering easier.

Hawk has moved to GitHub and is availble for all to contribute.
https://github.com/Canthv0/hawk
Show more

Minimum PowerShell version

5.0

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name HAWK -RequiredVersion 1.2.5

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name HAWK -Version 1.2.5

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) 2017 matbyrd@microsoft.com. All rights reserved.

Package Details

Author(s)

  • hawk_feedback@microsoft.com

Tags

O365 Security Audit Breach Investigation Exchange EXO Compliance Logon

Functions

Get-HawkTenantAzureAuthenticationLogs Get-HawkTenantConfiguration Get-HawkTenantEDiscoveryConfiguration Get-HawkTenantInboxRules Get-HawkTenantOauthConsentGrants Get-HawkTenantRBACChanges Get-HawkUserAuthHistory Get-HawkUserConfiguration Get-HawkUserEmailForwarding Get-HawkUserInboxRule Get-HawkUserMailboxAuditing Initialize-HawkGlobalObject Search-HawkTenantActivityByIP Search-HawkTenantEXOAuditLog Show-HawkHelp Start-HawkTenantInvestigation Start-HawkUserInvestigation Update-HawkModule Get-HawkUserAdminAudit

Dependencies

This module has no dependencies.

Release Notes


       1.2.5 - Fixed issue with search-adminaudit log where in one instance it was only searching 14 days
       1.2.5 - Updated output files for Get-HawkUserAuthHistory to be more clear about what they contain
       1.2.5 - Updated output for Get-HawkUserAuthHistory so that it will always return all files
       1.2.4 - Updated with GitHub Link
       1.2.4 - Added Get-HawkUserAdminAudit to return all exo shell changes recorded in the admin audit log for a given user
       1.2.3 - Fixed issue where geoip lookups were failing
       1.2.3 - GeoIp lookups are now using http://api.ipstack.com/ users will need to provide their own API key due to 10k per month limit on free accounts
       1.2.3 - Introduced storing Hawk Data between sessions by storing in %localappdata%\hawk\hawk.json
       1.2.2 - Fixed issue where Get-HawkTenantAzureAuthenticationLogs was only retrieving 1000 results
       1.2.1 - Fixed issues with accepting input on -userprincipalname where it would better accept all three cases String,Array of Strings,Array of Objects
       1.2.1 - Fixed an issue with Get-HawkTenantInboxRules where it would fail if there was a space in the path to the module
       1.2.0 - Get-HawkTenantEXOAuditLog RunDate timezone was ambiguous.  It now outputs in UTC and calls that out.
       1.2.0 - Updated Description
       1.2.0 - Moved all exported function out of hawk.psm1 into seperate ps1 files. This should make things easier to manage / read.
       1.1.4 - Fixed issue where incorrect logging cmdlet was being called
       1.1.3 - Removed Compress-HawkData cmdlet
       1.1.3 - Update description, URL, and Icon
       1.1.2 - Fixed issue with using the wrong account to try and access the windows graph API
       1.1.1 - All files related to the tenenat are now put in the \Tenant directory
       1.1.1 - Reduced the number of text files generated as output
       1.1.1 - Updated Get-HawkTenantAzureAuthenticationLogs to use user credentials instead of APP credentials
       1.1.0 - New Cmdlet Get-HawkTenantAzureAuthenticationLogs will gather Azure AD Sign In logs if you have P1 or P2 license
       1.0.1 - Fixed issue with date range validation failing occasionally
       

FileList

  • Hawk.nuspec
  • Hawk.psd1
  • Hawk.psm1
  • LICENSE
  • Microsoft.IdentityModel.Clients.ActiveDirectory.dll
  • Microsoft.IdentityModel.Clients.ActiveDirectory.WindowsForms.dll
  • README.md
  • Start-RobustCloudCommand.ps1
  • System.Net.IPNetwork.dll
  • .git\COMMIT_EDITMSG
  • .git\config
  • .git\description
  • .git\FETCH_HEAD
  • .git\HEAD
  • .git\index
  • .git\ORIG_HEAD
  • .git\packed-refs
  • Tenant\Get-HawkTenantAzureAuthenticationLogs.ps1
  • Tenant\Get-HawkTenantConfiguration.ps1
  • Tenant\Get-HawkTenantEDiscoveryConfiguration.ps1
  • Tenant\Get-HawkTenantInboxRules.ps1
  • Tenant\Get-HawkTenantOauthConsentGrants.ps1
  • Tenant\Get-HawkTenantRbacChanges.ps1
  • Tenant\Search-HawkTenantActivityByIP.ps1
  • Tenant\Search-HawkTenantEXOAuditLog.ps1
  • Tenant\Start-HawkTenantInvestigation.ps1
  • User\Get-HawkUserAdminAudit.ps1
  • User\Get-HawkUserAuthHistory.ps1
  • User\Get-HawkUserConfiguration.ps1
  • User\Get-HawkUserEmailForwarding.ps1
  • User\Get-HawkUserInboxRule.ps1
  • User\Get-HawkUserMailboxAuditing.ps1
  • User\Start-HawkUserInvestigation.ps1
  • .git\hooks\applypatch-msg.sample
  • .git\hooks\commit-msg.sample
  • .git\hooks\fsmonitor-watchman.sample
  • .git\hooks\post-update.sample
  • .git\hooks\pre-applypatch.sample
  • .git\hooks\pre-commit.sample
  • .git\hooks\pre-push.sample
  • .git\hooks\pre-rebase.sample
  • .git\hooks\pre-receive.sample
  • .git\hooks\prepare-commit-msg.sample
  • .git\hooks\update.sample
  • .git\info\exclude
  • .git\logs\HEAD
  • .git\objects\01\08f69c29bd12ac1e562dc469b6ba700ab77bda
  • .git\objects\02\439362bca363b0236f4a56a7f596890b0a3111
  • .git\objects\07\b55bafb0e4dc849474edef6743ee22f2afe69f
  • .git\objects\0d\ec768ddd4d0e5820736d1ed09537e513184f37
  • .git\objects\11\ad9e492204d19cbe4dc6a861b596e07718adba
  • .git\objects\12\5e93eadd835e92756858a05f91e7a6c4528ac2
  • .git\objects\24\4ff97994b52d0e9483efce280b93c2af4665df
  • .git\objects\29\615bd9a90c458bf8d0eeb1455718623cab1cbd
  • .git\objects\2b\966495725566e4748e42ba4d7f309d49eb2e49
  • .git\objects\2e\048721e8096c213b1612b7a1bb1360e105d164
  • .git\objects\2f\f69a953422cb224968d90d5b1b6cf1f819eb31
  • .git\objects\32\398675abb1ba4009da6154b1aa21ced39dbe84
  • .git\objects\32\812dfac338057717be726f78e1a9a2175768bd
  • .git\objects\3d\6227062ac52312f3415d049330a20d7a59ce24
  • .git\objects\3f\533561c7636f174d3b5c2dbf5d0069e957d8ed
  • .git\objects\41\7b210a02ee319d51d6f403600c5ff9a043e659
  • .git\objects\53\06629ce3aa3d433445d98873c666701153f7f8
  • .git\objects\53\d0d686a1178faab0738f339647247fdc858143
  • .git\objects\5b\9691b9fd32e184731590b084e150c5c32f172c
  • .git\objects\5d\fe575dfe7b00e55190f1baacdeae76885d4adf
  • .git\objects\61\3264fec6c6b82170e6105d16ee9952062fac18
  • .git\objects\62\b3f29eb40e730f4cf25593d40e2b84e78bb601
  • .git\objects\6b\764940687f44c213cf28ad349749d470635bd6
  • .git\objects\75\b64885b0cf0d351de56acfc927917d00ea054e
  • .git\objects\77\e78dba4c28d74a0cf199b791f919a49b1b73da
  • .git\objects\78\28b387c508d08f780a47082cf9c379d6bc41f8
  • .git\objects\7b\93b5ae6af76ee72777afcd4af1162b76821f8f
  • .git\objects\7d\60855daf15bd6d4f604734e0bb5134837fa7f5
  • .git\objects\8e\9a3071f029ec0418bbff8104aba325fd1c3887
  • .git\objects\97\7970b69493eb61a0b265322f4b00e789b1786f
  • .git\objects\97\cbb1c848a08e1d034067ac7ce0742c32e328c5
  • .git\objects\9c\d7cf1eae36525c5b4635c749ae1d2ea15899db
  • .git\objects\9d\cad59dc81ef33079f617c123234966cd5cc140
  • .git\objects\b7\883c26e47ac7cc801717d213d0bdeb1c0c6855
  • .git\objects\bf\07f6fa3b2000f815a4e73491a6875b2cd17834
  • .git\objects\c3\429466ac4481d86d76d10fb4ca12a163bcfd40
  • .git\objects\ca\e6308e4958e09e6c5d17150d2a1411c156f796
  • .git\objects\ce\01bf0a54137d233f8f921aa8782fa992404b12
  • .git\objects\df\bd21a0ce637a95cd548c2080e6bf626860045a
  • .git\objects\e1\1ca6d0f002935add0b6de9d9c7f1769d5ebcfd
  • .git\objects\ea\65e52dc334b1144383ae151f5ad581c9643ea9
  • .git\objects\f1\b17287d0137ec352edb92c0808293c9809afee
  • .git\objects\f2\c99ecde33aeb5bebf87906c52f8847959afab2
  • .git\objects\f6\36ec66cfbc9521a52f21776544f2a95b49705d
  • .git\objects\ff\3108be1ca8975eea9336c3195fda25b565c481
  • .git\objects\ff\62de3313c9cda7a8d8f60500f7abe53f443a86
  • .git\refs\heads\master
  • .git\logs\refs\heads\master
  • .git\refs\remotes\origin\HEAD
  • .git\refs\remotes\origin\master
  • .git\logs\refs\remotes\origin\HEAD
  • .git\logs\refs\remotes\origin\master

Version History

Version Downloads Last updated
3.2.4 6,280 1/8/2025
3.2.3 352 1/7/2025
3.1.2 10,643 12/1/2024
3.1.0 39,476 3/30/2023
3.0.0 4,255 4/9/2022
2.0.3.2 4,654 5/7/2021
2.0.3.1 28 5/7/2021
2.0.2 31 5/7/2021
2.0.1 514 3/31/2021
2.0.0 1,237 1/5/2021
1.15.1 225 12/19/2020
1.15.0 3,415 12/19/2019
1.14.3 52 12/18/2019
1.14.2 366 11/13/2019
1.14.1 27 11/13/2019
1.14.0 461 9/25/2019
1.13.6 308 8/29/2019
1.13.3 61 8/26/2019
1.13.2 76 8/22/2019
1.13.1 54 8/21/2019
1.13.0 58 8/20/2019
1.12.1 30 8/20/2019
1.12.0 27 8/20/2019
1.10.1 412 7/9/2019
1.9.0 27 7/9/2019
1.8.8 29 7/9/2019
1.8.7 366 6/14/2019
1.8.6 342 5/24/2019
1.8.5 34 5/23/2019
1.8.4 59 5/21/2019
1.8.3 70 5/16/2019
1.8.2 29 5/16/2019
1.8.1 47 5/14/2019
1.8.0 30 5/14/2019
1.7.1 364 4/23/2019
1.6.13 177 4/12/2019
1.6.11 75 4/3/2019
1.6.9 535 12/13/2018
1.6.8 25 12/13/2018
1.6.7 33 12/12/2018
1.6.6 29 12/12/2018
1.6.5 30 12/12/2018
1.6.4 27 12/11/2018
1.6.3 84 12/10/2018
1.6.1 198 11/13/2018
1.6.0 29 11/13/2018
1.5.0 72 11/8/2018
1.4.0 82 10/30/2018
1.3.2 160 10/1/2018
1.3.1 31 10/1/2018
1.2.6 52 9/27/2018
1.2.5 (current version) 29 9/27/2018
1.2.4 103 9/6/2018
1.2.3 203 7/19/2018
1.2.2 108 6/29/2018
1.2.1 46 6/26/2018
1.2.0 32 6/25/2018
1.1.4 344 5/18/2018
Show less