Pengantar Microsoft Graph

Menerapkan Keamanan Azure untuk Pengembang

Anushika Agarwal

Cloud Data Engineer

Apa itu Microsoft Graph?

  • API terpadu untuk mengakses data Microsoft 365

  • Satu endpoint untuk semua layanan

Microsoft Graph - Satu endpoint untuk semua layanan

Menerapkan Keamanan Azure untuk Pengembang

Contoh: PeopleSphere dengan Microsoft Graph

  • PeopleSphere menggunakan:

    • Outlook untuk permintaan cuti
    • Teams untuk rapat HR
    • OneDrive untuk slip gaji

  • Graph menghubungkan semuanya

Cara PeopleSphere menggunakan Microsoft Graph

Menerapkan Keamanan Azure untuk Pengembang

Anatomi panggilan Graph API

API terpadu: Satu endpoint untuk mengakses resource layanan Microsoft Cloud Permintaan Microsoft Graph API

Menerapkan Keamanan Azure untuk Pengembang

Mengurai request

  • Komponen request:

    • Method: GET, POST, PATCH, dll.

    • Version: v1.0, beta

    • Resource: users, groups, dll.

    • Parameter kueri: $select, $filter

    • Header: Authorization, Content-Type

Permintaan Microsoft Graph API

Menerapkan Keamanan Azure untuk Pengembang

Metode

  • Metode yang didukung:

    • GET: Mengambil data

    • POST: Membuat data baru

    • PUT: Mengganti data sepenuhnya

    • PATCH: Memperbarui data

    • DELETE: Menghapus data

Menerapkan Keamanan Azure untuk Pengembang

Penomoran versi: v1.0

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

  • API stabil

  • API umum tersedia
  • Digunakan untuk aplikasi produksi

Penomoran versi - v1.0

Menerapkan Keamanan Azure untuk Pengembang

Penomoran versi: beta

beta

  • https://graph.microsoft.com/beta/groups
  • Pratinjau, fitur eksperimental
  • Tidak stabil, bisa berubah
  • Hanya pengujian, bukan produksi

`

Penomoran versi - Beta

Menerapkan Keamanan Azure untuk Pengembang

Resource

  • Data spesifik yang Anda akses.

  • Contoh:

    • Users: Akses info pengguna
      • /users, /me
    • Groups: Kelola grup
      • /groups
    • Events: Ambil event kalender
      • /users/{userId}/events

Pengguna

Grup

Event

Menerapkan Keamanan Azure untuk Pengembang

Parameter kueri

  • Opsi untuk memfilter, mengurutkan, atau memilih data tertentu

  • Select:

    • Pilih field tertentu
    • $select=id,displayName

  • Filter:

    • Saring data
    • $filter=startswith(displayName, 'John')

  • Top:

    • Batasi jumlah hasil
    • $top=5

Parameter Kueri - Select

  Parameter Kueri - Filter

  Parameter Kueri - Top

Menerapkan Keamanan Azure untuk Pengembang

Header

Membawa metadata dalam request dan response HTTP

Dua jenis header: Standar & Khusus API

Header

  • Standar: Umum untuk semua request
    • Authorization: Bearer {access_token}
    • Content-Type: application/json
  • Khusus API: Bervariasi per API
    • Retry-After: 30
    • Location: https://graph.microsoft.com/operationStatus
Menerapkan Keamanan Azure untuk Pengembang

Ayo berlatih!

Menerapkan Keamanan Azure untuk Pengembang

Preparing Video For Download...