Microsoft Graph’a Giriş

Geliştiriciler için Azure Güvenliğini Uygulama

Anushika Agarwal

Cloud Data Engineer

Microsoft Graph nedir?

  • Microsoft 365 verisine erişim için birleşik API

  • Tüm hizmetler için tek uç nokta

Microsoft Graph - Tüm hizmetler için tek uç nokta

Geliştiriciler için Azure Güvenliğini Uygulama

Örnek: Microsoft Graph ile PeopleSphere

  • PeopleSphere şunları kullanır:

    • İzin talepleri için Outlook
    • İK toplantıları için Teams
    • Bordrolar için OneDrive

  • Graph hepsini bağlar

PeopleSphere Microsoft Graph’ı nasıl kullanır

Geliştiriciler için Azure Güvenliğini Uygulama

Bir Graph API çağrısının yapısı

Birleşik API: Microsoft Cloud hizmet kaynaklarına tek uç noktadan erişim Microsoft Graph API İsteği

Geliştiriciler için Azure Güvenliğini Uygulama

İsteği parçalara ayırma

  • İstek Bileşenleri:

    • Yöntem: GET, POST, PATCH, vb.

    • Sürüm: v1.0, beta

    • Kaynak: users, groups, vb.

    • Sorgu Parametreleri: $select, $filter

    • Başlıklar: Authorization, Content-Type

Microsoft Graph API İsteği

Geliştiriciler için Azure Güvenliğini Uygulama

Yöntemler

  • Desteklenen Yöntemler:

    • GET: Veri getir

    • POST: Yeni veri oluştur

    • PUT: Veriyi tamamen değiştir

    • PATCH: Mevcut veriyi güncelle

    • DELETE: Veriyi sil

Geliştiriciler için Azure Güvenliğini Uygulama

Sürümleme: v1.0

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

  • Kararlı API’ler

  • Genel kullanıma açık API’ler
  • Canlı uygulamalar için kullanılır

Sürümleme - v1.0

Geliştiriciler için Azure Güvenliğini Uygulama

Sürümleme: beta

beta

  • https://graph.microsoft.com/beta/groups
  • Önizleme, deneysel özellikler
  • Kararsız, bozulabilir
  • Yalnızca test için, üretim değil

`

Sürümleme - Beta

Geliştiriciler için Azure Güvenliğini Uygulama

Kaynak

  • Etkileşimde bulunduğunuz özel veri.

  • Örnek:

    • Kullanıcılar: Kullanıcı bilgilerine erişin
      • /users, /me
    • Gruplar: Gruplarla çalışın
      • /groups
    • Etkinlikler: Takvim etkinliklerini alın
      • /users/{userId}/events

Kullanıcılar

Gruplar

Etkinlikler

Geliştiriciler için Azure Güvenliğini Uygulama

Sorgu parametreleri

  • Belirli verileri filtreleme, sıralama veya seçme seçenekleri

  • Select:

    • Alanları seçin
    • $select=id,displayName

  • Filter:

    • Veriyi filtreleyin
    • $filter=startswith(displayName, 'John')

  • Top:

    • Sonuç sayısını sınırla
    • $top=5

Sorgu Parametreleri - Select

  Sorgu Parametreleri - Filter

  Sorgu Parametreleri - Top

Geliştiriciler için Azure Güvenliğini Uygulama

Başlıklar

HTTP istek ve yanıtlarda meta veri taşır

İki tür başlık: Standart ve API’ye Özel

Başlıklar

  • Standart: Tüm isteklerde ortak
    • Authorization: Bearer {access_token}
    • Content-Type: application/json
  • API’ye Özel: API’ye göre değişir
    • Retry-After: 30
    • Location: https://graph.microsoft.com/operationStatus
Geliştiriciler için Azure Güvenliğini Uygulama

Hadi pratik yapalım!

Geliştiriciler için Azure Güvenliğini Uygulama

Preparing Video For Download...