Ortamınız için Microsoft 365 ayarlama
Microsoft 365’i AI-Corporate ortamınıza bağlamanın iki yolu vardır. Önce kuruluşunuza hangi yolun uygun olduğunu seçin.
| Yol | Ne zaman | Ne yaparsınız |
|---|---|---|
| AI-Corporate 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ğlama üzerinden kuruluş izni verir. Ardından bu makalenin 5. adımında anlatıldığı gibi entegrasyonları etkinleştirirsiniz. Özel uygulama, client secret veya Identity Provider gerekmez. |
| Kendi Entra uygulamanız | SharePoint klasörlerini bilgi tabanına merkezi olarak aktarmak istiyorsanız, çalışanlar zaten Microsoft ile kendi uygulamanız üzerinden giriş yapıyorsa veya uygulamayı kendiniz yönetmek istiyorsanız. | Bu makaleyi 1. adımdan itibaren izleyin. |
Kuruluşunuz zaten kendi bir uygulama üzerinden Microsoft ile giriş yapıyorsa (ortamın Microsoft ID alanı doldurulmuşsa), tüm bağlantılar bu kendi uygulamayı kullanır. Bu durumda merkezi yol uygulanmaz.
Kendi Entra uygulaması
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 eylemlerinin 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çar veya kapatır.
Kişisel entegrasyonlar, OpenAI, Claude, Gemini ve Mistral’ın desteklenen modelleriyle çalışır. Seçilen model araçları kullanabilmelidir. Kişisel bağlantılarda erişim, oturum açmış Microsoft kullanıcısının izinlerini takip eder. Kuruluş izni tüm çalışanları otomatik olarak oturuma dahil etmez ve AI’ya tüm posta kutularına bağımsız erişim vermez. Merkezi SharePoint bilgi tabanı, bu makalenin ilerleyen bölümlerinde açıklanan ayrı uygulama izinlerini ve mevcut bilgi tabanı izinlerini kullanır.
Neye ihtiyacınız var?
- Microsoft Entra ID’ye sahip bir Microsoft 365 kuruluşu ve istenen hizmetlere erişimi olan hesaplar.
- Bir uygulamayı kaydedebilecek ve seçilen Microsoft Graph izinleri için kuruluş izni verebilecek bir yönetici. Bunun için yalnızca bir Azure abonelik rolü yeterli değildir; Entra rolünüzün bu izne 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 ile.
Microsoft ile oturum açma ve Microsoft verilerine erişim iki ayrı özelliktir. Çalışan bir Microsoft girişi olması, Outlook, Teams veya SharePoint’in de 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-Corporate – 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:
| Bilgi | Ne için? |
|---|---|
| Directory (tenant) ID | Kuruluşunuzun Microsoft dizini; bu, AI ortamındaki Microsoft ID alanına girer. |
| Application (client) ID | Kaydedilen uygulama; bu, Microsoft Identity Provider’a girer. |
Bu iki ID farklıdır. Microsoft ID alanına client ID veya Firebase tenant ID 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 URL’lerin ikisini de, tam olarak gösterildiği gibi ekleyin. İlki oturumu açmayı, ikincisi ise iş hesabı entegrasyonları için izni işler.
| Marka | Microsoft ile oturum açma | İş hesabı entegrasyonları |
|---|---|---|
| AI-School | https://ai-school-pro.firebaseapp.com/__/auth/handler | https://europe-west1-ai-school-pro.cloudfunctions.net/completeConnectorOAuth |
| AI-Corporate | https://ai-corporate.firebaseapp.com/__/auth/handler | https://europe-west1-ai-corporate.cloudfunctions.net/completeConnectorOAuth |
| AI-Public | https://ai-public-pro.firebaseapp.com/__/auth/handler | https://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ın veya tenant ID’nizin bu URL’lere eklenmesi gerekmez. Web sitesi URL’si, kontrol paneli URL’si ve .web.app URL’si bu callback’lerin yerini almaz. Entegrasyonu bir tarayıcıdan kullanıyor olsanız bile bunları Web olarak kaydedin. Bunun için implicit token issuance veya public-client-flow etkinleştirmeniz gerekmez.
3. Bir client secret oluşturun ve izinleri 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 hale gelir gelmez güvenli şekilde kaydedin. Değeri, platform yönetimi için üzerinde anlaşılmış güvenli kanal üzerinden iletin; Secret ID client secret değildir. Son kullanma 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ğı entegrasyonlar ve eylemler için gerekli izinleri ekleyin.
| Entegrasyon | Okuma izinleri | Yazma için ek izinler |
|---|---|---|
| Profil / temel | User.Read; oturum açma akışı ayrıca openid, profile, email ve offline_access ister | Yok |
| Outlook Mail | Mail.Read | Taslaklar: Mail.ReadWrite. Gönderme: Mail.Send. |
| Outlook Takvim | Calendars.Read | Yazma: Calendars.ReadWrite. |
| Microsoft Teams | Chat.Read, ChannelMessage.Read.All | Gönderme: Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Send. |
| SharePoint / OneDrive | Sites.Read.All, Files.Read.All | Bu iş hesabı entegrasyonu burada yazma eylemleri sunmaz. |
Mail.ReadWrite gönderme yetkisi 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 onaylanmış olarak göründüğünü kontrol edin. Böylece çalışanlar, kendileri kuruluş izni vermek zorunda kalmadan onaylanmış erişimi kullanabilir. Yine de Microsoft, 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çip bu ayarları yapmasını sağlayın:
- Admin → Environment → Tenant içinde: Microsoft giriş yöntemini etkinleştirin ve Microsoft ID alanına Directory (tenant) ID değerini girin.
- Google Cloud → Identity Platform → ilgili tenant → Identity providers → Microsoft içinde: sağlayıcıyı etkinleştirin ve aynı Entra uygulamasının Application (client) ID ve client secret Value değerini girin.
Identity Provider, başka bir kuruluşun değil, AI ortamınızın Firebase/Identity Platform tenant’ına aittir. İş hesabı entegrasyonu bu sağlayıcıdaki uygulamayı yeniden kullanır. Client secret, kullanıcı tercihlerinde, sohbet mesajlarında veya sıradan 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 kullanma 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çersiniz:
- Outlook Mail → Concepten: taslak oluşturma ve düzenleme.
- Outlook Mail → Verzenden: mevcut bir taslağı gerçekten gönderme.
- Outlook Agenda → Schrijven: randevu oluşturma ve düzenleme.
- 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çık olduğunda, Microsoft gerekli izinleri verdiğinde ve kullanıcı bağlantıyı kişisel olarak açtığında çalışır. Kullanıcıdan bunun için ekstra bir yazma izni formu istenmez.
Ayarların ayrıca markanızın backend’i tarafından da desteklenmesi gerekir. Bu yazma uzantısı 7 Ekim 2026’da özellikle yayınlanmış ve OnderwijsSupport için AI-Corporate üzerinde test edilmiştir. Bu, aynı uzantının otomatik olarak AI-School, AI-Public veya başka herhangi bir ortam için de açıldığı anlamına gelmez. Yazma eylemleri eksikse platform yönetiminden onay isteyin.
6. Kurulumu doğrulayın
Bir kullanıcının doğru AI ortamında oturum açmasını ve Microsoft entegrasyonlarını kullanma bölümündeki talimatlara göre istenen entegrasyonu açmasını sağlayın. Microsoft’un kendi Entra uygulamanızın adını gösterip göstermediğini kontrol edin.
Önce tanınabilir bir taslak ve alıcısız bir randevu test edin. Kaydedilen öğeleri Outlook’ta kontrol edin. Ardından gönderimi kararlaştırılmış bir test alıcısıyla ve Teams gönderimini kararlaştırılmış bir test kanalında test edin. Alıcısı olan bir randevu davet veya güncelleme gönderebilir. Kabul edilmiş bir gönderme işlemi, teslimatın doğrulandığı anlamına gelmez.
İzinler genişletildiğinde bağlantı token’ları yenilemeye çalışır. Microsoft yeniden oturum açma veya yeniden onay isterse, kullanıcıdan mevcut bağlantıyı yeniden bağlamasını isteyin. İkinci bir uygulama veya ayrı bir kullanıcı ayarı oluşturulmasına gerek yoktur.
Sorun giderme
| Sorun | Kontrol |
|---|---|
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üyor | Doğru AI ortamı, Directory ID ve tenant’a özgü Microsoft Identity Provider; ardından yeniden bağlayın. |
| Giriş çalışıyor, ancak entegrasyon çalışmıyor | Connector callback, Graph izinleri ve kuruluş izni de kontrol edin. |
| Okuma çalışıyor, yazma çalışmıyor | Yönetim izni, ilgili delegated Graph izni, verilmiş izin ve backend kullanılabilirliğini kontrol edin. |
| Client secret geçersiz veya süresi dolmuş | Secret ID değil, Value; yeni secret’ı Identity Provider’da da güncelleyin. |
| Entegrasyon kullanıcıda görünmüyor | Tools içindeki kullanılabilirliği, kullanıcı bağlantı izinlerini ve seçilen AI ortamını kontrol edin. |
Daha fazla bilgi
- Araçları yönetme
- Microsoft entegrasyonlarını kullanma
- Microsoft: uygulama kaydetme
- Microsoft: yönlendirme URL’leri
- Microsoft Graph: izinler referansı
Merkezi SharePoint bilgi tabanı: Microsoft ayarlama
Merkezi olarak bağlanan bir klasör, her çalışan kişisel bir SharePoint bağlantısını açmadan kuruluş uygulaması üzerinden çalışır. Bunun için iki ayrı izin gerekir: admin consent ile Sites.Selected uygulama izni ve seçilen SharePoint sitesi üzerinde 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 oturumu 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 değerlerini kontrol edin. Aşağıda client ID’yi kullanın, Object ID’yi değil.
Directory ID, Admin → Environment → Tenant → Microsoft ID alanında olmalıdır. Client ID ve geçerli bir client secret’ın Value değeri, tam olarak o 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 içe aktarmayı da engeller; son kullanma tarihini takip edin.
Merkezi sunucu bağlantısı client_credentials kullanır ve ek bir redirect URL istemez. Oturum açma ve kişisel iş hesabı entegrasyonları için mevcut Web redirect’leri gerekli olmaya devam eder; bu makalenin önceki tablosundaki markaya özel URL’leri kullanın.
2. Uygulama iznini ekleyin ve admin consent verin
- API permissions → Add a permission → Microsoft Graph → Application permissions bölümünü açın.
- Sites.Selected’ı bulun, bu izni seçin ve Add permissions’a tıklayın.
- Yetkili bir Entra yöneticisinin Grant admin consent for kuruluşunuz işlemini yapmasını sağlayın.
- Sites.Selected, tür Application, olarak verildiğini kontrol edin.
Kişisel Outlook, Teams ve SharePoint bağlantıları için delegated izinler aynı uygulamada kalabilir. Bunlar merkezi bilgi tabanı için uygulama izninin yerini almaz. Bu merkezi içe aktarma 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; SharePoint Administrator veya daha yüksek uygun bir yönetici rolü ve ilgili siteye erişim gerekir. Bunun için Azure abonelik rolü veya yalnızca uygulama sahipliği yeterli değildir.
- Yönetici hesabıyla Graph Explorer’a giriş yapın ve gösterilen kuruluşu kontrol edin.
- Profil menünüz → Consent to permissions bölümünü açın, Sites.FullControl.All’ı bulun ve bu yönetim bağlamında Graph Explorer için gerekli izni vermek üzere Consent 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önetim iznidir; bunu bilgi tabanı uygulamasına geniş bir uygulama izni olarak eklemeyin. Kuruluş izni tüm kullanıcılar için gerekli değilse hesap bazlı izin kullanın.
- Aşağıdaki GET ile site ID’sini bulun. Örnek host ve site yolunu kendi klasörünüzdekilerle değiştirin.
/teams/içeren bir URL’de,/sites/yerine o 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, host adı ve iki GUID dahil tam site ID’sidir. displayName ve webUrl değerlerini de kontrol edin: grant, klasörünüzün gerçekten bulunduğu siteye verilmelidir.
- Aşağıdaki adres üzerinde önce mevcut grant’leri GET ile kontrol edin. Client ID’niz burada zaten
readrolü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
- 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İ, entegrasyon uygulamanızın Application (client) ID değeridir, Graph Explorer uygulamasının değil.
{
"roles": ["read"],
"grantedToIdentities": [
{
"application": {
"id": "UYGULAMANIZIN-CLIENT-ID'Sİ",
"displayName": "ENTEGRASYON UYGULAMANIZIN-ADI"
}
}
]
}
- Run query seçin. Başarılı bir ekleme 201 Created döndürür. Yanıtta
readrolünü ve client ID’yi kontrol edin; Graph bunugrantedToIdentitiesV2altında gösterebilir. Ardından tekrar GET ile kontrol edin. Yönetim ve olası sonraki iptal işlemleri için permission ID’yi saklayın. - Bunu yalnızca kasıtlı olarak bilgi tabanı klasörlerini bağlamak istediğiniz her başka site için tekrarlayın.
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 tabanı izinleri, hangi kullanıcıların içe aktarılan belgeleri alacağını belirler; bireysel SharePoint izinleri devralınmaz.
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ı veya OneDrive genel bakış adresi değil, gerçek klasör URL’sini kullanın. Kapsamı, hedef kitleyi ve yayın durumunu bilgi tabanı kılavuzuna göre seçin. Merkezi bir kaynak, kullanıcı tercihlerinde kişisel bir connector gerektirmez.
Belgelerin hatasız işlendiğini Vernieuwen ile kontrol edin. Yeni bir kontrol için Nu synchroniseren kullanın ve ardından içe aktarılan bir belge hakkında belirli bir sohbet sorusu sorun. Yanıtın doğru merkezi bilgi kaynağını belirttiğini kontrol edin.
| Sorun | Microsoft tarafında kontrol |
|---|---|
| Giriş çalışıyor, ancak merkezi klasör çalışmıyor | Sites.Selected türü Application olmalı ve admin consent almış olmalı; ayrıca ayrı site grant’ini kontrol edin. |
Klasöre erişimde 403 Forbidden | Doğru Microsoft dizini, site ID, client ID ve read grant; admin consent tek başına site erişimi vermez. |
Graph Explorer’daki yönetim işleminde 403 | Delegated 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 bulunamadı | Gerçek klasör URL’sini, belge kitaplığını ve site yolunu kontrol edin; bir OneDrive kısayolu başka bir siteye işaret edebilir. |
| Secret süresi dolmuş veya geçersiz | Platform yönetiminin yeni secret Value değerini doğru Microsoft Identity Provider’da güncellemesini sağlayın. |
OnderwijsSupport için AI-Corporate üzerinde bu merkezi bağlantı 14 Ekim 2026’da yayınlanmış ve test edilmiştir. AI-School, AI-Public veya başka bir ortamda kullanılabilirlik platform yönetimi tarafından onaylanmalıdır.
Microsoft belgeleri: Selected permissions, sitegrant ekleme ve sitegrant’leri kontrol etme.