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 ortadaki değeri koleksiyon GUID'sidir. Yönetici API'si koleksiyon GUID'lerini kullanır; arayüzdeki CSV içe aktarma aracı bunları Graph site kimliği üçlülerinden de çıkarabilir.

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

• Duyarlılık etiketine göre dışlamalar için Microsoft 365 veya Purview yöneticinizden şifreleme uygulamayan 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ı denetimlerini kullanın

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

2. Erişim modu bölümünde İzin verilen siteler veya Engellenen siteler seçeneğini seçin.

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

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

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

Yönetici API'si üzerinden eklenen siteler çalışma alanı denetimlerinde görünür. Arayüzde eklenen sitelere API üzerinden de erişilebilir. Her iki yöntemle de kayıt ekleyebilir veya kaldırabilirsiniz; bir siteyi eklerken kullanılan yöntem, sonraki işlemlerde aynı yöntemi kullanmayı zorunlu kılmaz.

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

Aynı anda yalnızca bir listede kayıt bulunabilir. 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 değişir. İzin listesini temizlemek site kısıtlamasını, engelleme listesini temizlemek ise engellemeleri kaldırır. Geçişi diğer yöneticilerle birlikte planlayın. Bir listeyi temizleyip diğerini kaydedene kadar 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 dışlamak için etiket GUID'lerini Şifreleme uygulamayan dışlanmış duyarlılık etiketleri bölümüne ekleyin.

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

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 seçin ve dosyayı belirleyin.

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

5. Değişiklikleri uygulamak için Kaydet seçeneğini seçin, 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çinde verilebilir veya üç sütuna ayrılabilir.

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

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

• Karma 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 site eklenmez. Önce URL'leri koleksiyon GUID'lerine çözümleyin.

• Yükleme yalnızca taslak listeyi değiştirir. Kaydet seçeneğini seçene kadar çalışma alanındaki erişimi güncellemez.

• Burada açıklanan CSV yükleme özelliği site koleksiyonlarını yönetir. Duyarlılık etiketine göre dışlamaları ayrı olarak yapılandırın.

SharePoint URL'lerini içeren bir CSV'niz varsa Cookbook aracının CSV iş akışı bu URL'leri çözümleyebilir ve API üzerinden bir izin listesini yönetebilir. Aracın site_url veya url girdisi, arayüzdeki tanımlayıcı yüklemesinden farklı bir biçim ve iş akışı kullanır.

İlke ve istek sınırlarını öğrenin

Varsayılan ilke sınırı 10.000 site koleksiyonudur. 120.000 site koleksiyonuna kadar daha yüksek çalışma alanı ilke sınırlarının OpenAI tarafından etkinleştirilmesi gerekir. Daha büyük 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. Daha yüksek bir çalışma alanı ilke sınırı, 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 okuma.

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

• Site koleksiyonunu kaldırma.

• İzin listesini temizleme.

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, bu 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 aracı şu anda yalnızca izin listelerini yönetir. Engelleme listelerini veya duyarlılık etiketine göre dışlamaları yönetmez. Bu işlemler için yukarıda açıklanan çalışma alanı denetimlerini 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.

Etikete göre dışlama ekleyin

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

2. Şifreleme uygulamayan her etiketin GUID'sini Şifreleme uygulamayan dışlanmış duyarlılık etiketleri bölümüne girin.

3. Yapılandırmayı kaydedin ve dışlanan etiketi taşıyan, desteklenen bir dosyayla test yapın.

Eşleşen ve desteklenen etiketlere sahip dosyalar SharePoint uygulaması sonuçlarından dışlanır. Şifreleme uygulayan etiketleri taşıyan dosyalar zaten varsayılan olarak dışlanır.

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

Site denetimleri 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ıt 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 denetimler 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.