Ana içeriğe atla

Ortamınız için Microsoft 365 ayarlama

Microsoft 365’i AI-School ortamınıza bağlamanın iki yolu vardır. Önce kuruluşunuza hangi yolun uygun olduğunu seçin.

YolNe zamanNe yaparsınız
AI-School merkezi uygulaması (varsayılan)Outlook Mail, Outlook Takvim, Teams ve SharePoint/OneDrive için kişisel bağlantılar.Bir Entra yöneticisi Microsoft 365 bağla üzerinden kuruluş onayı verir. Ardından bu makalenin 5. adımında anlatıldığı gibi entegrasyonları açarsınız. Kendi uygulamanıza, client secret’a veya Identity Provider’a gerek yoktur.
Kendi Entra uygulamanızSharePoint klasörlerini merkezi olarak bilgi bankasına aktarmak istiyorsunuz, çalışanlar zaten kendi uygulamanızla Microsoft üzerinden giriş yapıyor, ya da uygulamayı kendiniz yönetmek istiyorsunuz.Bu makaleyi 1. adımdan itibaren izleyin.

Kuruluşunuz zaten kendi uygulamasıyla Microsoft üzerinden giriş yapıyorsa (ortamın Microsoft ID alanı doldurulmuşsa), tüm bağlantılar bu kendi uygulamasını kullanır. Bu durumda merkezi yol geçerli değildir.

Kendi Entra uygulamanız​

Kendi Microsoft Entra uygulamanızla kuruluşunuz aynı uygulamayı Microsoft ile oturum açma ve Outlook, Teams ve SharePoint için kullanabilir. Hangi entegrasyonların ve yazma işlemlerinin kullanılabilir olduğunu merkezi olarak belirlersiniz. Kullanıcılar daha sonra yalnızca kişisel bağlantılarını Tercihler → Araçlar → Bağlantılar bölümünde açıp kapatır.

Kişisel entegrasyonlar, OpenAI, Claude, Gemini ve Mistral’in desteklenen modelleriyle çalışır. Seçilen modelin araç kullanabilmesi gerekir. Kişisel bağlantılarda erişim, oturum açmış Microsoft kullanıcısının yetkilerini takip eder. Kuruluş onayı tüm çalışanları otomatik olarak oturum açmış saymaz ve yapay zekaya tüm posta kutularına bağımsız erişim vermez. Merkezi SharePoint bilgi bankası ayrı uygulama izinleri ve mevcut bilgi bankası izinlerini kullanır; bunlar aşağıda açıklanmıştır.

Neye ihtiyacınız var?​

  • Microsoft Entra ID’ye sahip bir Microsoft 365 kuruluşu ve istenen hizmetlere erişimi olan hesaplar.
  • Bir uygulama kaydetmeye ve seçilen Microsoft Graph izinleri için kuruluş onayı vermeye yetkili bir yönetici. Bunun için yalnızca bir Azure abonelik rolü yeterli değildir; Entra rolünüzün bu onayı vermesine izin vermesi gerekir.
  • Entegrasyonları kullanılabilir hale getirmek için doğru AI ortamında yönetici yetkileri.
  • Bu AI ortamı için Microsoft Identity Provider’ı Google Cloud Identity Platform’da ayarlayabilecek bir platform yöneticisi.
  • Kendi Microsoft dizininizde bir app registration, bir client secret ve doğru markaya ait iki yönlendirme URL’si.

Microsoft ile oturum açma ve Microsoft verilerine erişim iki ayrı işlevdir. Çalışan bir Microsoft girişi, Outlook, Teams veya SharePoint’in ayarlandığı anlamına gelmez.

1. Tek bir kuruluş uygulaması kaydedin​

Microsoft Entra yönetim merkezini açın ve App registrations → New registration bölümüne gidin. Tanınabilir bir ad kullanın; örneğin AI-School – kuruluş adınız. Kendi kuruluşunuz için Accounts in this organizational directory only (Single tenant) seçin.

Aşağıdaki bilgileri Overview bölümünden kaydedin:

BilgiNe için?
Directory (tenant) IDKuruluşunuzun Microsoft dizini; AI ortamının Microsoft ID alanına girer.
Application (client) IDKaydedilen uygulama; Microsoft Identity Provider’a girer.

Bu iki ID farklıdır. Microsoft ID alanına client ID’yi veya Firebase tenant ID’yi girmeyin.

2. Doğru yönlendirme URL’lerini ayarlayın​

Authentication → Add a platform → Web bölümüne gidin. Markanız için aşağıdaki iki URL’yi de, tam olarak gösterildiği gibi ekleyin. İlki oturum açmayı işler; ikincisi çalışma hesabı entegrasyonları için onayı işler.

MarkaMicrosoft ile oturum açmaÇalışma hesabı entegrasyonları
AI-Schoolhttps://ai-school-pro.firebaseapp.com/__/auth/handlerhttps://europe-west1-ai-school-pro.cloudfunctions.net/completeConnectorOAuth
AI-Corporatehttps://ai-corporate.firebaseapp.com/__/auth/handlerhttps://europe-west1-ai-corporate.cloudfunctions.net/completeConnectorOAuth
AI-Publichttps://ai-public-pro.firebaseapp.com/__/auth/handlerhttps://europe-west1-ai-public-pro.cloudfunctions.net/completeConnectorOAuth

Ortamınızın çalıştığı markanın URL’lerini kullanın. Kendi kuruluş adınızı veya tenant ID’nizi bu URL’lere girmeniz gerekmez. Website URL’si, dashboard URL’si ve .web.app URL’si bu callback’lerin yerini almaz. Bunları tarayıcıdan kullanıyor olsanız bile Web olarak kaydedin. Bunun için implicit token verme veya public client flow’u açmanız gerekmez.

3. Bir client secret oluşturun ve izinler verin​

Certificates & secrets → Client secrets → New client secret bölümüne gidin. Uygun bir süre seçin ve Value görünür görünmez güvenli bir yere kaydedin. Değeri platform yönetimi için kararlaştırılan güvenli kanaldan iletin; Secret ID client secret değildir. Son kullanım tarihini takip edin ve secret’ı bu tarihten önce, Identity Provider’da da değiştirin.

Ardından API permissions → Add a permission → Microsoft Graph → Delegated permissions bölümüne gidin. Yalnızca kuruluşunuzun sunacağı entegrasyon ve eylemler için gerekli izinleri ekleyin.

EntegrasyonOkuma izinleriYazma için ek izinler
Profil / temelUser.Read; giriş akışı ayrıca openid, profile, email ve offline_access isterYok
Outlook MailMail.ReadTaslaklar: Mail.ReadWrite. Gönderme: Mail.Send.
Outlook TakvimCalendars.ReadYazma: Calendars.ReadWrite.
Microsoft TeamsChat.Read, ChannelMessage.Read.AllGönderme: Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Send.
SharePoint / OneDriveSites.Read.All, Files.Read.AllBu çalışma hesabı entegrasyonu burada yazma işlemi sunmaz.

Mail.ReadWrite gönderme hakkı vermez; bunun için ayrıca Mail.Send gerekir. Teams gönderme, özel sohbet mesajları değil, seçilen bir kanala metin mesajı yazar. Bu entegrasyon için Application permissions değil, Delegated permissions kullanın. Adında All geçse bile, delegated erişim kullanıcının erişimiyle sınırlı kalır.

Grant admin consent for kuruluşunuz seçeneğine tıklayın ve seçilen izinlerin verilmiş olarak göründüğünü kontrol edin. Böylece çalışanlar onaylanmış erişimi kullanabilir ve kendilerinin kuruluş yetkisi vermesi gerekmez. Microsoft yine de politikanıza bağlı olarak oturum açma, MFA veya yeniden onay isteyebilir.

4. Uygulamayı AI ortamına iki yerde bağlayın​

Platform yöneticisinin doğru ortamı seçmesini ve şu ayarları yapmasını sağlayın:

  1. Admin → Omgeving → Tenant bölümünde: giriş yöntemi Microsoft’u açın ve Microsoft ID alanına Directory (tenant) ID’yi girin.
  2. Google Cloud → Identity Platform → ilgili tenant → Identity providers → Microsoft bölümünde: sağlayıcıyı açın ve aynı Entra uygulamasının Application (client) ID ve client secret Value alanlarını girin.

Identity Provider, başka bir kuruluşun ya da genel Admin ortamının değil, AI ortamınızın Firebase/Identity Platform tenant’ına aittir. Çalışma hesabı entegrasyonu bu sağlayıcıdaki uygulamayı yeniden kullanır. Client secret kullanıcı tercihlerinde, sohbet mesajlarında veya normal ortam alanlarında bulunmamalıdır.

Platform yönetimine kuruluş adını, markayı, Directory ID’yi, client ID’yi, secret değerini güvenli kanal üzerinden, son kullanım tarihini ve istenen entegrasyonları/izinleri iletin. Sadece bir app ID yeterli değildir.

5. Entegrasyonları ve yazma eylemlerini etkinleştirin​

Yönetim ortamınız → Tools → MCP bölümünü açın. Suite-snelkoppelingen altında Microsoft 365 entegrasyonunu açın. Microsoft satırları görünür olur; tüm suite kapalıysa bu satırlar gizli kalır.

Her entegrasyon için kullanılabilir olup olmadığını seçin. Schrijfacties sütununda ayrı ayrı şunları seçin:

  • Outlook Mail → Concepten: taslak oluşturma ve değiştirme.
  • Outlook Mail → Verzenden: mevcut bir taslağı gerçekten gönderme.
  • Outlook Agenda → Schrijven: randevu oluşturma ve değiştirme.
  • Microsoft Teams → Posten: seçilen bir Teams kanalına metin mesajı gönderme.

Opslaan’a tıklayın. Bir yazma eylemi yalnızca hem entegrasyon hem de ilgili yönetim izni açıksa, Microsoft gerekli izinleri verdiyse ve kullanıcı bağlantıyı kişisel olarak açtıysa çalışır. Kullanıcıya bunun için ekstra bir yazma izni formu verilmez.

Kullanılabilirlik

Ayarların markanızın backend’i tarafından da desteklenmesi gerekir. Bu yazma genişletmesi 7 Ekim 2026 tarihinde OnderwijsSupport için hedefli olarak yayınlandı ve test edildi. Bu, aynı genişletmenin AI-School, AI-Public veya başka herhangi bir ortam için de otomatik olarak açıldığı anlamına gelmez. Yazma eylemleri eksikse platform yönetiminden onay isteyin.

6. Kurulumu kontrol edin​

Bir kullanıcının doğru AI ortamında oturum açmasını ve istenen entegrasyonu Microsoft entegrasyonlarını kullanma bölümüne göre açmasını sağlayın. Microsoft’un kendi Entra uygulamanızın adını gösterdiğini kontrol edin.

Önce tanınabilir bir taslak ve katılımcısı olmayan bir randevu test edin. Outlook’taki kaydedilen öğeleri kontrol edin. Ardından kararlaştırılmış bir test alıcısına gönderim yapın ve Teams’te kararlaştırılmış bir test kanalına gönderi atın. Katılımcılı bir randevu davet veya güncelleme gönderebilir. Kabul edilen bir gönderim emri, teslimatın onaylandığı anlamına gelmez.

İzinler genişletildiğinde bağlantı token’ları yenilemeye çalışır. Microsoft yeniden oturum açma veya onay isterse, kullanıcı mevcut bağlantıyı yeniden bağlamalıdır. İkinci bir uygulama veya ayrı bir kullanıcı ayarı oluşturulmasına gerek yoktur.

Sorun giderme​

SorunKontrol
AADSTS50011 / yönlendirme uyuşmazlığıHer iki callback’in de doğru marka için tam olarak Web olarak kaydedildiğini kontrol edin.
Onay sırasında başka bir uygulama adı görünürDoğru AI ortamı, Directory ID ve tenant’a özel Microsoft Identity Provider; ardından yeniden bağlayın.
Giriş çalışıyor, ama entegrasyon çalışmıyorConnector callback, Graph izinleri ve kuruluş onayını da kontrol edin.
Okuma çalışıyor, yazma çalışmıyorYönetim izni, ilgili delegated Graph izni, verilen onay ve backend kullanılabilirliğini kontrol edin.
Client secret geçersiz veya süresi dolmuşValue alanını, Secret ID’yi değil; yeni secret’ı Identity Provider’da da güncelleyin.
Entegrasyon kullanıcıda görünmüyorTools içindeki kullanılabilirliği, kullanıcı bağlantı izinlerini ve seçilen AI ortamını kontrol edin.

Daha fazla bilgi​

Merkezi SharePoint bilgi bankası: Microsoft ayarlama​

Merkezi olarak bağlanan bir klasör, her çalışanın kişisel SharePoint bağlantısını açmasını gerektirmeden kuruluş uygulaması üzerinden çalışır. Bunun için iki ayrı onay gerekir: admin consent ile Sites.Selected uygulama izni ve seçilen SharePoint sitesinde bir read grant. Çalışan bir Microsoft girişi veya yalnızca admin consent yeterli değildir.

1. Kuruluş uygulamasını kontrol edin​

AI ortamınızda Microsoft ile oturum açma için kullanılan aynı single-tenant app registration’ı kullanın. Mevcut bir uygulama genişletilebilir; ikinci bir entegrasyon uygulamasına gerek yoktur. Microsoft Entra → App registrations → uygulamanız → Overview bölümünde Directory (tenant) ID ve Application (client) ID’yi kontrol edin. Aşağıda client ID’yi kullanın, Object ID’yi değil.

Directory ID, Admin → Omgeving → Tenant → Microsoft ID alanında olmalıdır. Client ID ve geçerli bir client secret’ın Value değeri tam olarak bu AI ortamının Microsoft Identity Provider’ında bulunmalıdır. Bu yapılandırma platform yönetimi tarafından korunur. Süresi dolmuş bir secret, merkezi import işlemini de engeller; son kullanım tarihini takip edin.

Merkezi sunucu bağlantısı client_credentials kullanır ve ekstra bir redirect URL istemez. Oturum açma ve kişisel çalışma hesabı entegrasyonları için mevcut Web yönlendirmeleri yine gereklidir; bu makalenin önceki tablosundaki markaya özel URL’leri kullanın.

  1. API permissions → Add a permission → Microsoft Graph → Application permissions bölümünü açın.
  2. Sites.Selected izinini bulun, seçin ve Add permissions’a tıklayın.
  3. Yetkili bir Entra yöneticisinin Grant admin consent for kuruluşunuz işlemini yapmasını sağlayın.
  4. Sites.Selected, türü Application olarak verilmiş görünmeli.

Kişisel Outlook, Teams ve SharePoint bağlantıları için delegated izinler aynı uygulamada kalabilir. Bunlar merkezi bilgi bankası için uygulama izninin yerini almaz. Bu merkezi import için Sites.Read.All, Sites.ReadWrite.All veya Sites.FullControl.All uygulama izni gerekmez.

3. Uygulamaya siteye ayrı okuma erişimi verin​

Bu yönetim işlemi Microsoft Graph Explorer ile yapılabilir. Aynı Microsoft dizininde bir yönetici hesabı kullanın; ilgili siteye erişimi olan SharePoint Administrator veya daha üst düzey uygun bir yönetici rolü gerekir. Bunun için bir Azure abonelik rolü veya yalnızca uygulama sahipliği yeterli değildir.

  1. Yönetici hesabıyla Graph Explorer’a giriş yapın ve gösterilen kuruluşu kontrol edin.
  2. profil menünüz → Consent to permissions bölümünü açın, Sites.FullControl.All’ı bulun ve bu yönetici bağlamında Graph Explorer için gerekli izni vermek üzere Consent’i seçin. Bazı sorgularda tam izin panelini Modify Permissions → Open the permissions panel üzerinden de açabilirsiniz. Bu, site grant’lerini yönetmek için kullanılan delegated bir yönetici iznidir; bunu bilgi bankası uygulamasına geniş bir uygulama izni olarak eklemeyin. Kuruluş genelinde onay gerekmediğinde hesap bazlı onay kullanın.
  3. Aşağıdaki GET ile site ID’sini bulun. Örnek host ve site yolunu kendi klasörünüzdekilerle değiştirin. URL’de /teams/ varsa, /sites/ yerine bu yolu kullanın.
GET https://graph.microsoft.com/v1.0/sites/kurulusunuz.sharepoint.com:/sites/siteniz?$select=id,displayName,webUrl

Yanıttaki id değeri, tam site ID’sidir; host adı ve iki GUID içerir. displayName ve webUrl’yi de kontrol edin: grant, klasörünüzün gerçekten bulunduğu siteye verilmelidir.

  1. Aşağıdaki adreste GET ile mevcut grant’leri önce kontrol edin. Client ID’niz orada zaten read rolüyle görünüyorsa ikinci bir grant oluşturmanıza gerek yoktur. Mevcut daha geniş veya farklı grant’leri Microsoft yöneticinizin incelemesini sağlayın.
GET https://graph.microsoft.com/v1.0/sites/SITE-ID/permissions
  1. Grant yoksa POST seçin, aynı adresi kullanın ve Request Body alanına aşağıdaki JSON’u girin. İki örnek değeri değiştirin; UYGULAMANIZIN-CLIENT-ID’Sİ integrasyon uygulamanızın Application (client) ID’sidir, Graph Explorer uygulamasının değil.
{
  "roles": ["read"],
  "grantedToIdentities": [
    {
      "application": {
        "id": "UYGULAMANIZIN-CLIENT-ID’Sİ",
        "displayName": "İNTEGRASYON UYGULAMANIZIN-ADI"
      }
    }
  ]
}
  1. Run query’yi seçin. Başarılı bir ekleme 201 Created döndürür. Yanıtta read rolünü ve client ID’yi kontrol edin; Graph bunu grantedToIdentitiesV2 altında gösterebilir. Ardından GET ile tekrar kontrol edin. Yönetim ve olası sonraki iptal için permission ID’yi saklayın.
  2. Bunu yalnızca merkezi bilgi bankası klasörlerini bilinçli olarak bağlamak istediğiniz her başka site için tekrarlayın.
Site grant ve bilgi bankası izinleri

Microsoft grant’i, uygulamaya seçilen tüm siteye okuma erişimi verir. AI ortamı yalnızca seçilen klasörü ve alt klasörleri içe aktarır. Merkezi olarak paylaşılacak bilgi için tercihen ayrı bir site kullanın. Mevcut bilgi bankası izinleri, içe aktarılan belgeleri hangi kullanıcıların göreceğini belirler; bireysel SharePoint izinleri aktarılmaz.

4. Klasörü bağlayın ve sonucu kontrol edin​

Beheer → Kennisbank → Toevoegen → SharePoint-mappen → Map koppelen bölümünü açın ve davet bağlantısı ya da OneDrive genel bakış adresi değil, gerçek klasör URL’sini kullanın. Kapsamı, hedef kitleyi ve yayın durumunu bilgi bankası kılavuzuna göre seçin. Merkezi bir kaynak, kullanıcı tercihlerinde kişisel bir bağlayıcı gerektirmez.

Belgelerin hatasız işlendiğini görmek için Vernieuwen ile kontrol edin. Yeni bir kontrol için Nu synchroniseren kullanın ve ardından içe aktarılmış bir belge hakkında somut bir sohbet sorusu sorun. Yanıtın doğru merkezi bilgi kaynağını belirttiğini kontrol edin.

SorunMicrosoft tarafında kontrol
Giriş çalışıyor, ama merkezi klasör çalışmıyorSites.Selected türünün Application olması ve admin consent almış olması gerekir; ayrıca ayrı site grant’ini kontrol edin.
Klasör erişiminde 403 ForbiddenDoğru Microsoft dizini, site ID, client ID ve read grant; admin consent tek başına site erişimi vermez.
Graph Explorer’da yönetim işlemi için 403Delegated Sites.FullControl.All, verilen izin, yönetici rolü ve hedef siteye erişim. Çözüm olarak entegrasyon uygulamasına geniş izin eklemeyin.
Site çalışıyor, klasör bulunamıyorGerçek klasör URL’sini, belge kitaplığını ve site yolunu kontrol edin; bir OneDrive kısayolu başka bir siteye işaret ediyor olabilir.
Secret süresi dolmuş veya geçersizPlatform yönetiminin yeni secret Value değerini doğru Microsoft Identity Provider’da güncellemesini sağlayın.

OnderwijsSupport için AI-Corporate’ta bu merkezi bağlantı 14 Ekim 2026 tarihinde yayınlandı ve test edildi. AI-School, AI-Public veya başka bir ortamda kullanılabilirlik platform yönetimi tarafından onaylanmalıdır.

Microsoft belgeleri: Selected permissions, site grant ekleme ve site grant’leri kontrol etme.

Bu sayfada