Security-101 / fa

<!--
CO_OP_TRANSLATOR_METADATA:
{
  "original_hash": "913da05fee7fb78699c0447cf6d8aa10",
  "translation_date": "2025-10-12T09:25:52+00:00",
  "source_file": "AGENTS.md",
  "language_code": "fa"
}
-->
## نمای کلی پروژه

**Security-101** یک برنامه آموزشی مقدماتی در زمینه امنیت سایبری است که توسط مایکروسافت طراحی شده است. این پروژه یک منبع یادگیری مبتنی بر مستندات است که مفاهیم پایه‌ای امنیت سایبری را از طریق ماژول‌های ساختاریافته آموزش می‌دهد. این برنامه مستقل از فروشنده بوده و برای تکمیل در درس‌های کوتاه (هر کدام ۳۰ تا ۶۰ دقیقه) طراحی شده است.

**فناوری‌های کلیدی:**
- Markdown برای محتوا
- Docsify برای تولید سایت استاتیک
- GitHub Pages برای میزبانی
- Co-op Translator برای پشتیبانی چندزبانه (بیش از ۵۰ زبان)
- GitHub Actions برای CI/CD

**معماری:**
- محتوای آموزشی سازمان‌دهی شده در ۸ ماژول اصلی، هر کدام با زیر درس‌ها
- سایت HTML استاتیک با Docsify برای نمایش محتوای Markdown
- جریان کاری ترجمه خودکار با استفاده از خدمات Azure AI
- بدون نیاز به ابزارهای ساخت یا مدیریت بسته برای محتوای اصلی

## ساختار مخزن

```
/
├── README.md                    # Main entry point with curriculum overview
├── index.html                   # Docsify site entry point
├── [1-8].[1-4] *.md            # Curriculum modules and lessons
├── CODE_OF_CONDUCT.md          # Community guidelines
├── SECURITY.md                 # Security policy
├── SUPPORT.md                  # Support information
├── LICENSE                     # MIT License
├── images/                     # Image assets for lessons
├── translated_images/          # Translated image assets
├── translations/               # Translated versions (50+ languages)
└── .github/
    ├── workflows/
    │   ├── co-op-translator.yml    # Automated translation workflow
    │   ├── deploy.yaml             # GitHub Pages deployment
    │   └── jekyll-gh-pages.yml     # Jekyll site generation
    └── ISSUE_TEMPLATE/             # Issue templates
```

## دستورات راه‌اندازی

این پروژه مستنداتی است و نیازی به نصب وابستگی‌ها ندارد. برای کار با محتوا:

```bash
# Clone the repository
git clone https://github.com/microsoft/Security-101.git
cd Security-101

# View content locally - any Markdown viewer works
# OR serve with a simple HTTP server to use Docsify rendering
python -m http.server 8000
# Then visit http://localhost:8000 in your browser
```

## جریان کاری توسعه

### مشاهده محتوا به صورت محلی

این پروژه از Docsify برای نمایش استفاده می‌کند. برای پیش‌نمایش تغییرات:

```bash
# Option 1: Use Python's built-in HTTP server
python -m http.server 8000

# Option 2: Use Node.js http-server (if available)
npx http-server -p 8000

# Option 3: View Markdown files directly in any Markdown editor
```

### ساختار محتوا

ماژول‌ها به صورت ترتیبی شماره‌گذاری شده‌اند:
- **ماژول ۱:** مفاهیم پایه امنیت (۱.۱-۱.۷)
- **ماژول ۲:** مدیریت هویت و دسترسی (۲.۱-۲.۴)
- **ماژول ۳:** امنیت شبکه (۳.۱-۳.۴)
- **ماژول ۴:** عملیات امنیتی (۴.۱-۴.۴)
- **ماژول ۵:** امنیت برنامه‌ها (۵.۱-۵.۳)
- **ماژول ۶:** امنیت زیرساخت (۶.۱-۶.۳)
- **ماژول ۷:** امنیت داده‌ها (۷.۱-۷.۳)
- **ماژول ۸:** امنیت هوش مصنوعی (۸.۱-۸.۴)

هر ماژول با یک فایل آزمون پایان ماژول به پایان می‌رسد (مثلاً "1.7 End of module quiz.md").

### ایجاد تغییرات در محتوا

1. فایل‌های Markdown را مستقیماً در دایرکتوری اصلی ویرایش کنید
2. از نام‌گذاری موجود پیروی کنید: `[module].[lesson] [Title].md`
3. جدول README.md را در صورت اضافه/حذف ماژول‌ها به‌روزرسانی کنید
4. تصاویر را به دایرکتوری `/images/` اضافه کنید
5. تصاویر را با استفاده از مسیرهای نسبی ارجاع دهید: `![Description](../../translated_images/filename.8c8067c683396b6f17b14be6dc5b8b323f661a863de696f36ec51e4813657b57.fa.png)`

## جریان کاری ترجمه

**ترجمه خودکار:**
- ترجمه‌ها به صورت خودکار توسط Co-op Translator GitHub Action انجام می‌شود
- هنگامی که تغییرات را به شاخه `main` ارسال می‌کنید، جریان کاری محتوا را به بیش از ۵۰ زبان ترجمه می‌کند
- فایل‌های ترجمه شده در `/translations/[language_code]/` ذخیره می‌شوند
- اطلاعات متادیتای ترجمه در YAML frontmatter حفظ می‌شود

**زبان‌های پشتیبانی‌شده:** عربی، بنگالی، بلغاری، برمه‌ای، چینی (ساده، سنتی)، کرواتی، چکی، دانمارکی، هلندی، استونیایی، فنلاندی، فرانسوی، آلمانی، یونانی، عبری، هندی، مجاری، اندونزیایی، ایتالیایی، ژاپنی، کره‌ای، لیتوانیایی، مالایی، مراتی، نپالی، نروژی، فارسی، لهستانی، پرتغالی، پنجابی، رومانیایی، روسی، صربی، اسلواکی، اسلوونیایی، اسپانیایی، سواحیلی، سوئدی، تاگالوگ، تامیل، تایلندی، ترکی، اوکراینی، اردو، ویتنامی و بیشتر.

**فایل‌های ترجمه را به صورت دستی ویرایش نکنید** - این فایل‌ها توسط جریان کاری خودکار بازنویسی خواهند شد.

## دستورالعمل‌های سبک کدنویسی

### قراردادهای Markdown

- از سینتکس استاندارد Markdown استفاده کنید
- عناوین: از `#` برای عنوان اصلی، `##` برای بخش‌ها، `###` برای زیر بخش‌ها استفاده کنید
- لیست‌ها: از `-` یا `*` برای لیست‌های نامرتب، `1.` برای لیست‌های مرتب استفاده کنید
- لینک‌ها: از متن توصیفی با URLهای کامل GitHub برای ارجاعات متقابل استفاده کنید
- تصاویر: در دایرکتوری `/images/` ذخیره کنید، از متن جایگزین توصیفی استفاده کنید
- بلوک‌های کد: از سه علامت بک‌تیک با شناسه زبان در صورت لزوم استفاده کنید

### دستورالعمل‌های محتوا

- درس‌ها را متمرکز و مختصر نگه دارید (زمان مطالعه ۳۰-۶۰ دقیقه)
- از زبان واضح و مناسب برای مبتدیان استفاده کنید
- از دستورالعمل‌های ابزارهای خاص فروشنده اجتناب کنید (برنامه مستقل از فروشنده است)
- اهداف یادگیری را در ابتدای هر ماژول درج کنید
- در صورت لزوم به منابع خارجی Microsoft Learn لینک دهید
- اطمینان حاصل کنید که محتوا آموزشی است، نه تبلیغاتی

### نام‌گذاری فایل‌ها

- از فرمت زیر استفاده کنید: `[Module].[Lesson] [Title].md`
- مثال: `1.1 The CIA triad and other key concepts.md`
- فایل‌های آزمون: `[Module].[Last] End of module quiz.md`
- از فاصله در نام فایل‌ها استفاده کنید (مطابق قرارداد موجود)

## جریان‌های کاری GitHub

### Co-op Translator (co-op-translator.yml)

**فعال‌سازی:** ارسال به شاخه `main`  
**هدف:** ترجمه خودکار فایل‌های جدید/تغییر یافته Markdown به بیش از ۵۰ زبان

**متغیرهای محیطی مورد نیاز:**
- اطلاعات اعتبار خدمات Azure AI (AZURE_AI_SERVICE_API_KEY, AZURE_AI_SERVICE_ENDPOINT)
- اطلاعات اعتبار Azure OpenAI (جایگزین اختیاری)
- اطلاعات اعتبار OpenAI (جایگزین اختیاری)

### Deploy (deploy.yaml)

**فعال‌سازی:** ارسال به شاخه `main` هنگام تغییر README.md  
**هدف:** استقرار سایت استاتیک در GitHub Pages  
**خروجی:** به‌روزرسانی سایت GitHub Pages

### Jekyll GitHub Pages (jekyll-gh-pages.yml)

**فعال‌سازی:** ارسال به شاخه پیکربندی شده  
**هدف:** ساخت و استقرار سایت با استفاده از Jekyll

## دستورالعمل‌های درخواست کشش

### قبل از ارسال

1. **بررسی محتوا:** اطمینان از دقت و وضوح مفاهیم امنیت سایبری
2. **فرمت‌بندی:** بررسی کنید که فرمت Markdown به درستی نمایش داده شود
3. **لینک‌ها:** همه لینک‌های داخلی و خارجی را آزمایش کنید
4. **تصاویر:** اطمینان حاصل کنید که همه تصاویر بارگذاری شده و متن جایگزین توصیفی دارند
5. **سازگاری:** از ساختار و سبک محتوای موجود پیروی کنید

### فرمت عنوان درخواست کشش

از عناوین توصیفی استفاده کنید:
- `Add: [توضیح محتوای جدید]`
- `Update: [ماژول/درس] - [توضیح مختصر]`
- `Fix: [توضیح مشکل]`
- `Docs: [تغییرات مستندات]`

### بررسی‌های مورد نیاز

- دقت محتوا (بررسی دستی)
- اعتبارسنجی فرمت‌بندی Markdown
- تأیید لینک‌ها
- تکمیل جریان کاری ترجمه (برای ادغام شاخه `main`)

### فرآیند بررسی

1. حداقل یک بررسی توسط نگهدارنده لازم است
2. تمرکز بر دقت فنی مفاهیم امنیتی
3. بررسی دسترسی و مناسب بودن برای مبتدیان
4. اطمینان از حفظ بی‌طرفی فروشنده

## وظایف رایج

### افزودن یک درس جدید

```bash
# 1. Create new Markdown file with proper naming
touch "[Module].[Lesson] [Title].md"

# 2. Add content following template structure
# 3. Update README.md module table with new entry
# 4. Add entry to module overview table
# 5. Ensure quiz file numbering is correct

# 6. Commit changes
git add "[Module].[Lesson] [Title].md" README.md
git commit -m "Add: [Module].[Lesson] - [Title]"
git push
```

### به‌روزرسانی محتوای موجود

```bash
# 1. Edit the relevant Markdown file
# 2. Verify formatting and links
# 3. Commit with descriptive message
git add "[Module].[Lesson] [Title].md"
git commit -m "Update: [Module].[Lesson] - [Brief description of changes]"
git push
```

### افزودن تصاویر

```bash
# 1. Add image to /images/ directory
cp new-image.png images/

# 2. Reference in Markdown
# ![Descriptive alt text](../../translated_images/new-image.ade387a7c819665dda19f7585b9b1cc82817a21d283e286f39c2891d201fcdab.fa.png)

# 3. Commit both content and image
git add "images/new-image.png" "[Module].[Lesson] [Title].md"
git commit -m "Add: Image for [description]"
git push
```

## آزمایش و اعتبارسنجی

### اعتبارسنجی محتوا

از آنجا که این یک پروژه مستنداتی است، آزمایش بر موارد زیر تمرکز دارد:

1. **نمایش Markdown:** تغییرات را به صورت محلی با استفاده از Docsify مشاهده کنید
2. **اعتبارسنجی لینک‌ها:** همه لینک‌ها را به صورت دستی بررسی کنید
3. **بارگذاری تصاویر:** اطمینان حاصل کنید که همه تصاویر به درستی نمایش داده می‌شوند
4. **ترجمه:** بررسی کنید که فایل‌ها توسط جریان کاری ترجمه شناسایی شده‌اند (خودکار)
5. **دسترسی:** اطمینان حاصل کنید که سلسله‌مراتب عناوین و متن جایگزین صحیح است

### پیش‌نمایش محلی

```bash
# Serve locally to test Docsify rendering
python -m http.server 8000

# Visit http://localhost:8000
# Click through navigation to verify all links work
# Check that images load properly
# Verify Markdown formatting renders correctly
```

### چک‌لیست پیش از ارسال

- [ ] فایل‌های Markdown از سینتکس صحیح استفاده می‌کنند
- [ ] همه لینک‌ها معتبر هستند و در صورت امکان از HTTPS استفاده می‌کنند
- [ ] تصاویر دارای متن جایگزین توصیفی هستند
- [ ] محتوا برای مبتدیان مناسب و دقیق است
- [ ] زبان بی‌طرفانه فروشنده حفظ شده است
- [ ] README.md در صورت اضافه/حذف ماژول‌ها به‌روزرسانی شده است
- [ ] نام‌گذاری فایل‌ها مطابق قراردادها است

## ملاحظات امنیتی

- **بدون اطلاعات محرمانه در محتوا:** هرگز کلیدهای API، رمزهای عبور یا داده‌های حساس را ارسال نکنید
- **اعتبارسنجی لینک‌ها:** اطمینان حاصل کنید که همه لینک‌های خارجی به منابع معتبر اشاره دارند
- **محتوای تصاویر:** بررسی کنید که تصاویر حاوی اطلاعات حساس نباشند
- **جریان کاری ترجمه:** از خدمات Azure AI با احراز هویت مناسب استفاده می‌کند
- **SECURITY.md:** فرآیند گزارش آسیب‌پذیری در SECURITY.md را دنبال کنید

## منابع اضافی

### دوره‌های مرتبط مایکروسافت

این برنامه آموزشی بخشی از مجموعه بزرگتری از منابع آموزشی مایکروسافت است:
- هوش مصنوعی مولد برای مبتدیان
- هوش مصنوعی برای مبتدیان
- علم داده برای مبتدیان
- یادگیری ماشین برای مبتدیان
- توسعه وب برای مبتدیان
- اینترنت اشیا برای مبتدیان

### مسیرهای یادگیری خارجی

پس از تکمیل Security-101:
- [Microsoft Security, Compliance, and Identity Fundamentals](https://learn.microsoft.com/training/paths/describe-concepts-of-security-compliance-identity/)
- [Exam SC-900: Microsoft Security, Compliance, and Identity Fundamentals](https://learn.microsoft.com/credentials/certifications/exams/sc-900/)

## مشارکت

1. **مخزن را فورک کنید** در GitHub
2. **یک شاخه ویژگی ایجاد کنید** برای تغییرات خود
3. **تغییرات خود را اعمال کنید** با پیروی از دستورالعمل‌های بالا
4. **به صورت محلی آزمایش کنید** تا مطمئن شوید همه چیز به درستی نمایش داده می‌شود
5. **یک درخواست کشش ارسال کنید** با توضیح واضح تغییرات
6. **به بازخورد نگهدارنده‌ها پاسخ دهید**

## مشکلات رایج و رفع اشکال

### ترجمه‌ها کار نمی‌کنند

- اطمینان حاصل کنید که تغییرات به شاخه `main` ارسال شده‌اند
- تب GitHub Actions را برای وضعیت جریان کاری بررسی کنید
- اطلاعات اعتبار جریان کاری ترجمه را بررسی کنید
- ترجمه به صورت خودکار انجام می‌شود؛ فایل‌های ترجمه را به صورت دستی ویرایش نکنید

### تصاویر بارگذاری نمی‌شوند

- اطمینان حاصل کنید که مسیر تصویر از اسلش‌های جلو استفاده می‌کند: `images/filename.png`
- بررسی کنید که فایل تصویر به مخزن ارسال شده باشد
- اطمینان حاصل کنید که نام فایل تصویر دقیقاً مطابقت دارد (حساس به حروف بزرگ و کوچک)
- از مسیرهای نسبی استفاده کنید، نه URLهای مطلق

### Docsify نمایش نمی‌دهد

- بررسی کنید که `index.html` در دایرکتوری اصلی موجود باشد
- اطمینان حاصل کنید که لینک‌های CDN Docsify قابل دسترسی هستند
- بررسی کنید که فایل‌های Markdown از سینتکس استاندارد استفاده می‌کنند
- کنسول مرورگر را برای خطاهای JavaScript بررسی کنید

### لینک‌ها کار نمی‌کنند

- از URLهای کامل GitHub برای ارجاعات متقابل بین درس‌ها استفاده کنید
- فرمت: `https://github.com/microsoft/Security-101/blob/main/[file].md`
- لینک‌ها را در نمای رندر شده آزمایش کنید، نه فقط در Markdown خام

## نگهداری پروژه

### وظایف منظم

- بررسی و ادغام مشارکت‌های جامعه
- به‌روزرسانی محتوا برای دقت با توجه به تغییرات در چشم‌انداز امنیتی
- نظارت بر جریان کاری ترجمه برای خطاها
- پاسخ به مشکلات و بحث‌ها
- به‌روزرسانی لینک‌های خارجی

### کنترل نسخه

- شاخه `main` محافظت شده است و نیاز به بررسی درخواست کشش دارد
- همه تغییرات از طریق فرآیند درخواست کشش انجام می‌شود
- فایل‌های ترجمه به صورت خودکار تولید می‌شوند، به صورت دستی ویرایش نکنید
- از پیام‌های معنادار برای کامیت‌ها استفاده کنید

## نکات برای عوامل کدنویسی هوش مصنوعی

- **این یک پروژه مستنداتی است** - تمرکز بر کیفیت محتوا، نه کد
- **فایل‌های ترجمه را تغییر ندهید** - آنها به صورت خودکار تولید می‌شوند
- **قراردادهای نام‌گذاری فایل‌ها را حفظ کنید** - از فاصله در نام فایل‌ها مطابق الگوی موجود استفاده کنید
- **README.md را به‌روزرسانی کنید** هنگام اضافه/حذف ماژول‌ها برای هماهنگی جدول
- **به صورت محلی آزمایش کنید** قبل از ارسال درخواست کشش برای اطمینان از نمایش صحیح Markdown
- **از سبک محتوای موجود پیروی کنید** - لحن مناسب برای مبتدیان و بی‌طرفی فروشنده را حفظ کنید
- **نیازی به فرآیند ساخت نیست** - یک سرور HTTP ساده برای توسعه محلی کافی است
- **ساختار ماژول را رعایت کنید** - هر ماژول دارای شماره‌گذاری و سازمان‌دهی منظم است

---

**سلب مسئولیت**:  
این سند با استفاده از سرویس ترجمه هوش مصنوعی [Co-op Translator](https://github.com/Azure/co-op-translator) ترجمه شده است. در حالی که ما تلاش می‌کنیم دقت را حفظ کنیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است شامل خطاها یا نادرستی‌ها باشند. سند اصلی به زبان اصلی آن باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، ترجمه حرفه‌ای انسانی توصیه می‌شود. ما مسئولیتی در قبال سوء تفاهم‌ها یا تفسیرهای نادرست ناشی از استفاده از این ترجمه نداریم.