Microsoft Windows Dosya Sistemleri bağlayıcısını dağıtma

Google Cloud Search'i, Google Workspace içeriğinize ek olarak kuruluşunuzun Microsoft Windows paylaşımlarından da sonuç döndürecek şekilde ayarlayabilirsiniz. Google Cloud Search Dosya Sistemleri bağlayıcısını kullanır ve belirtilen Windows paylaşımlarına erişecek şekilde yapılandırırsınız. Tek bir bağlayıcı örneği birden fazla Microsoft Windows paylaşımını destekleyebilir.

Dikkat edilmesi gerekenler

Sürekli otomatik güncellemeler

Varsayılan olarak, bağlayıcı başlatılırken başlangıç yollarını (bağlantı yapılandırması dosyasında fs.src içindeki değerler) sürekli olarak izler. Dosya sistemi, içerik veya erişim denetimlerinde değişiklik olduğunu bildirdiğinde bağlayıcı, dosya sistemini yeniden taraması için tetiklenir. Bu yeniden tarama, kaynakların yoğun bir şekilde kullanılmasına yol açabilir. Dosya sistemi izlemeyi devre dışı bırakmak için fs.monitorForUpdates'ü false olarak ayarlayın. Konnektörün kaynak kullanımını önemli ölçüde azaltırsınız ancak konnektörün değişiklikleri yansıtması gecikir. Daha fazla bilgi

DFS erişim denetimi

DFS sistemi, bağlantılarına erişim denetimi uygular ve genellikle her DFS bağlantısının kendi EKL'si vardır. DFS'nin kullandığı mekanizmalardan biri, kullanıcıya döndürülen DFS bağlantılarını kısıtlayabilen Erişime Dayalı Listeleme'dir (ABE). Kullanıcılar, ABE barındırılan ana dizinleri izole ettiğinde DFS bağlantılarının yalnızca bir alt kümesini veya hatta tek bir bağlantıyı alabilir. Bağlantılayıcı, bir DFS sisteminde gezinirken DFS bağlantı ACL'sine ve hedefin Paylaşım ACL'sine uyar. Paylaşım ACL'si, DFS ACL'sinden devralınır.

Bilinen sınırlamalar

• Dosya Sistemi: Dosya Sistemleri konnektörü, eşlenen sürücüleri ve yerel sürücüleri desteklemez.
• Dağıtılmış Dosya Sistemi: UNC DFS'ye eşlenen bir sürücü düzgün çalışmıyor. Bazı ACL'ler doğru şekilde okunmuyor.
• Dosya Sistemleri bağlayıcısı, Dağıtılmış Dosya Sistemi (DFS) ad alanlarını ve bağlantılarını destekler. Ancak bağlayıcı, DFS ad alanındaki normal klasörleri değil, yalnızca DFS ad alanındaki DFS bağlantılarını destekler.
• cloudsearch.google.com adresinde döndürülen dosya bağlantıları tıklanabilir değildir. Sorgu API'si tarafından döndürülen dosya bağlantıları da çoğu tarayıcıda tıklanamaz.

• Google Cloud Search ile veri kaynağı arasında ilişki oluşturmak için gereken Google Workspace bilgileri:

  • Google Workspace özel anahtarı (hizmet hesabı kimliğini içerir). Özel anahtar edinme hakkında bilgi edinmek için Google Cloud Search REST API'ye erişimi yapılandırma başlıklı makaleyi inceleyin.
  • Google Workspace veri kaynağı kimliği. Veri kaynağı kimliği alma hakkında bilgi edinmek için Arama yapmak için veri kaynağı ekleme başlıklı makaleyi inceleyin.
  • Kimlik kaynağı kimliği. Kimlik kaynağı kimliğinin nasıl alınacağı hakkında bilgi edinmek için Kimlik kaynağı oluşturma başlıklı makaleyi inceleyin. Google Workspace dizininizi Active Directory ile senkronize ediyorsanız kimlik kaynağını GCDS ile ayarlayın.

  Bu kimlik bilgilerini genellikle kuruluşunuzun Google Workspace yöneticisinden alabilirsiniz.

• Windows hesabında aşağıdaki bölümde açıklandığı gibi yeterli izinlerin bulunduğundan emin olun.

Gerekli Microsoft Windows hesap izinleri

Bağlantıyı sağlayan aracının çalıştığı Microsoft Windows hesabının aşağıdaki işlemleri gerçekleştirmek için yeterli izinleri olmalıdır:

• Klasörlerin içeriğini listeleme
• Belgelerin içeriğini okuma
• Dosya ve klasör özelliklerini okuma
• Hem dosyalar hem de klasörler için okuma izinleri (EKL'ler)
• Temel özellikler için yazma izinleri

Aşağıdaki gruplardan birine üye olan Windows hesapları, bağlayıcının ihtiyaç duyduğu yeterli izinlere sahip olur:

• Yöneticiler
• Deneyimli Kullanıcılar
• Yazdırma Operatörleri
• Sunucu Operatörleri

1. Adım: Google Cloud Search Dosya Sistemleri bağlayıcısını yükleme

1. GitHub'dan bağlayıcı deposunu alın ve derleyin.

   Windows sunucusunda git'i kullanmak için:

   1. Kod deposunu klonlayın:

      > git clone https://github.com/google-cloudsearch/windows-filesystems-connector.git
      > cd windows-filesystems-connector

   2. Bağlayıcının istenen sürümüne göz atın:

      > git checkout tags/v1-0.0.3

   Doğrudan GitHub'dan indirmek için:

   1. https://github.com/google-cloudsearch/windows-filesystems-connector adresine gidin.
   2. Klonla veya indir chevron_right Zip dosyasını indir'i tıklayın.
   3. Paketi açın.
   4. Yeni dizine gidin:

      > cd windows-filesystems-connector

2. Bağlayıcıyı oluşturun. Gerekirse Apache Maven'i yükleyin.

   > mvn package

   Bağlantıyı oluştururken testleri atlamak için mvn package yerine mvn package -DskipTests komutunu çalıştırın.

3. Bağlayıcı zip dosyasını yerel yükleme dizininize kopyalayın:

   > cp target/google-cloudsearch-windows-filesystems-connector-v1-0.0.3.zip installation-dir
   > cd installation-dir
   > unzip google-cloudsearch-windows-filesystems-connector-v1-0.0.3.zip
   > cd google-cloudsearch-windows-filesystems-connector-v1-0.0.3

1. Bağlayıcı yüklemesiyle aynı dizinde bir dosya oluşturun ve dosyayı connector-config.properties olarak adlandırın.

2. Aşağıdaki örnekte gösterildiği gibi, parametreleri dosya içeriğine anahtar/değer çiftleri olarak ekleyin:

   ### File system connector configuration ###
   
   # Required parameters for Cloud Search data source and identity source access
   api.serviceAccountPrivateKeyFile=/path/to/file.json
   api.sourceId=0123456789abcde
   api.identitySourceId=a1b1c1234567
   
   # Required parameters for file system access
   fs.src=\\\\host\\share;\\\\dfshost\\dfsnamespace;\\\\dfshost\\dfsnamespace\\link
   
   # Optional parameters for file system monitoring
   traverse.abortAfterExceptions=500
   fs.monitorForUpdates = true
   fs.preserveLastAccessTime = IF_ALLOWED
   

   Her parametrenin ayrıntılı açıklamaları için yapılandırma parametreleri referansı başlıklı makaleyi inceleyin.

3. (İsteğe bağlı) Gerekirse diğer bağlayıcı parametrelerini yapılandırın. Ayrıntılar için Google tarafından sağlanan bağlayıcı parametreleri başlıklı makaleyi inceleyin.

3. Adım: Günlük kaydını etkinleştir

1. Bağlayıcı ikilisini içeren dizinde logs adlı bir klasör oluşturun.

2. Bağlayıcı ikilisini içeren dizinde logging.properties adlı bir ASCII veya UTF-8 dosyası oluşturun ve aşağıdaki içeriği ekleyin:

   handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
   # Default log level
   .level = WARNING
   com.google.enterprise.cloudsearch.level = INFO
   com.google.enterprise.cloudsearch.fs.level = INFO
   
   # uncomment line below to increase logging level to enable API trace
   #com.google.api.client.http.level = FINE
   java.util.logging.ConsoleHandler.level = INFO
   java.util.logging.FileHandler.pattern=logs/connector-fs.%g.log
   java.util.logging.FileHandler.limit=10485760
   java.util.logging.FileHandler.count=10
   java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
   

Varsayılan olarak bağlayıcı, her dosyanın medya türünü JDK tarafından sağlanan medya türü algılama özelliğiyle algılamaya çalışır. Microsoft Windows'ta JDK, dosyaların medya türlerini belirlemek için Windows kayıt defterini kullanır. Eksik bir kayıt defteri girişi, belirli dosyalar için boş bir medya türüne neden olabilir.

Gerekirse mevcut bağlamaların üzerine yazan veya null medya türünü engelleyen bir medya türü belirtebilirsiniz.

1. Bağlayıcı dizininde mime-type.properties adlı Latin-1 ile şifrelenmiş bir dosya oluşturun.

2. Dosya uzantılarını ve bunlara karşılık gelen medya türlerini aşağıdaki örneklerde gösterildiği gibi girin:

   xlsx=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
   one=application/msonenote
   txt=text/plain
   pdf=application/pdf
   

5. Adım: Dosya Sistemleri bağlayıcısını çalıştırın

Dosya Sistemleri bağlayıcısını yükleyip yapılandırdıktan sonra, ana makinede başlatmak için aşağıdaki örnekteki gibi bir komut çalıştırın:

> java -jar google-cloudsearch-windows-filesystems-connector-v1-0.0.3.jar -Djava.util.logging.config.file=logging.properties[ -Dconfig=my.config]

Varsayılandan farklıysa yapılandırma dosyası yolunu belirtin (connector-config.properties adlı ikili dosyanın bulunduğu dizinde).

Yapılandırma parametreleri referansı

Veri kaynağı erişimi

Dosya sistemi erişimi

Yol ayırıcı karakteri

Bağlayıcı davranışı

Zaman damgasının korunması ve tarama kontrolü

Dosya paylaşımı erişim denetimini atlama

Bağlayıcı, varsayılan olarak dosya paylaşımındaki EKL'ler dahil olmak üzere dizine ekleme API'sine erişim kontrol listeleri (EKL'ler) gönderirken erişim denetimi bütünlüğünü korur. Ancak bazı yapılandırmalarda bağlayıcının, paylaşım ACL'sini okumak için yeterli izinleri olmayabilir. Bu durumlarda bağlayıcı, arama sonuçlarında söz konusu dosya paylaşımında bulunan dosyaları döndürmez.

İçeriğin her zaman arama sonuçlarında döndürülmesi için bağlayıcıyı, paylaşım ACL'sini yok sayacak şekilde ayarlayabilirsiniz. Bu durumda dizine ekleme API'si, gerçek paylaşım ACL'si yerine tamamen izin verici bir paylaşım ACL'si alır.