Microsoft Entegrasyonları: İzinler ve Yönetici Onayı
Microsoft izin türlerini anlayın, yönetici onayı verin ve ajan'ın Microsoft entegrasyonları için hangi izinleri istediğini inceleyin.
Yönetici onayı verilmeden hiçbir kullanıcı Microsoft entegrasyonu bağlayamaz. Kullanıcılar "Need admin approval" veya "Approval required" hatası görür.
Bu şu entegrasyonlar için geçerlidir: Excel, Microsoft Teams, OneDrive, Outlook Calendar, Outlook Email, Planner ve SharePoint.
İzin Türlerini Anlama
Microsoft iki tür OAuth izni kullanır:
| Tür | Kim hareket eder | Ne zaman kullanılır |
|---|---|---|
| Delegated | Kullanıcı kendi adına | Kullanıcı oturum açmıştır. Eylemler o kullanıcının erişim haklarıyla gerçekleşir. |
| Application | Uygulama kuruluş adına | Oturum açmış kullanıcı yoktur. Uygulamanın kendi erişimi vardır (ör. arka plan işleri). |
ajan temsil edilen (delegated) izinler kullanır. Bir Microsoft entegrasyonu bağladığınızda ajan sizin adınıza, mevcut erişim haklarınızla hareket eder — zaten erişiminiz olmayan verilere erişemez.
Yönetici Onayı Verme
Kullanıcılar Microsoft entegrasyonlarını bağlamadan önce bir Microsoft yöneticisinin kiracı geneli onay vermesi gerekir.
Önkoşul: Bir kullanıcının veya yöneticinin en az bir kez bir entegrasyonu bağlamayı denemiş olması gerekir. Bu, kiracınızda ajan Service Principal'ının oluşturulmasını tetikler.
Microsoft Entra'yı açın
Cloud Application Administrator veya Global Administrator olarak Microsoft Entra yönetim merkezine oturum açın.
ajan'ı bulun
Identity → Applications → Enterprise applications → All applications yoluna gidin ve ajan öğesini seçin.
Onay verin
Security altında Permissions seçin, ardından Grant admin consent for [Your Organization] düğmesine tıklayın.
ajan'da doğrulayın
ajan'da Workspace settings → Integrations yoluna gidin, Outlook Calendar gibi bir Microsoft entegrasyonu seçin ve çalıştığını doğrulamak için hesabınızı bağlayın.
Daha fazla ayrıntı için Microsoft'un kiracı geneli yönetici onayı verme belgelerine bakın.
Verilen İzinleri İnceleme
Onay verdikten sonra tüm izinleri Microsoft Entra'da inceleyebilirsiniz:
- Identity → Applications → Enterprise applications → ajan yoluna gidin
- Security altında Permissions düğmesine tıklayın
Type sütunu tüm ajan izinleri için "Delegated" gösterir — ajan'ın yalnızca oturum açmış kullanıcılar adına hareket ettiğini doğrular.
Entegrasyon Başına Gerekli İzinleri Görüntüleme
Her Microsoft entegrasyonu belirli izinler (kapsamlar) ister. Belirli bir entegrasyonun neye ihtiyaç duyduğunu görmek için:
- ajan'da Workspace settings → Integrations yoluna gidin
- Outlook Calendar gibi Microsoft entegrasyonunu seçin
- Scopes and Action Access bölümüne kaydırın
- Gerekli kapsamları incelemek için Scope view öğesini açın
Bu kapsamlar doğrudan Microsoft Graph izinlerine eşlenir.
Yaygın izinler
| İzin | Ne sağlar |
|---|---|
Calendars.ReadWrite | Takvim etkinliklerini okuma ve oluşturma |
Mail.ReadWrite | E-postaları okuma ve gönderme |
Files.ReadWrite.All | OneDrive/SharePoint dosyalarına erişim |
User.Read | Temel profilinizi okuma |
offline_access | Yeniden giriş olmadan erişimi sürdürme |
İzinleri Özelleştirme
Kuruluşunuz ajan varsayılanlarından farklı kapsamlar gerektiriyorsa kendi OAuth istemcinizi yapılandırabilirsiniz.
- Özel OAuth İstemcisi Yapılandırma — Hangi kapsamların isteneceğini tam kontrol etmek için kendi OAuth uygulamanızı kurun.