Skip to content

Latest commit

 

History

History
140 lines (104 loc) · 5.18 KB

README.md

File metadata and controls

140 lines (104 loc) · 5.18 KB

SitRep

Extensible, configurable host triage.

Purpose

SitRep is intended to provide a lightweight, extensible host triage alternative. Checks are loaded dynamically at runtime from stand-alone files. This allows operators to quickly modify existing checks, or add new checks as required.

Checks are grouped by category and can be marked as OpSec safe/unsafe. unsafe checks are only loaded if the /AllowUnsafe flag is provided.

Interesting results are highlighted with a "[*]"

Checks

Checks are separated into categories. This allows them to be displayed in appropriate groups. The following checks are currently available:

Environment

  • CurrentUser.cs - the current user
  • DomainName.cs - the domain name
  • HostName.cs - the hostname
  • LoggedOnUsers.cs - List all logged on users
  • OSVersion.cs - OS version information
  • VirtualEnvironment.cs - Checks if we are operating in a virtualised environment
  • userEnvironmentVariables.cs - Grabs the environment variables applied to the current process
  • SystemEnvironmentVariables.cs - Grabs system environment variables from the registry (HKLM)
  • NameServers.cs - Gets the DNS servers for each network interface

Defences

  • AVProcesses.cs - Checks if any known AV processes are running

Permissions

  • Integrity.cs - Get the integrity level of the current process
  • LocalAdmin.cs - Check if we are a local admin
  • Privileges.cs - List our current privileges.
  • UACLevel.cs - Get the UAC level
  • UserDomainGroups.cs - Gets the users domain group memberships
  • ComputerDomainGroups.cs - Gets the domain groups the computer is a member of

Software

  • InstalledBrowsers.cs - Lists the browsers installed on the endpoint

Credentials

  • CredentialManager.cs - Retrieve credentials stored in Windows Credential Manager for the current user

The following checks are currently marked as being not OpSec safe:

  • CredentialManager.cs
  • ComputerDomainGroups.cs
  • UserDomainGroups.cs

You should review this configuration and update the OpSec tags as required.

Disabling Checks

All checks are enabled by default. However, as checks are loaded dynamically, it is possible to disable them.

Disabling a check

CheckBase includes a boolean "Enabled" property, which defaults to true. This can be set in the derived class by adding a constructor. The example below disables the CurrentUser check (CurrentUser.cs):

public CurrentUser()
{
    base.Enabled = false;
}

Excluding checks from the build

As checks are loaded dynamically, it is possible to exclude a check from the build without other modifications. The easiest way to do this is to right-click on the check class in Visual Studio and select "exclude from project". The check can be re-added by selecting "include in project" from the same context menu.

This approach has the advantage of removing the code from the compiled artifact.

Example Usage

Run all checks

SitRep.exe /AllowUnsafe

Run only OpSec safe checks (default)

SitRep.exe

SitRep is designed to be executed via execute-assembly (or equivalent)

screenshot

Adding Checks

Checks inherit from CheckBase and implement the ICheck interface. This enforces the patterns needed for the dynamic check loading. Other methods and classes can be added as required.

The ICheck interface exposes the following properties and methods:

  • IsOpsecSafe (bool) - Indicates if the check is considered OpSec safe or not
  • DisplayOrder (int) - The order in which to display the result of this check within its display group
  • Check() - The method called to run the actual check

Derived classes must override the "ToString()" method defined in CheckBase. This method is called when displaying the output of each check.

Access to native methods is provided via classes in the "NativeMethods" folder. Each class is named after the dll it interacts with.

Checks are responsible for providing their own error handling. Current checks wrap the entire "check" method in a try-catch block, the use of this pattern is encouraged.

An example, empty check is shown below

using SitRep.Interfaces;
using System;

namespace SitRep.Checks.Software
{
    class ExampleCheck : CheckBase, ICheck
    {
        public bool IsOpsecSafe => true;

        public int DisplayOrder => 1;

        public Enums.Enums.CheckType CheckType => Enums.Enums.CheckType.Credential;

        public void Check()
        {
            try
            {
                throw new NotImplementedException();
            }
            catch
            {
                Message = "Check failed [*]";
            }
        }

        public override string ToString()
        {
            throw new NotImplementedException();
        }
    }
}

Contributing

PRs welcome. Please ensure checks are stand-alone (i.e. not dependent on the output of other checks). As far as possible, checks should be self-contained, with all single-use code present within the check class.

Why no unit tests?

Have you ever tried mocking a domain-joined Windows endpoint? That's why.

Thanks

SitRep makes use of code from Seatbelt, SharpUp and random StackOverflow posts. Credits have been added where appropriate.