Microsoft Graph'a Giriş

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

Anushika Agarwal

Cloud Data Engineer

Microsoft Graph nedir?

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

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

Microsoft Graph - Tüm servisler 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 birbirine 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çalarına ayıralım

  • İstek Bileşenleri:

    • Method: GET, POST, PATCH, vb.

    • Version: v1.0, beta

    • Resource: users, groups, vb.

    • Query Parameters: $select, $filter

    • Headers: Authorization, Content-Type

Microsoft Graph API İsteği

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

Methods

  • Desteklenen Methods:

    • 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, canlıda değil

`

Sürümleme - Beta

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

Resource

  • Etkileşime geçtiğin belirli veri.

  • Örnek:

    • Users: Kullanıcı bilgilerine eriş
      • /users, /me
    • Groups: Gruplarla çalış
      • /groups
    • Events: Takvim etkinliklerini getir
      • /users/{userId}/events

Users

Groups

Events

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

Sorgu parametreleri

  • Veriyi filtrelemek, sıralamak veya alan seçmek için seçenekler

  • Select:

    • Belirli alanları seç
    • $select=id,displayName

  • Filter:

    • Veriyi filtrele
    • $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

Headers

HTTP istekleri ve yanıtlarında üstbilgiyle meta veri taşır

İki tür üstbilgi: Standart ve API'ye Özel

Headers

  • 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...