Security-101 / th

<!--
CO_OP_TRANSLATOR_METADATA:
{
  "original_hash": "913da05fee7fb78699c0447cf6d8aa10",
  "translation_date": "2025-10-12T09:36:34+00:00",
  "source_file": "AGENTS.md",
  "language_code": "th"
}
-->
# 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
- ไม่ต้องใช้เครื่องมือสร้างหรือตัวจัดการแพ็กเกจสำหรับเนื้อหาหลัก

## โครงสร้างของ Repository

```
/
├── 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
```

## คำสั่งการตั้งค่า

นี่เป็นโครงการเอกสารที่ไม่มีการติดตั้ง dependencies ในการทำงานกับเนื้อหา:

```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.th.png)`

## กระบวนการแปล

**การแปลอัตโนมัติ:**
- การแปลดำเนินการโดยอัตโนมัติผ่าน Co-op Translator GitHub Action
- เมื่อคุณส่งการเปลี่ยนแปลงไปยังสาขา `main` กระบวนการจะทำการแปลเนื้อหาเป็นมากกว่า 50 ภาษา
- ไฟล์ที่แปลแล้วจะถูกจัดเก็บใน `/translations/[language_code]/`
- เมตาดาต้าการแปลจะถูกเก็บรักษาไว้ใน YAML frontmatter

**ภาษาที่รองรับ:** อาหรับ, เบงกาลี, บัลแกเรีย, พม่า, จีน (ตัวย่อ, ตัวเต็ม), โครเอเชีย, เช็ก, เดนมาร์ก, ดัตช์, เอสโตเนีย, ฟินแลนด์, ฝรั่งเศส, เยอรมัน, กรีก, ฮิบรู, ฮินดี, ฮังการี, อินโดนีเซีย, อิตาลี, ญี่ปุ่น, เกาหลี, ลิทัวเนีย, มาเลย์, มราฐี, เนปาล, นอร์เวย์, เปอร์เซีย, โปแลนด์, โปรตุเกส, ปัญจาบ, โรมาเนีย, รัสเซีย, เซอร์เบีย, สโลวัก, สโลวีเนีย, สเปน, สวาฮีลี, สวีเดน, ตากาล็อก, ทมิฬ, ไทย, ตุรกี, ยูเครน, อูรดู, เวียดนาม และอื่น ๆ

**ห้ามแก้ไขไฟล์แปลด้วยตนเอง** - ไฟล์เหล่านี้จะถูกเขียนทับโดยกระบวนการอัตโนมัติ

## แนวทางการเขียนโค้ด

### รูปแบบ Markdown

- ใช้ไวยากรณ์ Markdown มาตรฐาน
- หัวข้อ: ใช้ `#` สำหรับชื่อเรื่องหลัก, `##` สำหรับส่วน, `###` สำหรับส่วนย่อย
- รายการ: ใช้ `-` หรือ `*` สำหรับรายการแบบไม่เรียงลำดับ, `1.` สำหรับรายการแบบเรียงลำดับ
- ลิงก์: ใช้ข้อความที่อธิบายพร้อม URL GitHub เต็มรูปแบบสำหรับการอ้างอิงข้าม
- ภาพ: เก็บในไดเรกทอรี `/images/` ใช้ข้อความ alt ที่อธิบาย
- บล็อกโค้ด: ใช้ backticks สามตัวพร้อมตัวระบุภาษาเมื่อเหมาะสม

### แนวทางเนื้อหา

- ทำให้บทเรียนมีจุดเน้นและกระชับ (เวลาอ่าน 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 Workflows

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

**Trigger:** การส่งไปยังสาขา `main`  
**Purpose:** แปลไฟล์ Markdown ใหม่/ที่แก้ไขเป็นมากกว่า 50 ภาษาโดยอัตโนมัติ

**Environment Variables ที่จำเป็น:**
- ข้อมูลรับรองบริการ Azure AI (AZURE_AI_SERVICE_API_KEY, AZURE_AI_SERVICE_ENDPOINT)
- ข้อมูลรับรอง Azure OpenAI (ทางเลือก)
- ข้อมูลรับรอง OpenAI (ทางเลือก)

### Deploy (deploy.yaml)

**Trigger:** การส่งไปยังสาขา `main` เมื่อ README.md มีการเปลี่ยนแปลง  
**Purpose:** เผยแพร่เว็บไซต์แบบสถิตไปยัง GitHub Pages  
**Output:** อัปเดตเว็บไซต์ GitHub Pages

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

**Trigger:** การส่งไปยังสาขาที่กำหนด  
**Purpose:** สร้างและเผยแพร่เว็บไซต์โดยใช้ Jekyll

## แนวทางการส่ง Pull Request

### ก่อนการส่ง

1. **ตรวจสอบเนื้อหา:** ตรวจสอบความถูกต้องและความชัดเจนของแนวคิดด้านความปลอดภัยไซเบอร์
2. **การจัดรูปแบบ:** ตรวจสอบว่า Markdown มีการจัดรูปแบบที่แสดงผลได้ถูกต้อง
3. **ลิงก์:** ทดสอบลิงก์ทั้งหมดทั้งภายในและภายนอก
4. **ภาพ:** ตรวจสอบให้แน่ใจว่าภาพทั้งหมดโหลดได้และมีข้อความ alt ที่อธิบาย
5. **ความสม่ำเสมอ:** ปฏิบัติตามโครงสร้างและรูปแบบเนื้อหาที่มีอยู่

### รูปแบบชื่อ PR

ใช้ชื่อที่อธิบาย:
- `Add: [คำอธิบายเนื้อหาใหม่]`
- `Update: [Module/Lesson] - [คำอธิบายสั้น ๆ]`
- `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.th.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
```

### รายการตรวจสอบก่อนการ commit

- [ ] ไฟล์ Markdown ใช้ไวยากรณ์ที่ถูกต้อง
- [ ] ลิงก์ทั้งหมดถูกต้องและใช้ HTTPS เมื่อเป็นไปได้
- [ ] ภาพมีข้อความ alt ที่อธิบาย
- [ ] เนื้อหาเหมาะสำหรับผู้เริ่มต้นและถูกต้อง
- [ ] ใช้ภาษาที่เป็นกลางต่อผู้ให้บริการ
- [ ] อัปเดต README.md หากเพิ่ม/ลบโมดูล
- [ ] การตั้งชื่อไฟล์เป็นไปตามรูปแบบที่กำหนด

## การพิจารณาด้านความปลอดภัย

- **ไม่มีข้อมูลลับในเนื้อหา:** ห้าม commit API keys, รหัสผ่าน หรือข้อมูลที่ละเอียดอ่อน
- **การตรวจสอบลิงก์:** ตรวจสอบให้แน่ใจว่าลิงก์ภายนอกทั้งหมดเป็นแหล่งข้อมูลที่เชื่อถือได้
- **เนื้อหาภาพ:** ตรวจสอบให้แน่ใจว่าภาพไม่มีข้อมูลที่ละเอียดอ่อน
- **กระบวนการแปล:** ใช้บริการ Azure AI พร้อมการรับรองความถูกต้องที่เหมาะสม
- **SECURITY.md:** ปฏิบัติตามกระบวนการรายงานช่องโหว่ใน SECURITY.md

## แหล่งข้อมูลเพิ่มเติม

### หลักสูตรที่เกี่ยวข้องของ Microsoft

หลักสูตรนี้เป็นส่วนหนึ่งของคอลเลกชันทรัพยากรการศึกษาของ Microsoft:
- Generative AI for Beginners
- AI for Beginners
- Data Science for Beginners
- ML for Beginners
- Web Dev for Beginners
- IoT for Beginners

### เส้นทางการเรียนรู้ภายนอก

หลังจากจบ 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. **Fork repository** บน GitHub
2. **สร้าง feature branch** สำหรับการเปลี่ยนแปลงของคุณ
3. **ทำการเปลี่ยนแปลง** ตามแนวทางที่ระบุไว้ข้างต้น
4. **ทดสอบในเครื่อง** เพื่อให้แน่ใจว่าทุกอย่างแสดงผลได้ถูกต้อง
5. **ส่ง pull request** พร้อมคำอธิบายการเปลี่ยนแปลงที่ชัดเจน
6. **ตอบกลับความคิดเห็น** จากผู้ดูแล

## ปัญหาทั่วไปและการแก้ไข

### การแปลไม่ทำงาน

- ตรวจสอบให้แน่ใจว่าการเปลี่ยนแปลงถูกส่งไปยังสาขา `main`
- ตรวจสอบสถานะ workflow ในแท็บ GitHub Actions
- ตรวจสอบการตั้งค่าความลับของ workflow การแปล
- การแปลเกิดขึ้นโดยอัตโนมัติ ห้ามแก้ไขไฟล์แปลด้วยตนเอง

### ภาพไม่โหลด

- ตรวจสอบเส้นทางภาพใช้เครื่องหมายทับไปข้างหน้า: `images/filename.png`
- ตรวจสอบว่าไฟล์ภาพถูก commit ไปยัง repository
- ตรวจสอบให้แน่ใจว่าชื่อไฟล์ภาพตรงกัน (case-sensitive)
- ใช้เส้นทางสัมพัทธ์ ไม่ใช่ URL แบบสัมบูรณ์

### Docsify ไม่แสดงผล

- ตรวจสอบว่า `index.html` อยู่ใน root
- ตรวจสอบว่า Docsify CDN links เข้าถึงได้
- ตรวจสอบว่าไฟล์ Markdown ใช้ไวยากรณ์มาตรฐาน
- ตรวจสอบข้อผิดพลาด JavaScript ในคอนโซลของเบราว์เซอร์

### ลิงก์ไม่ทำงาน

- ใช้ URL GitHub เต็มรูปแบบสำหรับการอ้างอิงข้ามระหว่างบทเรียน
- รูปแบบ: `https://github.com/microsoft/Security-101/blob/main/[file].md`
- ทดสอบลิงก์ในมุมมองที่แสดงผล ไม่ใช่แค่ใน Markdown ดิบ

## การดูแลโครงการ

### งานประจำ

- ตรวจสอบและรวมการมีส่วนร่วมจากชุมชน
- อัปเดตเนื้อหาให้ถูกต้องตามการเปลี่ยนแปลงในภูมิทัศน์ด้านความปลอดภัย
- ตรวจสอบ workflow การแปลเพื่อหาข้อผิดพลาด
- ตอบกลับปัญหาและการอภิปราย
- รักษาลิงก์ภายนอกให้ทันสมัย

### การควบคุมเวอร์ชัน

- สาขา `main` ได้รับการป้องกันและต้องผ่านการตรวจสอบ PR
- การเปลี่ยนแปลงทั้งหมดต้องผ่านกระบวนการ pull request
- ไฟล์แปลถูกสร้างโดยอัตโนมัติ ห้ามแก้ไขด้วยตนเอง
- ใช้ข้อความ commit ที่มีความหมาย

## หมายเหตุสำหรับ AI Coding Agents

- **นี่เป็นโครงการเอกสาร** - เน้นคุณภาพของเนื้อหา ไม่ใช่โค้ด
- **ห้ามแก้ไขไฟล์แปล** - ไฟล์เหล่านี้ถูกสร้างโดยอัตโนมัติ
- **รักษารูปแบบการตั้งชื่อไฟล์** - ใช้ช่องว่างในชื่อไฟล์ตามรูปแบบที่มีอยู่
- **อัปเดต README.md** เมื่อเพิ่ม/ลบโมดูลเพื่อให้ตารางตรงกัน
- **ทดสอบในเครื่อง** ก่อนส่ง PR เพื่อให้แน่ใจว่า Markdown แสดงผลได้ถูกต้อง
- **ปฏิบัติตามรูปแบบเนื้อหาที่มีอยู่** - รักษาโทนที่เหมาะสำหรับผู้เริ่มต้นและเป็นกลางต่อผู้ให้บริการ
- **ไม่ต้องใช้กระบวนการ build** - เซิร์ฟเวอร์ HTTP ธรรมดาเพียงพอสำหรับการพัฒนาในเครื่อง
- **เคารพโครงสร้างโมดูล** - แต่ละโมดูลมีการจัดลำดับและการจัดระเบียบที่สม่ำเสมอ

---

**ข้อจำกัดความรับผิดชอบ**:  
เอกสารนี้ได้รับการแปลโดยใช้บริการแปลภาษา AI [Co-op Translator](https://github.com/Azure/co-op-translator) แม้ว่าเราจะพยายามให้การแปลมีความถูกต้อง แต่โปรดทราบว่าการแปลอัตโนมัติอาจมีข้อผิดพลาดหรือความไม่ถูกต้อง เอกสารต้นฉบับในภาษาต้นทางควรถือเป็นแหล่งข้อมูลที่เชื่อถือได้ สำหรับข้อมูลที่สำคัญ แนะนำให้ใช้บริการแปลภาษามนุษย์ที่เป็นมืออาชีพ เราจะไม่รับผิดชอบต่อความเข้าใจผิดหรือการตีความผิดพลาดที่เกิดจากการใช้การแปลนี้