SitRep

विस्तार योग्य, कॉन्फ़िगर करने योग्य होस्ट ट्राइएज।

उद्देश्य

SitRep एक हल्का, विस्तार योग्य होस्ट ट्राइएज विकल्प प्रदान करने के लिए है। जांचें रनटाइम पर स्टैंड-अलोन फ़ाइलों से गतिशील रूप से लोड की जाती हैं। यह ऑपरेटरों को मौजूदा जांचों को जल्दी से संशोधित करने, या आवश्यकतानुसार नई जांचें जोड़ने की अनुमति देता है।

जांचें श्रेणी के अनुसार समूहित की जाती हैं और OpSec सुरक्षित/असुरक्षित के रूप में चिह्नित की जा सकती हैं। असुरक्षित जांचें केवल तब लोड की जाती हैं जब /AllowUnsafe फ़्लैग प्रदान किया जाता है।

दिलचस्प परिणामों को "[*]" से हाइलाइट किया जाता है।

जांचें

जांचें श्रेणियों में विभाजित की गई हैं। यह उन्हें उपयुक्त समूहों में प्रदर्शित करने की अनुमति देता है। वर्तमान में निम्नलिखित जांचें उपलब्ध हैं:

पर्यावरण

• CurrentUser.cs - वर्तमान उपयोगकर्ता
• DomainName.cs - डोमेन नाम
• HostName.cs - होस्टनाम
• LoggedOnUsers.cs - सभी लॉग ऑन उपयोगकर्ताओं की सूची बनाएं
• OSVersion.cs - OS संस्करण जानकारी
• VirtualEnvironment.cs - जाँचता है कि क्या हम एक वर्चुअलाइज्ड वातावरण में काम कर रहे हैं
• userEnvironmentVariables.cs - वर्तमान प्रक्रिया पर लागू पर्यावरण चर प्राप्त करता है
• SystemEnvironmentVariables.cs - रजिस्ट्री (HKLM) से सिस्टम पर्यावरण चर प्राप्त करता है
• NameServers.cs - प्रत्येक नेटवर्क इंटरफ़ेस के लिए DNS सर्वर प्राप्त करता है

सुरक्षा

• AVProcesses.cs - जाँचता है कि क्या कोई ज्ञात AV प्रक्रिया चल रही है

अनुमतियाँ

• Integrity.cs - वर्तमान प्रक्रिया की अखंडता स्तर प्राप्त करें
• LocalAdmin.cs - जाँचें कि क्या हम स्थानीय व्यवस्थापक हैं
• Privileges.cs - हमारे वर्तमान विशेषाधिकारों की सूची बनाएं।
• UACLevel.cs - UAC स्तर प्राप्त करें
• UserDomainGroups.cs - उपयोगकर्ता के डोमेन समूह सदस्यता प्राप्त करता है
• ComputerDomainGroups.cs - कंप्यूटर जिन डोमेन समूहों का सदस्य है उन्हें प्राप्त करता है

सॉफ़्टवेयर

• InstalledBrowsers.cs - एंडपॉइंट पर स्थापित ब्राउज़रों की सूची बनाता है

क्रेडेंशियल्स

• CredentialManager.cs - वर्तमान उपयोगकर्ता के लिए Windows क्रेडेंशियल मैनेजर में संग्रहीत क्रेडेंशियल पुनर्प्राप्त करें

निम्नलिखित जांचें वर्तमान में OpSec सुरक्षित नहीं के रूप में चिह्नित हैं:

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

आपको इस कॉन्फ़िगरेशन की समीक्षा करनी चाहिए और आवश्यकतानुसार OpSec टैग अपडेट करने चाहिए।

जांचों को अक्षम करना

सभी जांचें डिफ़ॉल्ट रूप से सक्षम हैं। हालांकि, चूंकि जांचें गतिशील रूप से लोड की जाती हैं, उन्हें अक्षम करना संभव है।

एक जांच को अक्षम करना

CheckBase में एक बूलियन "Enabled" गुण शामिल है, जो डिफ़ॉल्ट रूप से true होता है। इसे एक कंस्ट्रक्टर जोड़कर व्युत्पन्न वर्ग में सेट किया जा सकता है। नीचे दिया गया उदाहरण CurrentUser जांच (CurrentUser.cs) को अक्षम करता है:

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

बिल्ड से जांचों को बाहर करना

चूंकि जांचें गतिशील रूप से लोड की जाती हैं, बिना अन्य संशोधनों के बिल्ड से एक जांच को बाहर करना संभव है। ऐसा करने का सबसे आसान तरीका Visual Studio में जांच वर्ग पर राइट-क्लिक करें और "exclude from project" चुनें। जांच को उसी संदर्भ मेनू से "include in project" चुनकर पुनः जोड़ा जा सकता है।

इस दृष्टिकोण का लाभ यह है कि यह संकलित आर्टिफैक्ट से कोड को हटा देता है।

उपयोग उदाहरण

सभी जांचें चलाएं

SitRep.exe /AllowUnsafe

केवल OpSec सुरक्षित जांचें चलाएं (डिफ़ॉल्ट)

SitRep.exe

SitRep को execute-assembly (या समतुल्य) के माध्यम से निष्पादित करने के लिए डिज़ाइन किया गया है

जांचें जोड़ना

जांचें CheckBase से इनहेरिट करती हैं और ICheck इंटरफ़ेस को लागू करती हैं। यह गतिशील जांच लोडिंग के लिए आवश्यक पैटर्न को लागू करता है। आवश्यकतानुसार अन्य विधियाँ और वर्ग जोड़े जा सकते हैं।

ICheck इंटरफ़ेस निम्नलिखित गुणों और विधियों को उजागर करता है:

• IsOpsecSafe (bool) - इंगित करता है कि क्या जांच OpSec सुरक्षित मानी जाती है या नहीं
• DisplayOrder (int) - वह क्रम जिसमें इस जांच के परिणाम को इसके प्रदर्शन समूह में प्रदर्शित किया जाना है
• Check() - वास्तविक जांच चलाने के लिए कॉल की जाने वाली विधि

व्युत्पन्न वर्गों को CheckBase में परिभाषित "ToString()" विधि को ओवरराइड करना होगा। प्रत्येक जांच के आउटपुट को प्रदर्शित करते समय यह विधि कॉल की जाती है।

मूल विधियों तक पहुंच "NativeMethods" फ़ोल्डर में वर्गों के माध्यम से प्रदान की जाती है। प्रत्येक वर्ग का नाम उस dll के नाम पर रखा गया है जिसके साथ वह इंटरैक्ट करता है।

जांचें अपनी स्वयं की त्रुटि प्रबंधन प्रदान करने के लिए जिम्मेदार हैं। वर्तमान जांचें पूरे "check" विधि को try-catch ब्लॉक में लपेटती हैं, इस पैटर्न के उपयोग को प्रोत्साहित किया जाता है।

नीचे एक खाली जांच का उदाहरण दिखाया गया है

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();
        }
    }
}

योगदान

PRs का स्वागत है। कृपया सुनिश्चित करें कि जांचें स्वतंत्र हों (अर्थात अन्य जांचों के आउटपुट पर निर्भर न हों)। जहां तक संभव हो, जांचें स्व-निहित होनी चाहिए, जिसमें सभी एकल-उपयोग कोड जांच वर्ग के भीतर मौजूद हो।

यूनिट परीक्षण क्यों नहीं?

क्या आपने कभी डोमेन-जॉइन्ड Windows एंडपॉइंट का मॉक बनाने की कोशिश की है? इसलिए।

धन्यवाद

SitRep Seatbelt, SharpUp और यादृच्छिक StackOverflow पोस्ट्स से कोड का उपयोग करता है। जहां उपयुक्त हो वहां क्रेडिट जोड़े गए हैं।