Genel bakış

Çalışma alanı yöneticileri, SharePoint denetimlerini kullanarak onaylı site koleksiyonlarına izin verebilir, seçilen site koleksiyonlarını engelleyebilir ve seçilen Microsoft Purview duyarlılık etiketlerini taşıyan, desteklenen dosyaları dışlayabilir.

SPSite olarak da adlandırılan bir SharePoint site koleksiyonu, birden fazla site içerebilir. Koleksiyon kuralı, her kullanıcının mevcut Microsoft izinlerine tabi olarak koleksiyonun tamamına uygulanır. Kullanıcıya Microsoft 365'te erişemediği içeriklere erişim hakkı vermez.

Site kısıtlamaları; desteklenen SharePoint arama, göz atma, dosya alma ve okuma/yazma işlemlerine uygulanır. OneDrive erişimi ayrı olarak yönetilir.

İlkenize uygun erişim modunu seçin:

• İzin verilen siteler: İzin listesi boş değilse kullanıcılar uygulama üzerinden yalnızca listedeki site koleksiyonlarına erişebilir.

• Engellenen siteler: Kullanıcılar, Microsoft izinlerine tabi olarak engelleme listesinde olmayan site koleksiyonlarına erişebilir.

Aynı anda yalnızca bir listede kayıt bulunabilir. Boş bir izin listesi tüm siteleri engellemez. Her iki liste de boş olduğunda SharePoint site kısıtlamaları kaldırılır; Microsoft izinleri ve yapılandırılmış diğer denetimler geçerliliğini korur.

Kullanılabilirlik

Denetimlerin ve çalışma alanı Yönetici API'sinin çalışma alanınız için etkinleştirilmesi gerekir. Kullanılabilir denetimler arasında site koleksiyonu izin listeleri, site koleksiyonu engelleme listeleri, CSV ile site içe aktarma ve duyarlılık etiketine göre dışlamalar bulunur.

Kurallar, site koleksiyonlarının tamamına uygulanır. Kapsamı yalnızca belirli bir site, klasör veya dosyayla sınırlama ve Microsoft Sites.Selected izinlerini uygulama, bu site koleksiyonu denetimlerine dahil değildir.

Başlamadan önce

• Kuruluşunuzun izin vermek veya engellemek istediği site koleksiyonlarını belirleyin.

• Her koleksiyonun GUID'sini edinin. Tam bir Microsoft Graph site kimliğinin ortasındaki değer, koleksiyon GUID'sidir. Yönetici API'si koleksiyon GUID'lerini kullanır; kullanıcı arayüzündeki CSV içe aktarma aracı bunları Graph site kimliği üçlülerinden de çıkarabilir.

• Sites.Read.All ve Files.Read.All dahil olmak üzere, SharePoint uygulamasının gerektirdiği Microsoft izinlerini hem ChatGPT'nin izin ayarlarında hem de Microsoft Entra'da etkinleştirin. Bu kontroller, OpenAI tarafında erişimi filtreler; Microsoft'un temsilci izinlerinin yerini almaz.

• Duyarlılık etiketi hariç tutma kuralları için Microsoft 365 veya Purview yöneticinizden, şifreleme uygulayan etiketler de dahil olmak üzere hariç tutmak istediğiniz her etiketin değişmez GUID'sini isteyin.

• API üzerinden yönetim için çalışma alanı UUID'nizi, bir ChatGPT çalışma alanı Yönetici anahtarını ve SharePoint URL'lerini çözümlemeniz gerekiyorsa bir Microsoft Graph belirtecini edinin. Bu iki kimlik bilgisi farklı amaçlara hizmet eder.

OpenAI Cookbook hakkında

OpenAI Cookbook, OpenAI'ın herkese açık örnek kod ve kılavuz koleksiyonudur. Bu makalede, bu koleksiyonun GitHub'da barındırılan SharePoint site erişimi kılavuzu ve Python yönetim betiği kullanılır. Dosyaları okumak için bu bağlantıları tarayıcınızda açabilirsiniz. Betiği çalıştırmak için indirin ve kılavuzdaki kurulum ve komut talimatlarını izleyin.

Bu makale boyunca “Cookbook” bu SharePoint kılavuzunu, “Cookbook aracı” ise bağlantısı verilen Python betiğini ifade eder. Komut örnekleri ve API üzerinden izin listesi yönetimi için bu kaynakları kullanın.

API üzerinden yönetim için kimlik bilgilerini ayarlayın

Not: Yönetici anahtarları oluşturabilmek için çalışma alanı yöneticisi olmanız gerekir. Daha fazla bilgi edinin.

ChatGPT çalışma alanı yönetici anahtarı oluşturun

1. ChatGPT yönetici konsolunu açın ve istediğiniz çalışma alanını seçin.

2. Kimlik bilgileri bölümüne gidin ve Yönetici anahtarları seçeneğini seçin.

3. Kısıtlı izinlere sahip bir anahtar oluşturun ve Uygulamalar iznini Yazma olarak ayarlayın.

4. Anahtarı güvenli bir şekilde saklayın. Bu anahtar, çalışma alanınızın SharePoint ilkesini okuma ve değiştirme yetkisi verir.

Gerekli izin chatgpt.enterprise.apps.write iznidir. OpenAI API Platformu anahtarının ve Microsoft Graph belirtecinin, ChatGPT çalışma alanı yönetici anahtarının yerini alamayacağını unutmayın.

Daha fazla bilgi için Kimlik bilgileri sekmesinde yönetici anahtarlarını yönetme makalesine bakın. Betiğin kimlik bilgileri için kullandığı ortam değişkenleri ve güvenli giriş örneği için Cookbook kimlik bilgisi talimatlarına bakın.

Microsoft Graph belirteci edinin

Kuruluşunuzun onayladığı Microsoft kimlik doğrulama sürecini kullanın. Kuruluşunuz Graph Explorer'a izin veriyorsa etkileşimli sorgulama için:

1. Microsoft Graph Explorer'ı açın ve SharePoint sitelerini içeren kiracıdaki bir iş hesabıyla oturum açın.

2. İzinleri değiştir veya İzinlere onay ver seçeneğini kullanarak siteleri okumak için gereken izinleri (genellikle Sites.Read.All) seçin. Kuruluşunuz gerektiriyorsa Microsoft yöneticinizden erişimi onaylamasını isteyin.

3. Erişim belirteci sekmesini açın ve Microsoft Graph ile kullanmak üzere belirteci kopyalayın.

Microsoft'un talimatları için Graph Explorer ile çalışma makalesine bakın.

Graph belirteci, SharePoint URL'lerini tanımlayıcılara çözümlemek için kullanılır. ChatGPT yönetici anahtarı, ChatGPT ilkesini okumak veya güncellemek için kullanılır. Cookbook aracı, Graph belirtecine yalnızca URL'leri çözümleyen komutlar için ihtiyaç duyar; mevcut bir izin listesini okumak veya temizlemek için yalnızca ChatGPT yönetici anahtarı gerekir.

Bu kimlik bilgilerinin hiçbirini kaynak kodu yönetim sistemlerine, paylaşılan belgelere, ekran görüntülerine veya günlüklere dahil etmeyin.

Site koleksiyonu GUID'sini bulma

SharePoint site URL'sini kullanın

1. Siteye erişebilen bir hesapla Microsoft'ta oturum açtıktan sonra SharePoint sitesini açın.

2. Site URL'sinin sonuna /_api/site/id ekleyin. Örneğin, https://contoso.sharepoint.com/sites/Finance/_api/site/id adresini kullanın.

3. Yanıtta döndürülen GUID'yi kopyalayın.

Not: Bu makaledeki örnek alan adları ve tanımlayıcılar yer tutucudur.

Microsoft Graph'ı kullanın

Microsoft Graph, virgülle ayrılmış üç bileşenden oluşan bir site kimliği döndürür: ana bilgisayar adı, site koleksiyonu GUID'si ve site GUID'si. Site koleksiyonu kuralı için ortadaki değeri kullanın. Farklı site URL'leri aynı koleksiyon GUID'sine çözümlenebilir.

Sorgulama ve tanımlayıcı örnekleri için SharePoint site tanımlayıcılarını anlama bölümüne bakın. ChatGPT ilkesini değiştirmeden birden fazla URL'yi çözümlemek için Cookbook inceleme talimatlarını ve Python yönetim betiğini kullanın.

Microsoft'un sorgulama gereksinimleri için Yola göre SharePoint sitesi alma bölümüne bakın.

İzin verilen ve engellenen site koleksiyonlarını yönetin

Çalışma alanı kontrollerini kullanın

1. Çalışma alanınızda SharePoint uygulamasının Güvenlik ve Koruma Kontrolleri bölümünü açın.

2. Erişim modu altında İzin verilen siteler veya Engellenen siteler seçeneğini belirleyin.

3. Site koleksiyonlarını seçili listeye ekleyin. Aşağıda açıklanan CSV yükleme yöntemini de kullanabilirsiniz.

4. Değişikliklerinizi gözden geçirin ve Kaydet seçeneğini belirleyin.

5. Kaydedilen ilkeyi kontrol edin ve yapılandırmanızı test edin.

Yönetici API'si üzerinden eklenen siteler, çalışma alanı kontrollerinde görünür. Kullanıcı arayüzünde eklenen sitelere API üzerinden de erişilebilir. Her iki arayüzden de kayıt ekleyebilir veya kaldırabilirsiniz; bir siteyi eklemek için kullanılan yöntem, daha sonraki işlemlerde aynı yöntemi kullanmanızı gerektirmez.

İzin verilen ve engellenen siteler arasında geçiş yapın

Aynı anda yalnızca bir liste kayıt içerebilir. Diğer modda kayıt eklemeden önce mevcut listeyi temizleyin ve bu değişikliği kaydedin. Ardından diğer modu seçin, istediğiniz koleksiyonları ekleyin ve yeniden kaydedin.


Etkin listeyi temizlediğinizde, değişikliği kaydeder kaydetmez erişim durumu değişir. İzin listesini temizlemek, listenin uyguladığı site kısıtlamasını kaldırır; engelleme listesini temizlemek ise engellemeleri kaldırır. Geçişi diğer yöneticilerle birlikte planlayın; bir listeyi temizlemekle diğerini kaydetmek arasında geçen sürede, nihai ilkenizin kısıtlayacağı erişimlere izin verilebilir.

Site koleksiyonlarını CSV'den yükleyin

CSV yükleme yalnızca site koleksiyonlarını destekler. Dosyaları duyarlılık etiketine göre hariç tutmak için etiket GUID'lerini duyarlılık etiketi hariç tutma listesine ekleyin.

1. Güvenlik ve Koruma Kontrolleri bölümünü açın ve istediğiniz Erişim modu seçeneğini belirleyin.

2. Site koleksiyonu GUID'lerini veya Microsoft Graph site kimliği üçlülerini içeren bir CSV hazırlayın. Dosyanın tamamında tek bir tanımlayıcı biçimi kullanın.

3. CSV dosyası yükle seçeneğini belirleyin ve dosyayı seçin.

4. İçe aktarma sonucunu ve seçili listeyi gözden geçirin. Devam etmeden önce satırlardaki hataları veya uyarıları giderin.

5. Değişiklikleri uygulamak için Kaydet seçeneğini belirleyin, ardından kaydedilen listeyi kontrol edin.

CSV gereksinimleri ve işleyişi:

• Maksimum dosya boyutu: 1 MB.

• Başlıklar isteğe bağlıdır.

• Her satırda bir koleksiyon GUID'si veya Graph site kimliği üçlüsü kullanın. Üçlüler, tek bir alanda tırnak içine alınabilir veya üç sütuna bölünebilir.

• Graph üçlüleri koleksiyon GUID'lerine dönüştürülür. Bir üçlüyü içe aktarmak, yalnızca o siteye özgü bir kural oluşturmaz.

• İçe aktarma işlemleri seçili listeye ekleme yapar ve mevcut kayıtları korur. Yinelenen koleksiyonlar tekilleştirilir; içe aktarma sayısı, yeni eklenen koleksiyonları gösterir.

• Karışık biçimler ve hatalı biçimlendirilmiş satırlar reddedilir. Yalnızca site URL'leri içeren bir dosya yüklendiğinde uyarı gösterilir ve siteler eklenmez. Önce URL'leri çözümleyerek koleksiyon GUID'lerini elde edin.

• Yükleme işlemi yalnızca taslak listeyi değiştirir. Kaydet seçeneğini belirleyene kadar çalışma alanındaki erişim kuralları güncellenmez.

• Burada açıklanan CSV yükleme işlemi, site koleksiyonlarını yönetmek içindir. Duyarlılık etiketi hariç tutma kurallarını ayrıca yapılandırın.

SharePoint URL'leri içeren bir CSV'niz varsa Cookbook yardımcı aracının CSV iş akışı, bunları çözümleyebilir ve API üzerinden bir izin listesini yönetebilir. Bu aracın site_url veya url girdisi, kullanıcı arayüzündeki tanımlayıcı yükleme işleminden farklı bir biçim ve iş akışı kullanır.

İlke ve istek sınırlarını anlayın

Varsayılan ilke sınırı 10.000 site koleksiyonudur. 120.000 site koleksiyonuna kadar çıkabilen daha yüksek çalışma alanı ilke sınırlarının OpenAI tarafından etkinleştirilmesi gerekir; daha büyük ölçekli bir dağıtım planlamadan önce OpenAI ekibinizle iletişime geçin.

Tekil API değişiklik işlemleri ve mevcut Cookbook betiği, istek başına en fazla 10.000 koleksiyon GUID'si kabul eder. Çalışma alanı ilke sınırının yükseltilmesi, istek başına uygulanan bu sınırı artırmaz. Kaynak URL'leri değil, benzersiz site koleksiyonlarını sayın: Birden fazla URL aynı koleksiyona işaret edebilir.

Çalışma alanı Yönetici API'sini kullanın

Çalışma alanı UUID'nizi ve ChatGPT çalışma alanı Yönetici anahtarınızı https://api.chatgpt.com ile kullanın.

Güncel tutulan izin listesi komutları ve istek örnekleri için Cookbook'u kullanın:

• Mevcut izin listesini okuyun.

• Site koleksiyonlarını önizleyin ve ekleyin. Ekleme işlemleri, mevcut izin verilen koleksiyonları korur.

• Bir site koleksiyonunu kaldırın.

• İzin listesini temizleyin.

Değişiklik yapmadan önce mevcut ilkeyi gözden geçirin, ardından yeniden okuyun ve oluşan erişim durumunu test edin. İzin verilen son koleksiyonu kaldırmak veya izin listesini temizlemek, listenin uyguladığı site kısıtlamasını kaldırır. İzin listesi kısıtlamalarını kaldırmak istemiyorsanız boş bir ekleme isteği göndermeyin.

Herkese açık Cookbook yardımcı aracı şu anda yalnızca izin listelerini yönetir. Engelleme listelerini veya duyarlılık etiketi hariç tutma kurallarını yönetmez. Bu işlemler için yukarıda açıklanan çalışma alanı kontrollerini kullanın.

Duyarlılık etiketlerine sahip dosyaları dışlayın

Etiket GUID'sini bulun

Microsoft 365 veya Purview yöneticinizden istediğiniz etiketin değişmez GUID'sini isteyin. Görünen adını değil, GUID'sini kullanın.

Bir yönetici, Microsoft Graph üzerinden etiketleri listeleyebilir. Belirtecin, duruma uygun olarak SensitivityLabel.Read veya SensitivityLabels.Read.All iznine sahip olması gerekir. İstediğiniz etiketin adını kimliğiyle eşleştirin ve koruma ayarlarını kontrol edin.

Gereksinimler ve örnekler için Duyarlılık etiketlerini listeleme ve Duyarlılık etiketi özellikleri makalelerine bakın. Bu etiket izinleri, SharePoint URL'lerini çözümlemek için kullanılan site okuma izninden ayrıdır.

Hariç tutulacak etiketleri ekleyin

1. SharePoint uygulamasının Güvenlik ve Koruma Kontrolleri bölümünü açın.

2. Şifreleme uygulayan etiketler de dahil olmak üzere, hariç tutmak istediğiniz her etiketin GUID'sini duyarlılık etiketi hariç tutma listesine girin.

3. Yapılandırmayı kaydedin ve hariç tutulan etiketi taşıyan, desteklenen bir dosyayla test edin.

Desteklenen etiketleri listedekilerle eşleşen dosyalar, SharePoint uygulaması sonuçlarından hariç tutulur. Şifrelenmiş dosyaların içeriği varsayılan olarak hariç tutulur. Desteklenen şifreli dosyalara erişim için, aşağıdaki SSS bölümünde açıklandığı gibi hem gelişmiş dosya erişimi (fetch_advanced) hem de Microsoft Entra yönetici onayı gerekir. Etiket hariç tutma kuralları ve bağlantıyı kuran kullanıcının Microsoft izinleri geçerliliğini korur.

Yapılandırmanızı test edin

Kuruluşunuzun onayladığı test dosyalarını ve hesaplarını kullanın. Testten önce aynı Microsoft hesabının her dosyaya doğrudan SharePoint'ten erişebildiğini doğrulayın.

1. İzin verilen siteler modunda, liste boş değilken izin verilen bir koleksiyondaki dosyayı ve listede olmayan bir koleksiyondaki dosyayı kontrol edin. Uygulama üzerinden yalnızca izin verilen koleksiyona erişilebilmelidir.

2. Engellenen siteler modunda, engellenen bir koleksiyondaki dosyayı ve engellenmeyen bir koleksiyondaki dosyayı kontrol edin. Engellenen koleksiyona erişilememelidir; engellenmeyen koleksiyon ise Microsoft izinlerine ve diğer denetimlere tabi olmaya devam eder.

3. Dışlanan bir duyarlılık etiketi taşıyan, desteklenen bir test dosyasını kontrol edin. Bu dosya uygulamanın sonuçlarında görünmemelidir.

4. API üzerinden yapılan bir değişiklikten sonra arayüzde kaydedilmiş listeyi API'nin döndürdüğü ilkeyle karşılaştırın.

5. CSV yükledikten sonra değişiklikleri kaydedin ve amaçlanan koleksiyonların korunduğunu doğrulamak için denetimleri yeniden açın.

Sonuçlar amaçlanan ilkeden farklıysa çalışma alanını, seçili erişim modunu, kaydedilmiş listeyi, koleksiyon GUID'lerini, etiket GUID'lerini, desteklenen dosya türünü ve kullanıcının Microsoft izinlerini kontrol edin. Ortaya çıkacak erişim değişikliğini istemiyorsanız sorun giderme adımı olarak listeyi temizlemeyin.

Eksik denetimler veya beklenmeyen erişim durumlarıyla ilgili yardım için OpenAI Destek ile iletişime geçme makalesine bakın. Destek talebinize yönetici anahtarlarını veya Microsoft Graph belirteçlerini eklemeyin.

Sınırlamaları öğrenin

• Koleksiyon kuralı, site koleksiyonunun tamamını kapsar. Erişimi belirli bir alt site, klasör veya dosyayla sınırlayamaz.

• SharePoint site kısıtlamaları, OneDrive erişimini otomatik olarak kısıtlamaz.

• Duyarlılık etiketine göre filtreleme yalnızca Microsoft Graph'ın desteklenen etiket meta verilerini sunduğu dosyalara uygulanır. Bunlar arasında desteklenen Office belgeleri, PDF ve MP4 dosyaları bulunur.

• TXT ve CSV gibi duyarlılık etiketlerini desteklemeyen dosya türleri etiketsiz olarak değerlendirilir. Diğer kurallar izin veriyorsa bu dosyalara erişilebilir. Bu dosya türü sınırlaması, site erişimini yapılandırmak için CSV yüklemekten bağımsızdır.

• CSV yükleme özelliği ve herkese açık örnek araç, duyarlılık etiketine göre dışlama ayarlarını yapılandırmaz. Bu makalede toplu etiket yönetimi için bir API açıklanmamaktadır.

• Bir ilkenin kaydedilmiş olması veya API'nin başarılı yanıt vermesi, erişimin ilgili hesapla test edilmesinin yerini tutmaz.

Python yönetim aracını kullanın

Örnek kodun ve komutların tamamı OpenAI Cookbook'ta güncel tutulur:

• Yönetim kılavuzu.

• Python yönetim betiği.

• Çevrimdışı test dosyası.

Python 3.10 veya sonraki bir sürümü kullanın. Araç, Python standart kütüphanesini kullanır. Aracı çalıştırmadan önce kılavuzu okuyun ve değişiklikleri gözden geçirmek için deneme çalıştırmaları yapın.

Aracın mevcut sürümü, kimlik bilgilerini ortam değişkenlerinden okur; kılavuzdaki güvenli giriş talimatlarını kullanın. İzin listesini temizlemek için açık onay gerektirir. Bir kaldırma işlemi bu onay olmadan gerçekleştirilebilir. Bu nedenle önce deneme çalıştırmasıyla kaldırma işlemini gözden geçirin.

Yeniden deneme davranışı ve isteğe bağlı idempotans anahtarları için İlke güncellemesini güvenli bir şekilde yeniden deneme bölümüne bakın. İdempotans anahtarlarını yalnızca çalışma alanı destekliyorsa kullanın ve sonucu belirsiz bir hatadan sonra mevcut ilkeyi inceleyin.

Araç, çalışma alanı özelliklerini etkinleştirmez veya kuralların uygulandığını doğrulamaz. Çevrimdışı testleri, Microsoft Graph ve ChatGPT Yönetici API'si çağrılarının taklitlerini kullanır.

Birden fazla istek içeren değişiklikler atomik değildir. Birden fazla koleksiyonu kaldırma işlemi yarıda başarısız olursa önceki kaldırma işlemleri tamamlanmış olabilir. Yeniden denemeden önce mevcut ilkeyi okuyun.

SSS

Şifreleme uygulayan duyarlılık etiketlerini hariç tutma listesine eklemeli miyim?

Evet. ChatGPT'nin dosyalarını hariç tutmasını istediğiniz tüm Microsoft Purview duyarlılık etiketlerini, şifreleme uygulayanlar da dahil olmak üzere ekleyin.

Şifrelenmiş dosyaların içeriği varsayılan olarak hariç tutulur. Desteklenen şifreli dosyalara erişimi etkinleştirmek için bir çalışma alanı yöneticisinin gelişmiş dosya erişimini (fetch_advanced) etkinleştirmesi ve bir Microsoft Entra yöneticisinin gerekli Microsoft izinleri için onay vermesi gerekir. Yönetici onayı tamamlanmadan eylemin etkinleştirilmesi yeterli değildir.

Kurulumdan sonra bile ChatGPT, şifrelenmiş içeriği yalnızca bağlantıyı kuran kullanıcının dosyaya erişme ve şifresini çözme izni varsa alabilir. Hariç tutma listenizdeki etiketleri taşıyan dosyalar hariç tutulmaya devam eder. Gelişmiş dosya erişimini etkinleştirmek veya yönetici onayı vermek, etiket hariç tutma kurallarını ya da kullanıcının Microsoft izinlerini geçersiz kılmaz.

Site kontrolleri Microsoft izinlerinin yerini alır mı?

Hayır. Uygulama, her kullanıcının Microsoft izinlerini kullanmaya devam eder. OpenAI, yanıtlar kullanıcıya ve modele gösterilmeden önce yapılandırılmış site filtrelemesini uygular.

Boş bir izin listesi tüm siteleri engeller mi?

Hayır. Boş bir izin listesi, “tümünü engelle” anlamına gelmez. Engelleme listesinde kayıtlar varsa bu koleksiyonlar engellenmeye devam eder. Her iki listede de kayıt yoksa erişimi, kullanıcıların Microsoft izinleri ve yapılandırılmış diğer kontroller belirler.

Yönetici API'si değişiklikleri günlüğe kaydedilir mi?

Yönetici API'si üzerinden yapılan ilke değişiklikleri, çalışma alanının denetim ve uyumluluk günlüklerine kaydedilir.