Microsoft SharePoint On-Premises bağlayıcısını dağıtma

Google Cloud Search'ü, Google Workspace içeriğinizin yanı sıra kuruluşunuzun SharePoint şirket içi içeriğinden de sonuç döndürecek şekilde ayarlayabilirsiniz. Cloud Search SharePoint On-Premises bağlayıcısını kullanın ve belirli bir SharePoint veri kaynağına erişmek için bağlayıcıyı yapılandırın.

Dikkat edilecek önemli noktalar

SharePoint On-Premises bağlayıcısını dağıtmadan önce aşağıdaki noktaları göz önünde bulundurun.

Kullanılan SharePoint ayarları

Bağlayıcı, SharePoint'teki Arama Görünürlüğü ayarına her zaman uyar. Taslak dokümanlar için, bağlayıcının SharePoint'e erişmek üzere kullandığı kullanıcı hesabındaki izinler, hangi dokümanların dizine ekleneceğini ve döndürüleceğini kontrol eder. Hesapta "Tam Okuma" izinleri varsa bağlayıcı, "Öğe görünürlüğünü taslak olarak ayarla" ayarlarını dikkate alır.

Ayrıca, Google ve harici asıl kullanıcıları kullanarak erişim kontrol listelerini tanımlayarak sonuçları kullanıcı hesabı erişimine göre de sınırlayabilirsiniz. Güvenlik kırpma işlemini uygulamak için bu harici kimlikleri Google Cloud Directory ile senkronize edin:

  • Active Directory kullanıcıları ve grupları.
  • SharePoint yerel grupları (üye olarak Active Directory kullanıcıları ve gruplarıyla).

AD kullanıcılarını ve gruplarını senkronize etmek için Google Cloud Directory Sync'i kullanın ve kimliği eşlenmiş grupları etkinleştirin. SharePoint yerel grupları için SharePoint kimlik bağlayıcısını kullanın.

Bağlayıcı, Active Directory aramaları da yaparak asıl kullanıcıları senkronize etmek için bilgi getirir (ör. SID'leri sAMAccountName'lere eşleme).

Arama optimizasyonu

Bağlayıcıyı alakalı sonuçlar döndürecek şekilde yapılandırarak arama deneyimini iyileştirin. Alan etki düzeylerini ayarlamak için yapılandırma dosyasında HTML oluşturma parametrelerini kullanın.

Şema oluşturmak için Create and register a schema (Şema oluşturma ve kaydetme) başlıklı makaleyi inceleyin. Şema oluştururken:

  • Bağlayıcı, SharePoint içerik türlerini geçerli nesne tanımı adlarına (A-Z, a-z, 0-9) göre normalleştirir. Örneğin, "Haber Makalesi" yerine "HaberMakalesi" yazılır.
  • Bağlayıcı bir nesne tanımıyla eşleşemezse yedek nesne türünü (itemMetadata.objectType) kullanır. Meta veri yapılandırma parametreleri bölümüne bakın.
  • Bağlayıcı, onaltılık karakterlerin kodunu çözerek ve "ows_" öneklerini kaldırarak özellik adlarını normalleştirir.

Microsoft Outlook iletilerini işleme

Bağlayıcı, Microsoft Outlook .msg dosyalarının medya türünü geçersiz kılar ve bunları application/vnd.ms-outlook olarak indeksler.

Çok kiracılı yapılandırmalar

Çok kiracılı dağıtımlar için site koleksiyonu modunu yapılandırın:

  • Bağlayıcı hesabına site koleksiyonu yöneticisi izinleri verin.
  • sharepoint.server öğesini site koleksiyonu URL'sine (ör. http://sharepoint.example.com/sites/collection).
  • sharepoint.siteCollectionOnly değerini true olarak ayarlayın.

Site koleksiyonu başına bir bağlayıcı örneği yapılandırın.

Bilinen sınırlamalar

  • İzlenen veritabanlarının sayısı arttıkça değişikliklerin algılanma süresi de artar.
  • Bellek kullanımı, erişim kontrol listelerindeki benzersiz kullanıcı ve grup sayısıyla birlikte artar.
  • Bağlayıcı yalnızca tek bir Active Directory alanındaki kimlikleri destekler.
  • Silme bildirimlerinin yayılması dört saatten uzun sürebilir.

Sistem gereksinimleri

Sistem gereksinimleri
İşletim sistemi Windows Server 2016, Ubuntu, Red Hat Enterprise Linux 5.0 veya SUSE Enterprise Linux 10 (64 bit).
Yazılım SharePoint Server 2013 veya 2016; Java JRE 1.8.
Kimlik doğrulama NTLM, Kerberos, HTTP Basic veya ADFS.

Bağlayıcıyı dağıtma

SharePoint On-Premises bağlayıcısını dağıtmak için aşağıdaki adımları uygulayın.

Ön koşullar

  1. Google Workspace özel anahtarı oluşturun. Cloud Search API'ye erişimi yapılandırma başlıklı makaleyi inceleyin.
  2. Arama yapmak için veri kaynağı ekleyin ve kimliğini kaydedin. Aramaya veri kaynağı ekleme başlıklı makaleyi inceleyin.
  3. KACL tabanlı sonuçlar için yöneticinizin iki kimlik kaynağı (biri Active Directory, diğeri SharePoint yerel grupları için) oluşturması ve Google Workspace müşteri kimliğini sağlaması gerekir. Kullanıcı kimliklerini eşleme başlıklı makaleyi inceleyin.
  4. Bağlayıcı için Tam Okuma izinlerine sahip bir kullanıcı hesabı oluşturun.
  5. SharePoint web uygulamasının bir kök site koleksiyonu olduğundan emin olun.
  6. Site koleksiyonları yazma kilidiyle korunuyorsa PrepareWriteLockedSites.ps1 komut dosyasını çalıştırın.

1. Adım: Bağlayıcı yazılımını yükleme

  1. Kod deposunu klonlayın: 
    $ git clone https://github.com/google-cloudsearch/sharepoint-connector.git
$ cd sharepoint-connector
  2. Seçili sürüme göz atın (ör. v1-0.0.5): 
    $ git checkout tags/v1-0.0.5
  3. Bağlayıcıyı oluşturun: 
    $ mvn package
     Testleri atlamak için mvn package -DskipTests simgesini kullanın.
  4. ZIP dosyasını kurulum dizininize çıkarın.

2. adım: Yapılandırma dosyasını oluşturma

Yükleme dizininde connector-config.properties oluşturun. Parametreleri anahtar/değer çiftleri olarak ekleyin:

api.sourceId=08ef8becd116faa4546b8ca2c84b2879
api.serviceAccountPrivateKeyFile=service_account.json
api.identitySourceId=08ef8becd116faa475de26d9b291fed9
sharepoint.server=http://sp-2016:32967/sites/collection
sharepoint.siteCollectionOnly=true
sharepoint.username=contoso\\admin
sharepoint.password=password
adLookup.host=dc.contoso.com
adLookup.username=contoso\\admin
adLookup.password=password

Ayrıntılar için referans veya Google tarafından sağlanan parametreler bölümüne bakın.

3. Adım: SharePoint'i güvenilen ana makine olarak ekleme (HTTPS)

HTTPS kullanıyorsanız SharePoint sertifikasını dışa aktarın ve bağlayıcının anahtar deposuna aktarın: 

$ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

4. Adım. Günlük kaydını ayarlama

Bu içerikle bir logs klasörü ve bir logging.properties dosyası oluşturun: properties handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler .level = INFO java.util.logging.ConsoleHandler.level = INFO java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log

5. Adım: Kimlik bağlayıcısını yapılandırma

Kimliğe dayalı erişim kontrol listelerini uygulamak için sharepoint-onprem-identity-connector.config ile api.customerId ve diğer bağlantı parametreleriyle birlikte oluşturun.

6. Adım: Bağlayıcıyı başlatma

  1. Active Directory kullanıcılarını ve gruplarını senkronize etmek için GCDS'yi çalıştırın.
  2. Site koleksiyonu gruplarını senkronize etmek için SharePoint kimlik bağlayıcısını çalıştırın.
  3. İçeriği dizine eklemek için SharePoint şirket içi bağlayıcısını çalıştırın.

Yapılandırma parametreleri referansı

Aşağıdaki bölümlerde, SharePoint şirket içi bağlayıcısını yapılandırmak için kullanılan yapılandırma parametreleri listelenmektedir.

Veri kaynağı erişimi

Ayar Parametre
Veri kaynağı kimliği api.sourceId=ID
Hizmet hesabı api.serviceAccountPrivateKeyFile=path

SharePoint şirket içi erişimi

Ayar Parametre
Sunucu URL'si sharepoint.server=URL
Kimlik bilgileri sharepoint.username ve sharepoint.password

HTML içeriği oluşturma

Ayar Parametre
Başlık alanı contentTemplate.sharePointItem.title=Title
Kalite alanları contentTemplate.sharePointItem.quality.high, medium veya low