SharePoint Online Connector

Transkript

1 SharePoint Online Connector Installation und Konfiguration Version 2017 Summer Release Status: 12. Juni 2017

2 Copyright Mindbreeze GmbH, A-4020 Linz, Alle Rechte vorbehalten. Alle verwendeten Hard- und Softwarenamen sind Handelsnamen und/oder Marken der jeweiligen Hersteller. Diese Unterlagen sind streng vertraulich. Durch die Übermittlung und Präsentation dieser Unterlagen alleine werden keine Rechte an unserer Software, an unseren Dienstleistungen und Dienstleistungsresultaten oder sonstigen geschützten Rechten begründet. Die Weitergabe, Veröffentlichung oder Vervielfältigung ist nicht gestattet. Aus Gründen der einfacheren Lesbarkeit wird auf die geschlechtsspezifische Differenzierung, z.b. Benutzer/- innen, verzichtet. Entsprechende Begriffe gelten im Sinne der Gleichbehandlung grundsätzlich für beide Geschlechter. Installation und Konfiguration 2

3 Inhalt 1 Installation Installation des Plugins via Mindbreeze Management Center 4 2 Konfiguration von Mindbreeze Konfiguration von Index und Crawler 4 Installation und Konfiguration 3

4 1 Installation Vor der Installation des SharePoint Online Konnektors muss sichergestellt werden, dass der Mindbreeze Server installiert und der SharePoint Online Konnektor in der Lizenz inkludiert ist. Zur Installation oder Aktualisierung des Konnektors verwenden Sie bitte das Mindbreeze Management Center. 1.1 Installation des Plugins via Mindbreeze Management Center Zur Installation des Plugins, öffnen Sie das Mindbreeze Management Center. Wählen Sie aus dem linken Menü den Punkt Configuration aus. Anschließend navigieren Sie auf den Reiter Plugins. Im Abschnitt Plugin Management wählen Sie die entsprechende Zip-Datei aus laden sie durch Auswahl der Schaltfläche Upload hoch. Damit wird der Konnektor automatisch installiert oder gegebenenfalls aktualisiert. In diesem Zuge werden die Mindbreeze Dienste neugestartet. 2 Konfiguration von Mindbreeze Wählen Sie zur Konfiguration die Installationsmethode Advanced. 2.1 Konfiguration von Index und Crawler Navigieren Sie auf den Reiter Indices und klicken Sie auf das Symbol Add new index rechts oben, um einen neuen Index zu erzeugen. Installation und Konfiguration 4

5 Geben Sie den Pfad zum Index ein und ändern Sie gegebenenfalls des Display Name. Fügen Sie eine neue Datenquelle durch Klick auf das Symbol Add new custom source rechts oben hinzu. Wählen Sie die Category Microsoft SharePoint Online und konfigurieren Sie die Datenquelle nach Ihren Bedürfnissen. Installation und Konfiguration 5

6 Im Bereich Sharepoint Online können Sie Ihre Microsoft SharePoint Online Installation, die indiziert werden soll, definieren. Server URL und Site Relative URL definieren Ihre Microsoft SharePoint Online Installation und sind zwingend erforderlich. Über Included URL (regex) bzw. Excluded Sites URL (regex) können Sie definieren, welche Subsites Ihrer Microsoft SharePoint Online Installation in den Index aufgenommen oder von der Indizierung ausgenommen werden sollen. Falls hier keine Einstellungen vorgenommen werden, werden alle Subsites indiziert. Durch Setzen der Option Crawl hidden lists werden auch Listen, die als versteckt definiert sind, indiziert. Ähnliches gilt für die Option Crawl lists with property NoCrawl. Ist diese Option gesetzt, werden auch jene Listen indiziert, die in Microsoft SharePoint Online die Eigenschaft NoCrawl besitzen. Wählen Sie Advanced Settings um die folgenden Einstellungen vorzunehmen. Aktivieren Sie die Optionen Enforce ACL Evaluation. Fügen Sie im Bereich Services durch Klick auf add new Service ein neues Service hinzu. Wählen Sie SharepointOnlinePrincipalCache aus und vergeben Sie einen Anzeigenamen. Installation und Konfiguration 6

7 Tragen Sie im Bereich Sharepoint Settings die Informationen zu Ihrer Microsoft SharePoint Online Installation ein. Server URL und Site Relative URL müssen den Einstellungen im Bereich Data Source entsprechen. Included URL (regex) sowie Excluded Sites URL (regex) werden hier derzeit noch nicht berücksichtigt. Unter Regex for your organization können sie einen regulären Ausdruck eintragen, der definiert, ob ein Benutzer Ihrer Organisation angehört oder nicht. Der reguläre Ausdruck kann sich dabei auf die -Adresse, die ObjectSID oder die ObjectGUID aus LDAP beziehen. Falls Sie in Azure Active Directory die Funktion AD Connect nicht eingerichtet haben, wählen Sie AD Connect is NOT configured und füllen Sie die Felder Tenant Context ID, Application ID, Generated Key und Protected Resource Hostname aus. Die entsprechenden Werte finden Sie im Azure Portal. Ist AD Connect in Ihrem Azure Active Directory eingerichtet, aktivieren Sie die Option AD Connect is NOT configured nicht. Für die Auflösung der Benutzer aus dem Active Directory, wird ein LDAP-Cache benötigt. Wie Sie so einen Caching Principal Resolution Service einrichten können, wird unter folgendem Link beschrieben: Caching-Principal-Resolution-Service/index.htm Im LDAP-Cache sollten unter User Alias Name LDAP Attribute bzw. User Alias Name LDAP Attribute folgende Werte eingetragen sein: mail cn objectguid objectsid Installation und Konfiguration 7

8 Hinterlegen Sie die Informationen zum LDAP-Cache im Bereich LDAP Settings. Aktivieren Sie die Option Use LDAP Principals Cache Service und tragen Sie den entsprechenden Port Ihres LDAP Principal Caches ein. Konfigurieren Sie im Bereich Cache Settings, wo sich die Datenbank für den Cache befinden soll und stellen Sie das gewünschte Intervall für die Updates ein. Tragen Sie im Bereich Service Settings einen freien Port ein, der für den Principal Cache verwendet werden soll und aktivieren Sie die Option Lowercase Principals, damit die SharePoint Gruppen korrekt aufgelöst werden können. Navigieren Sie nun zum Reiter Network und fügen Sie im Bereich Credentials durch Klick auf Add Credential ein neues Credential für Microsoft SharePoint Online hinzu. Installation und Konfiguration 8

9 Tragen Sie die Zugangsdaten für den User, mit dem die Indizierung erfolgen soll, ein und vergeben Sie einen Namen für das Credential. Wählen Sie einen Benutzer mit genügend Rechten um alle relevanten Seiten und die Berechtigungen auslesen zu können. Fügen Sie anschließend im Bereich Endpoints durch Klick auf Add Endpoint einen neuen Endpoint für das eben erstellte Credential hinzu. Tragen Sie als Location die Server URL Ihrer Microsoft SharePoint Online Installation ein und wählen Sie das zuvor erstellte Credential aus. Installation und Konfiguration 9