แนะนำ Microsoft Graph

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

Anushika Agarwal

Cloud Data Engineer

Microsoft Graph คืออะไร?

  • API แบบรวมศูนย์สำหรับเข้าถึง ข้อมูล Microsoft 365

  • Endpoint เดียว สำหรับทุกบริการ

Microsoft Graph - One endpoint for all services

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

ตัวอย่าง: PeopleSphere กับ Microsoft Graph

  • PeopleSphere ใช้งาน:

    • Outlook สำหรับคำขอลางาน
    • Teams สำหรับการประชุม HR
    • OneDrive สำหรับสลิปเงินเดือน

  • Graph เชื่อมต่อทั้งหมดเข้าด้วยกัน

วิธีที่ PeopleSphere ใช้ Microsoft Graph

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

โครงสร้างของการเรียก Graph API

Unified API: Endpoint เดียวสำหรับเข้าถึงทรัพยากรบริการ Microsoft Cloud Microsoft Graph API Request

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

วิเคราะห์โครงสร้าง Request

  • ส่วนประกอบของ Request:

    • Method: GET, POST, PATCH เป็นต้น

    • Version: v1.0, beta

    • Resource: users, groups เป็นต้น

    • Query Parameters: $select, $filter

    • Headers: Authorization, Content-Type

Microsoft Graph API Request

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

Methods

  • Method ที่รองรับ:

    • GET: ดึงข้อมูล

    • POST: สร้างข้อมูลใหม่

    • PUT: แทนที่ข้อมูลทั้งหมด

    • PATCH: อัปเดตข้อมูลที่มีอยู่

    • DELETE: ลบข้อมูล

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

เวอร์ชัน: v1.0

  • https://graph.microsoft.com/v1.0/groups

  • API ที่ เสถียร

  • API ที่พร้อมใช้งานทั่วไป
  • ใช้กับ แอปในระดับ production

Versioning - v1.0

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

เวอร์ชัน: beta

beta

  • https://graph.microsoft.com/beta/groups
  • ฟีเจอร์ Preview ที่ยัง ทดลองอยู่
  • ไม่เสถียร อาจเกิดข้อผิดพลาดได้
  • ใช้เพื่อ ทดสอบเท่านั้น ไม่ใช่ production

`

Versioning - Beta

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

Resource

  • ข้อมูลเฉพาะที่ต้องการเข้าถึง

  • ตัวอย่าง:

    • Users: เข้าถึงข้อมูลผู้ใช้
      • /users, /me
    • Groups: จัดการกลุ่ม
      • /groups
    • Events: ดึงข้อมูลกิจกรรมในปฏิทิน
      • /users/{userId}/events

Users

Groups

Events

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

Query Parameters

  • ตัวเลือกสำหรับกรอง เรียงลำดับ หรือเลือกข้อมูลเฉพาะ

  • Select:

    • เลือก field ที่ต้องการ
    • $select=id,displayName

  • Filter:

    • กรองข้อมูล
    • $filter=startswith(displayName, 'John')

  • Top:

    • จำกัดจำนวนผลลัพธ์
    • $top=5

Query Parameters - Select

  Query Parameters - Filter

  Query Parameters - Top

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

Headers

ส่ง metadata ใน HTTP request และ response

Header มี 2 ประเภท: Standard และ API-Specific

Headers

  • Standard: ใช้ร่วมกันใน request ทุกประเภท
    • Authorization: Bearer {access_token}
    • Content-Type: application/json
  • API-Specific: แตกต่างกันตาม API
    • Retry-After: 30
    • Location: https://graph.microsoft.com/operationStatus
การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

มาฝึกกันเถอะ!

การรักษาความปลอดภัยบน Azure สำหรับนักพัฒนา

Preparing Video For Download...