v5.8.1 into main

[vinnybod]

This PR was automatically generated by the release-public-start workflow. This PR should be merged with a merge commit, not a squash commit. Merging this PR will trigger a tag and release automatically.

[github-actions[bot]]

Coverage Report

File	Stmts	Miss	Cover	Missing
empire/server
server.py	109	26	76%	83, 101–107, 116–117, 124–127, 133–136, 147, 152, 156–157, 169–187
empire/server/api
app.py	104	22	79%	25–27, 31, 36–43, 60–66, 93–96, 156, 161–171
jwt_auth.py	72	10	86%	53, 55, 57, 66, 85, 87–88, 91, 102, 113
middleware.py	12	2	83%	39–40
empire/server/api/v2
shared_dto.py	64	3	95%	68, 84, 90
empire/server/api/v2/agent
agent_api.py	50	1	98%	88
agent_file_api.py	34	1	97%	72
agent_task_api.py	170	20	88%	109–133, 200, 295, 304, 321, 342, 371, 386, 405, 422, 439, 458, 477, 500, 515, 529, 544, 550
empire/server/api/v2/download
download_api.py	37	1	97%	57
empire/server/api/v2/listener
listener_api.py	59	4	93%	85, 90, 104, 116
listener_dto.py	48	2	96%	303, 306
listener_template_api.py	18	1	94%	47
empire/server/api/v2/obfuscation
obfuscation_api.py	68	1	99%	132
empire/server/api/v2/plugin
plugin_task_api.py	44	4	91%	81–101, 163
empire/server/api/v2/profile
profile_api.py	46	2	96%	61, 76
empire/server/api/v2/stager
stager_dto.py	44	2	95%	222, 225
stager_template_api.py	18	1	94%	44
empire/server/api/v2/tag
tag_api.py	36	1	97%	77
empire/server/api/v2/user
user_api.py	68	5	93%	60, 83–85, 137, 161
empire/server/api/v2/websocket
socketio.py	90	48	47%	34–39, 42–46, 50–62, 66–68, 80–85, 101–106, 123–128, 140–143, 155, 158, 162–164
empire/server/common
agents.py	729	644	12%	100–105, 119, 134–140, 162–200, 207–217, 223–237, 254–338, 344–396, 403, 433–446, 461–477, 483–501, 508–521, 527–540, 546–567, 573–611, 641–691, 720–735, 741–744, 756–774, 780–791, 816–1091, 1107–1177, 1187–1243, 1252–1300, 1308–1811
credentials.py	44	30	32%	38–51, 60–121, 129–160
encryption.py	174	117	33%	41–43, 47, 56–58, 66–67, 76–80, 95–108, 112–117, 124–126, 134–143, 150–157, 165–171, 178–192, 199–203, 210–211, 241, 266–287, 293–308, 314–325, 331, 337, 344–347, 354–358, 364–377, 383
helpers.py	360	192	47%	83–87, 94–98, 113, 132–133, 198–199, 241, 248–250, 396–431, 441–572, 593, 600–613, 626–636, 641–645, 648–657, 671–679, 685–695, 717, 729–730, 753–755, 762, 785, 788–791, 794–797, 804–806
listeners.py	8	2	75%	15–20
packets.py	113	75	34%	160, 181–186, 211–248, 256–294, 321–375, 428–431
plugins.py	17	3	82%	27, 32, 37
pylnk.py	592	444	25%	202, 206, 210, 214, 218–223, 227–235, 239–243, 247–251, 255–263, 267, 271, 275, 279, 284–287, 291–292, 296–301, 305–311, 315, 319–327, 337–338, 342–344, 364–366, 369–370, 375–378, 383, 386–388, 391, 394–399, 402, 407, 410–414, 419–452, 455–457, 473, 478–485, 488, 493, 498–526, 529–537, 542–556, 559–594, 599, 604–612, 615–634, 637–642, 645–652, 657, 662–690, 695–718, 721–736, 739–756, 759–792, 795–823, 826, 829–830, 835, 838–840, 845, 848–849, 854, 857–858, 863, 866–867, 872, 875–876, 881, 884–885, 890, 893–897, 902, 907–929, 936–938, 942–957
socks.py	43	30	30%	12–13, 17–19, 25–31, 35–42, 46–57, 60
stagers.py	358	296	17%	27–28, 55–63, 93, 100–101, 130, 153, 161–182, 190–205, 213–250, 258–279, 287–301, 308–354, 360–426, 432–592, 596–666, 669–707, 710–722, 725–827, 831–843
templating.py	30	9	70%	62–64, 73–75, 84–86
empire/server/common/malleable
implementation.py	236	26	89%	162, 164, 347, 351, 356, 476–495, 527
profile.py	127	17	87%	103–104, 144–145, 154, 195, 206, 220, 226, 237, 250, 261, 293, 316–319
transaction.py	374	80	79%	167–186, 199, 214–218, 261, 270, 286–290, 294, 304, 353, 404, 430, 441–442, 448, 469–497, 606–612, 631, 644–646, 753–760, 773, 784, 879, 881, 892, 894, 896
transformation.py	373	121	68%	182, 184, 186, 211, 222–223, 225, 233–234, 236, 282, 288, 292, 323–349, 354–394, 402–439, 454, 465–466, 468, 476–477, 479, 681, 683, 685, 687, 697–698, 722–726, 730, 734, 758, 771, 776, 788, 790–792, 794, 809, 811–813, 815, 833–838, 854, 859, 875–882, 898, 903
utility.py	43	13	70%	29, 45–48, 60–66, 120, 128
empire/server/core
agent_service.py	102	16	84%	83, 86, 89, 138, 164–182, 197
agent_task_service.py	190	36	81%	66–69, 85, 87, 93, 96, 99, 107, 109, 111, 116, 121, 141–146, 175, 206–209, 221, 226–229, 237, 239, 268–285, 371–379
bypass_service.py	65	4	94%	31, 37, 60–61
config.py	93	9	90%	15–17, 117–120, 129–130
credential_service.py	49	3	94%	29–30, 38
download_service.py	99	22	78%	45, 51, 57, 61, 67–70, 73, 93, 95, 97, 99, 104, 109, 130–141
hooks.py	66	8	88%	73–75, 84–86, 120, 123
hooks_internal.py	100	55	45%	25, 28, 109–132, 142–170, 183–202, 212–236
listener_service.py	185	29	84%	107, 135–136, 146, 156, 187–194, 244–253, 274, 284–286, 289–293, 324–328
module_models.py	66	8	88%	74–85, 89–91
module_service.py	295	68	77%	91, 119, 132, 140–144, 154–158, 162–192, 272–274, 309, 330, 333, 396–420, 431–433, 477–478, 495, 509, 515, 539, 559–578, 587–588, 606
obfuscation_service.py	137	19	86%	96–98, 107, 119, 124–126, 143–147, 154–157, 190–191, 234, 252–257
plugin_service.py	162	23	86%	58, 75–76, 88, 127, 133–137, 219–222, 238, 244, 247, 250, 258, 260, 262, 267, 272
profile_service.py	61	2	97%	41, 85
stager_service.py	98	5	95%	53, 88, 130, 135, 158
stager_template_service.py	47	1	98%	57
tag_service.py	71	17	76%	45, 47, 49, 51, 53, 55, 59–62, 65, 68, 76–79, 84, 87
user_service.py	41	2	95%	15, 50
empire/server/core/db
base.py	88	18	80%	26–28, 36–41, 59, 73–82, 158–164
defaults.py	43	5	88%	87–91, 100–101
models.py	295	10	97%	262–266, 278, 281, 329, 353, 356, 417, 420
empire/server/listeners
dbx.py	449	361	20%	143, 150–161, 183–184, 207–211, 230, 241–245, 280–284, 290, 302–305, 328–329, 335–347, 357–360, 365–372, 389–494, 510–595, 605–658, 709–1015, 1024–1029, 1035–1038
http.py	545	343	37%	230–233, 274, 287, 295–306, 317–321, 342–349, 386, 396–398, 426–429, 437–438, 447–461, 471–474, 479–485, 490–524, 541–542, 557–614, 638–639, 643, 646–648, 656, 673–674, 686–711, 715, 737–738, 741–746, 793–797, 805–1249
http_com.py	365	285	22%	165, 172–186, 207–208, 228–233, 242–246, 276–283, 289, 307–311, 317, 340–423, 439–482, 492–518, 524–850, 857–862, 868–871
http_foreign.py	170	72	58%	141, 148–153, 175–178, 197–201, 212, 224–226, 233–238, 244–247, 275–279, 285, 294, 298–301, 328–329, 341–357, 367–370, 375–384, 389, 406–407, 416–417, 425–466, 472, 478
http_hop.py	238	148	38%	99, 106, 128–129, 147–151, 161, 173–175, 182–187, 222–226, 232, 243, 251–254, 282–283, 292–305, 315–318, 323–327, 332, 349–480, 491–492, 500–541, 549–596, 602
http_malleable.py	629	488	22%	163, 190, 234, 241–246, 272–273, 291–297, 303, 306, 309, 353, 363–366, 373–384, 394, 403, 413–418, 425, 435–439, 444, 455–456, 460, 469–470, 481–497, 537–542, 549, 557–558, 561–570, 575, 592–724, 738–822, 833–1358, 1366–1765, 1772–1780, 1786–1789
onedrive.py	376	308	18%	158, 161–191, 210–211, 223–227, 247–249, 255–260, 279–283, 288, 312–374, 381–418, 432–476, 479–886, 893–898, 904–907
port_forward_pivot.py	370	267	28%	75–76, 82, 104–105, 124–128, 139, 151–154, 161–172, 183–187, 211–219, 235–239, 245, 256, 260–263, 293–297, 303–304, 316–332, 342–345, 350–357, 361–395, 412–522, 538–626, 637–678, 686–855, 862–953
smb.py	205	179	13%	67–68, 74, 93–229, 246–310, 326–372, 383–416, 424–482, 489
empire/server/modules/csharp
Assembly.Covenant.py	19	13	32%	16–45
AssemblyReflect.Covenant.py	19	13	32%	16–45
Inject_BOF.Covenant.py	31	21	32%	23–66
ProcessInjection.Covenant.py	69	59	14%	3–4, 24–126
Shellcode.Covenant.py	22	16	27%	16–48
empire/server/modules/powershell/code_execution
invoke_ntsd.py	55	49	11%	15–103
invoke_reflectivepeinjection.py	34	26	24%	19–69
invoke_shellcode.py	22	3	86%	30–31, 37
invoke_shellcodemsil.py	18	12	33%	16–41
empire/server/modules/powershell/collection
SharpChromium.py	28	20	29%	20–61
WireTap.py	21	15	29%	16–47
get_sql_column_sample_data.py	40	34	15%	15–76
minidump.py	23	17	26%	16–49
packet_capture.py	18	13	28%	14–37
screenshot.py	24	18	25%	16–50
empire/server/modules/powershell/credentials
credential_injection.py	37	30	19%	17–78
tokens.py	32	26	19%	16–78
empire/server/modules/powershell/credentials/mimikatz
dcsync_hashdump.py	22	16	27%	16–48
golden_ticket.py	36	27	25%	21–68
lsadump.py	16	10	38%	16–40
mimitokens.py	35	29	17%	16–64
pth.py	35	26	26%	21–70
silver_ticket.py	41	33	20%	18–75
trust_keys.py	15	9	40%	16–37
empire/server/modules/powershell/exfiltration
PSRansom.py	25	19	24%	16–52
empire/server/modules/powershell/exploitation
exploit_eternalblue.py	18	12	33%	16–43
empire/server/modules/powershell/lateral_movement
inveigh_relay.py	36	30	17%	16–91
invoke_dcom.py	36	30	17%	16–93
invoke_executemsbuild.py	55	48	13%	17–116
invoke_psexec.py	38	32	16%	16–98
invoke_psremoting.py	44	37	16%	17–101
invoke_smbexec.py	40	34	15%	16–99
invoke_sqloscmd.py	47	40	15%	16–91
invoke_sshcommand.py	33	26	21%	17–66
invoke_wmi.py	49	42	14%	17–112
invoke_wmi_debugger.py	60	52	13%	17–167
jenkins_script_console.py	28	21	25%	17–67
new_gpo_immediate_task.py	37	30	19%	17–103
empire/server/modules/powershell/management
invoke_bypass.py	14	8	43%	15–31
invoke_script.py	19	13	32%	15–38
logoff.py	11	6	45%	14–27
psinject.py	35	29	17%	16–84
reflective_inject.py	45	37	18%	18–97
runas.py	35	28	20%	17–73
shinject.py	30	23	23%	17–71
spawn.py	29	23	21%	16–77
spawnas.py	45	38	16%	17–78
switch_listener.py	15	9	40%	16–46
user_to_sid.py	8	3	62%	14–24
empire/server/modules/powershell/management/mailraider
disable_security.py	25	19	24%	15–62
get_emailitems.py	17	11	35%	15–50
empire/server/modules/powershell/persistence/elevated
registry.py	69	61	12%	19–170
schtasks.py	83	75	10%	19–210
wmi.py	92	84	9%	19–263
wmi_updater.py	75	67	11%	19–221
empire/server/modules/powershell/persistence/misc
add_sid_history.py	16	10	38%	16–39
debugger.py	39	33	15%	16–121
empire/server/modules/powershell/persistence/powerbreach
deaduser.py	39	31	21%	18–142
eventlog.py	36	28	22%	18–120
resolver.py	39	31	21%	18–129
empire/server/modules/powershell/persistence/userland
backdoor_lnk.py	51	43	16%	19–130
registry.py	77	69	10%	19–208
schtasks.py	78	70	10%	19–201
empire/server/modules/powershell/privesc
ask.py	23	17	26%	16–72
bypassuac.py	25	19	24%	16–64
bypassuac_env.py	26	20	23%	16–63
bypassuac_eventvwr.py	26	20	23%	16–65
bypassuac_fodhelper.py	26	20	23%	16–64
bypassuac_sdctlbypass.py	26	20	23%	16–64
bypassuac_tokenmanipulation.py	29	21	28%	19–65
bypassuac_wscript.py	25	19	24%	16–64
ms16-032.py	19	13	32%	16–52
ms16-135.py	19	13	32%	16–52
empire/server/modules/powershell/privesc/powerup
service_exe_stager.py	31	25	19%	16–67
service_stager.py	26	20	23%	16–58
write_dllhijacker.py	29	23	21%	16–77
empire/server/modules/powershell/recon
fetch_brute_local.py	26	20	23%	15–48
find_fruit.py	24	18	25%	16–60
get_sql_server_login_default_pw.py	23	18	22%	14–50
empire/server/modules/powershell/situational_awareness/host
computerdetails.py	55	49	11%	16–119
empire/server/modules/powershell/situational_awareness/network
get_sql_server_info.py	30	25	17%	14–64
empire/server/modules/powershell/situational_awareness/network/powerview
get_gpo_computer.py	41	34	17%	18–91
get_subnet_ranges.py	37	30	19%	17–76
empire/server/modules/python/collection/osx
imessage_dump.py	15	10	33%	14–176
native_screenshot_mss.py	13	7	46%	16–46
prompt.py	14	9	36%	14–49
search_email.py	12	1	92%	19
sniffer.py	23	18	22%	14–151
empire/server/modules/python/lateral_movement/multi
ssh_launcher.py	18	12	33%	15–67
empire/server/modules/python/management/multi
spawn.py	14	8	43%	16–30
empire/server/modules/python/management/osx
shellcodeinject64.py	19	11	42%	18–139
empire/server/modules/python/persistence/multi
desktopfile.py	15	9	40%	15–59
empire/server/modules/python/persistence/osx
CreateHijacker.py	21	14	33%	23–480
LaunchAgent.py	22	15	32%	17–103
LaunchAgentUserLandPersistence.py	17	11	35%	15–78
loginhook.py	13	8	38%	14–64
mail.py	30	22	27%	18–190
empire/server/modules/python/privesc/multi
CVE-2021-3560.py	17	10	41%	18–43
CVE-2021-4034.py	22	14	36%	19–49
bashdoor.py	12	7	42%	15–47
sudo_spawn.py	19	13	32%	16–41
empire/server/modules/python/privesc/osx
dyld_print_to_file.py	18	11	39%	24–54
piggyback.py	18	12	33%	16–55
empire/server/modules/python/situational_awareness/host/osx
situational_awareness.py	14	9	36%	14–196
empire/server/plugins
basic_reporting.plugin	77	54	30%	43–74, 86–99, 102–115, 118–134, 148–152
csharpserver.plugin	127	86	32%	48–53, 56, 71–117, 120–127, 130–159, 162–192, 203–207
reverseshell_stager_server.plugin	111	84	24%	123–130, 133, 148–211, 216, 222–231, 234–250, 253–266
websockify_server.plugin	57	31	46%	68–76, 79, 94–128
empire/server/plugins/ChiselServer-Plugin
chiselserver.plugin	101	71	30%	66–71, 89–184
empire/server/plugins/Report-Generation-Plugin
advanced_reporting.plugin	147	107	27%	67–111, 134–151, 155–176, 179–188, 191–201, 204–220, 227–259, 262–276, 282–285, 298–300
mitre.py	124	85	31%	17–18, 21, 24, 28, 31–40, 44–58, 62–65, 69–71, 74–75, 78–80, 84–103, 106–107, 110–111, 114–115, 118–119, 124–128, 131–135, 138, 143, 146–147, 155–156, 165–181, 189–201, 209, 217–225, 236–237, 245–259, 262–272, 275
empire/server/plugins/SocksProxyServer-Plugin
socksproxyserver.plugin	136	104	24%	83–88, 103–122, 125–130, 137–141, 146–177, 180–188, 191–214, 217–232
empire/server/stagers/multi
bash.py	22	14	36%	67–92
generate_agent.py	30	22	27%	93–133
launcher.py	34	6	82%	116–124, 147–148
macro.py	53	43	19%	120–253
pyinstaller.py	54	6	89%	100–102, 113–114, 143
war.py	44	34	23%	91–183
empire/server/stagers/osx
applescript.py	19	11	42%	62–83
application.py	26	17	35%	81–113
ducky.py	25	18	28%	60–88
dylib.py	26	18	31%	73–103
jar.py	18	11	39%	60–79
macho.py	18	11	39%	60–83
macro.py	40	32	20%	85–187
pkg.py	28	20	29%	72–109
safari_launcher.py	23	16	30%	67–107
shellcode.py	24	17	29%	68–158
teensy.py	76	69	9%	61–144
empire/server/stagers/windows
backdoorLnkMacro.py	148	129	13%	151–159, 163–484
bunny.py	48	39	19%	107–176
cmd_exec.py	46	35	24%	105–164, 167–179
csharp_exe.py	51	43	16%	102–172
dll.py	41	11	73%	107–108, 112, 115–118, 121–132, 156–157
ducky.py	42	34	19%	94–163
hta.py	37	29	22%	86–145
launcher_bat.py	54	11	80%	86, 93, 96–97, 116, 131–141, 150–151
launcher_lnk.py	39	30	23%	118–182
launcher_sct.py	52	44	15%	96–174
launcher_vbs.py	34	26	24%	82–138
launcher_xml.py	83	75	10%	82–192
macro.py	70	59	16%	114–218
ms16-051.py	35	27	23%	95–283
nim.py	52	43	17%	83–170
reverseshell.py	23	13	43%	61–67, 70–86
shellcode.py	58	47	19%	5–6, 107–185
teensy.py	113	105	7%	82–218
wmic.py	42	34	19%	96–159
empire/server/utils
data_util.py	50	10	80%	34–44, 57–58, 60, 64
file_util.py	13	1	92%	24
listener_util.py	30	11	63%	13–19, 99–112
log_util.py	40	21	48%	11–39
math_util.py	5	3	40%	9–12
module_util.py	9	3	67%	14–16
option_util.py	74	18	76%	97, 117–131, 140–149, 157
TOTAL	17462	9467	46%

Tests	Skipped	Failures	Errors	Time
317	0 :zzz:	0 :x:	0 :fire:	10m 1s :stopwatch: