ERETEK
BİLGİ SİSTEMLERİ
Entegrasyon, Bakım ve Danışmanlık

Microsoft Graph API Entegrasyonları

Microsoft Graph API ile Entra ID kullanıcı ve grupları, Teams, SharePoint, Outlook takvim ve posta, Intune cihaz bilgileri gibi Microsoft 365 verilerini kurumsal uygulamalara, portallara ve otomasyonlara bağlıyoruz. Uygulama kaydı, izin türü seçimi ve en az yetki ilkesi projenin merkezindedir.

Microsoft Graph
Entra ID app registration
OAuth 2.0
Delegated izinler
Application izinleri
Sites.Selected
Throttling
Change notifications
Hizmet tanımı

Microsoft Graph API entegrasyonu nedir, kimler için uygundur?

Microsoft Graph, Microsoft 365 hizmetlerine tek bir uç nokta (graph.microsoft.com) üzerinden erişim sağlayan REST API’dir. Uygulama Entra ID’de kaydedilir ve ya oturum açmış kullanıcı adına (delegated) ya da kullanıcı olmadan arka plan servisi olarak (application) izin alır. Yanlış izin tasarımı, bir uygulamanın tüm kiracıdaki e-postalara veya dosyalara erişebilmesine yol açabilir; bu nedenle izinler en dar kapsamla tasarlanmalıdır.

Bu hizmete en çok ihtiyaç duyan kuruluşlar

Çözdüğümüz kurumsal problemler

Aşırı geniş izinler

Bir rapor uygulamasına tüm kiracıda okuma/yazma yetkisi verilmiş.

Gizli anahtar yönetimi

İstemci gizli anahtarları kodda veya süresi dolmuş halde.

Throttling hataları

Toplu işlemler 429 yanıtlarıyla kesiliyor.

İzin tasarımı

Delegated mı, application mı?

Kullanıcının kendi verisiyle çalışan arayüzlerde delegated izinler, kullanıcı olmadan çalışan servislerde application izinleri kullanılır. Application izinlerinde kapsam daraltılır: SharePoint için Sites.Selected, posta için Exchange uygulama erişim ilkeleri gibi mekanizmalar tercih edilir. Ayrıntı için Microsoft Graph izinleri rehberimize bakabilirsiniz.

Microsoft Graph API entegrasyonu kapsamında neler yapıyoruz?

Senaryo ve izin analizi

Gerekli veri, işlem türü, kullanıcı bağlamı ve en dar izin seti.

Uygulama kaydı

Entra ID uygulama kaydı, sertifika tabanlı kimlik doğrulama veya yönetilen kimlik, yönetici onayı.

Geliştirme

Graph SDK veya REST, sayfalama, toplu (batch) istekler, değişiklik bildirimleri (webhook) ve delta sorguları.

Dayanıklılık

Throttling (429) için Retry-After’a uyan yeniden deneme, hata yönetimi.

Güvenlik

Gizli anahtar/sertifika rotasyonu, Key Vault, koşullu erişim, denetim günlükleri.

Dokümantasyon

İzin gerekçeleri, sahiplik ve yıllık gözden geçirme kaydı.

Önce izinleri yazıyoruz, sonra kodu

Her izin bir gerekçe ve sahiple kaydedilir; yönetici onayı bu kayda dayanır. Entegrasyon Teams, helpdesk ve intranet projelerinde ortak kullanılır.

Sık kullanılan senaryolar ve izinler

Senaryo
Örnek izin
Not
Kullanıcı profili ve yönetici bilgisi
Örnek izin

User.Read.All (application) veya User.ReadBasic.All

Not

Mümkünse temel profil kapsamı

Belirli SharePoint sitesine yazma
Örnek izin

Sites.Selected + site bazlı yetki

Not

Tüm sitelere erişim verilmez

Teams kanal mesajı
Örnek izin

ChannelMessage.Send (delegated) veya Workflows

Not

Uygulama adına gönderimde kısıtlar var

Takvim / toplantı
Örnek izin

Calendars.ReadWrite

Not

Exchange erişim ilkesiyle daraltma

Intune cihaz bilgisi
Örnek izin

DeviceManagementManagedDevices.Read.All

Not

Lisans ve rol gereksinimi

İzin adları ve davranışları Microsoft Learn Graph izin referansıyla uygulama sırasında yeniden doğrulanır.

Sizden beklediğimiz girdiler

Çalışmanın hızlı ve doğru ilerlemesi için başlangıçta aşağıdaki bilgi ve erişimlere ihtiyaç duyarız. Eksik olanları birlikte tamamlarız.

Somut proje çıktıları

İzin analizi ve gerekçe kaydı
Entra ID uygulama kaydı
Entegrasyon kodu
Gizli bilgi yönetimi
Hata ve throttling yönetimi
Dokümantasyon

Teslim edilen dokümantasyon

İzin envanteri
İşletim ve rotasyon kılavuzu

Canlıya geçişten sonra işletilecek kontroller

Proje bittiğinde sistemin sağlıklı kalması için aşağıdaki kontroller sahiplerine devredilir; istenirse bakım sözleşmesiyle Eretek tarafından yürütülür.

Sık sorulan sorular

Application izinleri ve bazı delegated izinler için evet; onay gerekçeli izin kaydıyla verilir.

Mümkünse sertifika veya yönetilen kimlik; gizli anahtar kullanılıyorsa kısa ömür ve güvenli depolama.

Çoğu API Microsoft 365 lisansıyla kullanılabilir; bazı tüketim bazlı (metered) API’ler ve veri türleri ek ücret veya lisans gerektirebilir.

Hizmet özeti
Microsoft Graph API Entegrasyonları

Entra, Teams, SharePoint ve Outlook işlevlerini kurumsal uygulamalarla ilişkilendirme.

Çalışma modeli

Geliştirme projesi + güvenlik gözden geçirmesi

Önemli not

Bazı Graph API’leri ve veri türleri ek lisans gerektirebilir; uygulama izinleri kiracı yöneticisi onayı gerektirir.

Proje aşamaları

Nasıl ilerliyoruz?

01 / AŞAMA

Analiz

Senaryo ve izinler.

02 / AŞAMA

Kayıt

Uygulama ve onay.

03 / AŞAMA

Geliştirme

Kod ve testler.

04 / AŞAMA

Devir

Dokümantasyon ve izleme.

Microsoft 365 verilerinizi uygulamalarınıza güvenle bağlayalım.

Hangi Microsoft 365 verisine, hangi uygulamadan erişmek istediğinizi dinliyor; izin modeli ve mimariyi öneriyoruz.