Security-101 / bg

<!--
CO_OP_TRANSLATOR_METADATA:
{
  "original_hash": "913da05fee7fb78699c0447cf6d8aa10",
  "translation_date": "2025-10-12T09:45:01+00:00",
  "source_file": "AGENTS.md",
  "language_code": "bg"
}
-->
# AGENTS.md

## Преглед на проекта

**Security-101** е учебна програма за начинаещи в областта на киберсигурността, създадена от Microsoft. Проектът представлява ресурс за обучение, базиран на документация, който преподава основни концепции за киберсигурност чрез структурирани модули. Той е независим от доставчици и е проектиран да бъде завършен в кратки уроци (30-60 минути всеки).

**Основни технологии:**
- Markdown за съдържание
- Docsify за генериране на статични сайтове
- GitHub Pages за хостинг
- Co-op Translator за поддръжка на много езици (50+ езика)
- GitHub Actions за CI/CD

**Архитектура:**
- Образователно съдържание, организирано в 8 основни модула, всеки с подуроци
- Статичен 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:** Основни концепции за сигурност (1.1-1.7)
- **Модул 2:** Управление на идентичност и достъп (2.1-2.4)
- **Модул 3:** Мрежова сигурност (3.1-3.4)
- **Модул 4:** Операции по сигурност (4.1-4.4)
- **Модул 5:** Сигурност на приложенията (5.1-5.3)
- **Модул 6:** Сигурност на инфраструктурата (6.1-6.3)
- **Модул 7:** Сигурност на данните (7.1-7.3)
- **Модул 8:** Сигурност на AI (8.1-8.4)

Всеки модул завършва с файл за тест (например "1.7 End of module quiz.md").

### Промени в съдържанието

1. Редактирайте Markdown файловете директно в основната директория
2. Следвайте съществуващата конвенция за именуване: `[module].[lesson] [Title].md`
3. Актуализирайте таблицата в README.md, ако добавяте/премахвате модули
4. Добавяйте изображения в директорията `/images/`
5. Реферирайте изображенията с относителни пътища: `![Описание](../../translated_images/filename.8c8067c683396b6f17b14be6dc5b8b323f661a863de696f36ec51e4813657b57.bg.png)`

## Работен процес за превод

**Автоматизиран превод:**
- Преводите се обработват автоматично от GitHub Action Co-op Translator
- Когато направите промени в `main` клона, работният процес превежда съдържанието на 50+ езика
- Преведените файлове се съхраняват в `/translations/[language_code]/`
- Метаданните за превод се запазват в YAML frontmatter

**Поддържани езици:** Арабски, Бенгалски, Български, Бирмански, Китайски (опростен, традиционен), Хърватски, Чешки, Датски, Холандски, Естонски, Фински, Френски, Немски, Гръцки, Иврит, Хинди, Унгарски, Индонезийски, Италиански, Японски, Корейски, Литовски, Малайски, Маратхи, Непалски, Норвежки, Персийски, Полски, Португалски, Панджаби, Румънски, Руски, Сръбски, Словашки, Словенски, Испански, Свахили, Шведски, Тагалог, Тамилски, Тайландски, Турски, Украински, Урду, Виетнамски и други.

**Не редактирайте ръчно преведените файлове** - те ще бъдат презаписани от автоматизирания процес.

## Насоки за стил на код

### Конвенции за Markdown

- Използвайте стандартен Markdown синтаксис
- Заглавия: Използвайте `#` за основно заглавие, `##` за секции, `###` за подсекции
- Списъци: Използвайте `-` или `*` за неупорядъчени списъци, `1.` за подредени списъци
- Връзки: Използвайте описателен текст с пълни GitHub URL адреси за кръстосани препратки
- Изображения: Съхранявайте в директорията `/images/`, използвайте описателен alt текст
- Кодови блокове: Използвайте тройни обратни кавички с идентификатор на езика, когато е приложимо

### Насоки за съдържание

- Дръжте уроците фокусирани и кратки (30-60 минути за четене)
- Използвайте ясен, подходящ за начинаещи език
- Избягвайте инструкции за инструменти, специфични за доставчици (учебната програма е независима от доставчици)
- Включвайте учебни цели в началото на всеки модул
- Препращайте към външни ресурси на 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 файлове на 50+ езика

**Необходими променливи на средата:**
- Удостоверения за Azure AI Service (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

## Насоки за Pull Request

### Преди подаване

1. **Преглед на съдържанието:** Уверете се в точността и яснотата на концепциите за киберсигурност
2. **Форматиране:** Проверете дали Markdown форматирането се рендира правилно
3. **Връзки:** Тествайте всички вътрешни и външни връзки
4. **Изображения:** Уверете се, че всички изображения се зареждат и имат описателен alt текст
5. **Последователност:** Следвайте съществуващата структура и стил на съдържанието

### Формат на заглавията на PR

Използвайте описателни заглавия:
- `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.bg.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. **Достъпност:** Уверете се в правилната йерархия на заглавията и alt текста

### Локален преглед

```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, когато е възможно
- [ ] Изображенията имат описателен alt текст
- [ ] Съдържанието е подходящо за начинаещи и точно
- [ ] Запазен е неутралният език спрямо доставчици
- [ ] README.md е актуализиран, ако се добавят/премахват модули
- [ ] Именуването на файловете следва конвенциите

## Съображения за сигурност

- **Без тайни в съдържанието:** Никога не комитвайте API ключове, пароли или чувствителни данни
- **Валидация на връзките:** Уверете се, че всички външни връзки са към надеждни източници
- **Съдържание на изображения:** Проверете дали изображенията не съдържат чувствителна информация
- **Процес на превод:** Използва Azure AI услуги с правилно удостоверяване
- **SECURITY.md:** Следвайте процеса за докладване на уязвимости в SECURITY.md

## Допълнителни ресурси

### Свързани курсове на Microsoft

Тази учебна програма е част от по-голяма колекция от образователни ресурси на Microsoft:
- Генеративен AI за начинаещи
- AI за начинаещи
- Наука за данни за начинаещи
- Машинно обучение за начинаещи
- Уеб разработка за начинаещи
- IoT за начинаещи

### Външни учебни пътеки

След завършване на Security-101:
- [Основи на сигурността, съответствието и идентичността на Microsoft](https://learn.microsoft.com/training/paths/describe-concepts-of-security-compliance-identity/)
- [Изпит SC-900: Основи на сигурността, съответствието и идентичността на Microsoft](https://learn.microsoft.com/credentials/certifications/exams/sc-900/)

## Принос

1. **Fork на хранилището** в GitHub
2. **Създайте feature клон** за вашите промени
3. **Направете промените си** следвайки горните насоки
4. **Тествайте локално** за да се уверите, че всичко се рендира правилно
5. **Подайте pull request** с ясно описание на промените
6. **Отговаряйте на обратната връзка** от поддържащите

## Чести проблеми и отстраняване на неизправности

### Преводите не работят

- Уверете се, че промените са качени в `main` клона
- Проверете таба GitHub Actions за статус на процеса
- Уверете се, че тайните за процеса на превод са конфигурирани
- Преводът се случва автоматично; не редактирайте ръчно преведените файлове

### Изображенията не се зареждат

- Проверете дали пътят на изображението използва наклонени черти: `images/filename.png`
- Уверете се, че файлът с изображението е качен в хранилището
- Проверете дали името на файла съвпада точно (чувствително към главни/малки букви)
- Използвайте относителни пътища, а не абсолютни URL адреси

### Docsify не рендира

- Проверете дали `index.html` е наличен в основната директория
- Уверете се, че Docsify CDN връзките са достъпни
- Проверете дали Markdown файловете използват стандартен синтаксис
- Проверете конзолата на браузъра за JavaScript грешки

### Връзките не работят

- Използвайте пълни GitHub URL адреси за кръстосани препратки между уроци
- Формат: `https://github.com/microsoft/Security-101/blob/main/[file].md`
- Тествайте връзките в рендирания изглед, а не само в суровия Markdown

## Поддръжка на проекта

### Редовни задачи

- Преглед и сливане на приноси от общността
- Актуализиране на съдържанието за точност с развитието на пейзажа на сигурността
- Мониторинг на процеса на превод за грешки
- Отговаряне на въпроси и дискусии
- Поддържане на актуалност на външните връзки

### Контрол на версиите

- `main` клонът е защитен и изисква прегледи на PR
- Всички промени преминават през процеса на pull request
- Преведените файлове се генерират автоматично, не ги редактирайте ръчно
- Използвайте смислени съобщения за комит

## Бележки за AI агенти за кодиране

- **Това е проект за документация** - фокусирайте се върху качеството на съдържанието, а не върху кода
- **Не модифицирайте преведените файлове** - те се генерират автоматично
- **Запазете конвенциите за именуване на файлове** - използвайте интервали в имената на файловете според съществуващия модел
- **Актуализирайте README.md** при добавяне/премахване на модули, за да поддържате таблицата синхронизирана
- **Тествайте локално** преди подаване на PR, за да се уверите, че Markdown се рендира правилно
- **Следвайте съществуващия стил на съдържание** - поддържайте подходящ за начинаещи, неутрален спрямо доставчици тон
- **Не е необходим процес на компилация** - прост HTTP сървър е достатъчен за локална разработка
- **Уважавайте структурата на модулите** - всеки модул има последователно номериране и организация

---

**Отказ от отговорност**:  
Този документ е преведен с помощта на AI услуга за превод [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да било недоразумения или погрешни интерпретации, произтичащи от използването на този превод.