Wdrażanie lokalnego oprogramowania sprzęgającego Microsoft SharePoint

Obsługa wiadomości w programie Microsoft Outlook

Gdy podczas indeksowania treści usługa łączy się z plikami .msg programu Microsoft Outlook, zastępuje typ multimediów dla tych plików i indeksuje je jako application/vnd.ms-outlook..

Konfiguracje dla wielu najemców

Jeśli SharePoint jest wdrożeniem wielodostępnym, w którym wiele witryn klientów jest hostowanych w tej samej aplikacji internetowej, musisz skonfigurować tryb kolekcji witryn w pliku konfiguracji. W przypadku wdrożeń wielodostępowych masz uprawnienia tylko do kolekcji witryn i nie możesz uzyskać uprawnień Pełny odczyt, które są wymagane przez oprogramowanie sprzęgające SharePoint On-Prem.

Aby włączyć tryb kolekcji witryn:

• Przyznaj kontu użytkownika łącznika uprawnienia administratora kolekcji witryn.
• Ustaw wartość sharepoint.server w pliku konfiguracji oprogramowania sprzęgającego na adres URL kolekcji witryn, np. http://sharepoint.example.com/sites/sitecollection. Adres URL nie musi być zapisany w takim samym przypadku jak w SharePoint.
• Ustaw wartość sharepoint.siteCollectionOnly w pliku konfiguracji oprogramowania sprzęgającego na true.

Jeśli masz wiele zbiorów witryn do zindeksowania w środowisku wielodzierżawnym, musisz skonfigurować po jednym wystąpieniu łącznika dla każdego z nich.

Znane ograniczenia w przypadku usługi Connectors

• Czas potrzebny na wykrycie zmian elementów w bazach danych wydłuża się wraz z liczbą monitorowanych przez łącznik baz danych.
• Zużycie pamięci wzrasta wraz z liczbą unikalnych użytkowników i grup używanych w uprawnieniach dostępu do poszczególnych kolekcji witryn.
• Możesz skonfigurować łącznik z tożsamościami z tylko jednej domeny Active Directory.
• Niektóre typowe podmioty Active Directory i Windows, takie jak Everyone, BUILTIN\Users i All Authenticated Users, nie są obsługiwane.
• Powiadomienia o usunięciu nie są wysyłane natychmiast. Może minąć ponad 4 godziny, zanim oprogramowanie sprzęgające wykryje, że użytkownik usunął treści z repozytorium źródłowego.

Wymagania systemowe

Wdrażanie oprogramowania sprzęgającego

Wymagania wstępne

Krok 2. Tworzenie pliku konfiguracji lokalnego oprogramowania sprzęgającego SharePoint

Krok 3. W przypadku HTTPS dodaj SharePoint jako zaufany host

Jeśli SharePoint jest skonfigurowany pod kątem używania HTTPS, pobierz certyfikat SharePoint, aby dodać go jako zaufany host dla łącznika.

1. Na komputerze, na którym ma działać łącznik, otwórz przeglądarkę i przejdź do SharePoint.

2. Na wyświetlonej stronie z ostrzeżeniem kliknij Rozumiem ryzyko i Dodaj wyjątek. Na stronie wyświetla się komunikat, np. „To połączenie nie jest zaufane”, ponieważ certyfikat jest podpisany samodzielnie, a nie przez zaufany urząd certyfikacji.

3. Gdy pojawi się przycisk Wyświetl, kliknij go.

4. Otwórz kartę Szczegóły i kliknij Eksportuj.

5. Zapisz certyfikat w katalogu oprogramowania sprzęgającego o nazwie sharepoint.crt.

6. Aby zamknąć okna, kliknij Zamknij, a potem Anuluj.

7. Otwórz wiersz polecenia i wpisz to polecenie:

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

   Gdy pojawi się pytanie „Zaufać temu certyfikatowi?”, odpowiedz tak.

Krok 4. Skonfiguruj logowanie

1. W katalogu zawierającym plik binarny oprogramowania sprzęgającego utwórz folder o nazwie logs.

2. W tym samym katalogu (nie logs) utwórz plik o nazwie logging.properties zakodowany w formacie Latin1.

3. Dodaj do pliku logging.properties ten tekst:

   handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
   # Default log level
   .level = INFO
   # uncomment line below to increase logging level for SharePoint APIsa
   #com.google.enterprise.cloudsearch.sharepoint.level=FINE
   
   # 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-sharepoint.%g.log
   java.util.logging.FileHandler.limit=10485760
   java.util.logging.FileHandler.count=10
   java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
   

Krok 5. Konfigurowanie lokalnego oprogramowania sprzęgającego tożsamości SharePoint

Ten krok jest wymagany, aby zastosować do wyników wyszukiwania reguły dostępu oparte na tożsamości w SharePoint On-Prem. Jeśli skonfigurujesz konwerter za pomocą publicznych reguł kontroli dostępu, możesz pominąć ten krok.

1. W tym samym katalogu, w którym znajduje się instalacja łącznika SharePoint Online, utwórz plik o nazwie sharepoint-onprem-identity-connector.config.

2. Dodaj parametry jako pary klucz-wartość do zawartości pliku, jak w tym przykładzie:

   ### SharePoint On-prem identity connector configuration ###
   
   # Required parameters for data source access
   api.customerId=C05d3djk8
   api.serviceAccountPrivateKeyFile=service_account.json
   api.identitySourceId=08ef8becd116faa475de26d9b291fed9
   
   # Required parameters for SharePoint access
   sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
   sharepoint.siteCollectionOnly=true
   sharepoint.username=contoso\\admin
   sharepoint.password=pa$sw0rd
   sharepoint.stripDomainInUserPrincipals=true
   
   # Required parameters for AD lookup
   adLookup.host=dc.contoso.com
   adLookup.username=contoso\\admin
   adLookup.password=pa$sw0rd
   api.referenceIdentitySources=CONTOSO,contoso
   api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
   api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
   

   Wartości są prawie takie same jak w przypadku łącznika SharePoint On-Prem, z tym że zamiast api.sourceId jest parametr api.customerId. Wartością parametru api.customerId jest identyfikator klienta otrzymany od administratora Google Workspace.

Krok 6. Uruchamianie lokalnego oprogramowania sprzęgającego SharePoint

W kolejnych krokach zmapujesz podmioty zarówno w usłudze Active Directory na komputerze lokalnym, jak i w kolekcji witryn SharePoint do tożsamości w usłudze Cloud Identity. Synchronizacja jest wykonywana za pomocą Google Cloud Directory Sync (GCDS) i łącznika tożsamości SharePoint On-Prem.

Po zsynchronizowaniu użytkowników i grup przez GCDS, aby zsynchronizować grupy kolekcji witryn SharePoint, uruchom złącze tożsamości SharePoint na platformie lokalnej. Na koniec uruchom oprogramowanie sprzęgające SharePoing On-Prem, aby zindeksować i przekazać wyniki użytkownikom Cloud Search.

Dostęp do źródła danych

Dostęp do SharePoint w środowisku lokalnym

Indeksowanie kolekcji witryn

Mapowanie tożsamości w SharePoint

Wyszukiwanie w Active Directory

Generowanie treści HTML