Locksmith

 _       _____  _______ _     _ _______ _______ _____ _______ _     _
 |      |     | |       |____/  |______ |  |  |   |      |    |_____|
 |_____ |_____| |_____  |    \_ ______| |  |  | __|__    |    |     |
     .--.                  .--.                  .--.
    /.-. '----------.     /.-. '----------.     /.-. '----------.
    \'-' .---'-''-'-'     \'-' .--'--''-'-'     \'-' .--'--'-''-'
     '--'                  '--'                  '--'

أداة صغيرة مصممة لاستكشاف وإصلاح أخطاء التكوين الشائعة في خدمات شهادات Active Directory.

المحتويات

1. التثبيت
2. تشغيل Locksmith
   1. الوضع 0
   2. الوضع 1
   3. الوضع 2
   4. الوضع 3
   5. الوضع 4
   6. الفحوصات
3. الأمان والدعم

التثبيت

المتطلبات الأساسية

1. يجب تشغيل Locksmith على نظام منضم إلى المجال.
2. يجب تثبيت وحدتَي PowerShell النمطيتين ActiveDirectory وServerManager قبل استيراد وحدة Locksmith.
3. قد تكون صلاحيات المسؤول مطلوبة لبعض الفحوصات وللإصلاح.

تثبيت الوحدة النمطية القياسي

افتح موجه PowerShell وقم بتثبيت Locksmith من PowerShell Gallery:

Install-Module -Name Locksmith -Scope CurrentUser

طرق التثبيت البديلة

1. تنزيل الوحدة واستخدامها دون تثبيتها

   1. قم بتنزيل أحدث إصدار من الوحدة النمطية.
   2. افتح موجه PowerShell إلى موقع الملف المستخرج وقم بتشغيل:

   Unblock-File .\Locksmith.zip # if necessary to unblock the download
   Expand-Archive .\Locksmith.zip
   Import-Module .\Locksmith\Locksmith.psd1
   Invoke-Locksmith
   

2. تنزيل البرنامج النصي المستقل دون الوحدة النمطية

   1. قم بتنزيل أحدث إصدار من البرنامج النصي الأحادي (all-in-one).
   2. افتح موجه PowerShell إلى موقع الملف الذي تم تنزيله وقم بتشغيل:

   Unblock-File .\Invoke-Locksmith.zip
   Expand-Archive .\Invoke-Locksmith.zip -DestinationPath .\
   .\Invoke-Locksmith.ps1
   

تشغيل Locksmith

يتوفر عدة أوضاع يمكنك الاختيار منها عند تشغيل Invoke-Locksmith. يمكنك أيضًا استخدام معامل Scans لتحديد الفحوصات التي تريد تشغيلها.

الوضع 0: تحديد المشكلات، والإخراج إلى وحدة التحكم (الافتراضي)

سيؤدي تشغيل Invoke-Locksmith.ps1 بدون معاملات أو مع -Mode 0 إلى فحص غابة Active Directory الحالية وإخراج جميع مشكلات AD CS المكتشفة إلى وحدة التحكم بتنسيق جدول.

# Module Syntax
Invoke-Locksmith

# Script Syntax
.\Invoke-Locksmith.ps1

مثال على إخراج الوضع 0: https://github.com/jakehildreth/Locksmith/blob/main//Docs/Examples/Mode0.md

الوضع 1: تحديد المشكلات والإصلاحات، والإخراج إلى وحدة التحكم

يقوم هذا الوضع بفحص الغابة الحالية وإخراج جميع مشكلات AD CS المكتشفة والإصلاحات الممكنة إلى وحدة التحكم بتنسيق قائمة.

# Module Syntax
Invoke-Locksmith -Mode 1

# Script Syntax
.\Invoke-Locksmith.ps1 -Mode 1

مثال على إخراج الوضع 1: https://github.com/jakehildreth/Locksmith/blob/main/Docs/Examples/Mode1.md

الوضع 2: تحديد المشكلات، والإخراج إلى CSV

في الوضع 2، يقوم Locksmith بفحص الغابة الحالية وإخراج جميع مشكلات AD CS المكتشفة إلى ADCSIssues.CSV في دليل العمل الحالي.

# Module Syntax
Invoke-Locksmith -Mode 2

# Script Syntax
.\Invoke-Locksmith.ps1 -Mode 2

مثال على إخراج الوضع 2: https://github.com/jakehildreth/Locksmith/blob/main/Docs/Examples/Mode2.md

الوضع 3: تحديد المشكلات والإصلاحات، والإخراج إلى CSV

في الوضع 3، يقوم Locksmith بفحص الغابة الحالية وإخراج جميع مشكلات AD CS المكتشفة وأمثلة الإصلاحات إلى ADCSRemediation.CSV في دليل العمل الحالي.

# Module Syntax
Invoke-Locksmith -Mode 3

# Script Syntax
.\Invoke-Locksmith.ps1 -Mode 3

مثال على إخراج الوضع 3: https://github.com/jakehildreth/Locksmith/blob/main/Docs/Examples/Mode3.md

الوضع 4: إصلاح جميع المشكلات

الوضع 4 هو "الزر السهل". سيؤدي تشغيل Locksmith في الوضع 4 إلى تحديد جميع أخطاء التكوين وعرض إصلاح كل مشكلة. إذا كان هناك أي تأثير تشغيلي محتمل، فسيحذرك Locksmith.

# Module Syntax
Invoke-Locksmith -Mode 4

# Script Syntax
.\Invoke-Locksmith.ps1 -Mode 4

مثال على إخراج الوضع 4: https://github.com/jakehildreth/Locksmith/blob/main/Docs/Examples/Mode4.md

الفحوصات

استخدم معامل -Scans لاختيار الثغرات الأمنية التي تريد فحصها. تتضمن القيم المقبولة All, Auditing, ESC1, ESC2, ESC3, ESC4, ESC5, ESC6, ESC7, ESC8, ESC9, ESC11, ESC13, ESC15, EKEUwu, ESC16 أو PromptMe. يقدم خيار PromptMe قائمة تفاعلية تتيح لك تحديد فحص واحد أو أكثر.

# Run all scans
Invoke-Locksmith -Scan All

# Prompt the user for a list of scans to select
Invoke-Locksmith.ps1 -Scans PromptMe

# Scan for ESC1 vulnerable paths
Invoke-Locksmith.ps1 -Scans ESC1

# Scan for ESC1, ESC2, and ESC8 vulnerable paths
Invoke-Locksmith.ps1 -Scans ESC1,ESC2,ESC8

الأمان والدعم

للإبلاغ عن الثغرات الأمنية، راجع سياسة الأمان. لأسئلة الاستخدام وإرشادات الدعم، راجع الدعم.

شكرًا لاستخدامك Locksmith! 💜