ELO Wiki

Seite bearbeiten und [Speichern] drücken. Siehe syntax zur Wiki-Syntax. Bitte nur editieren, falls das Dokument tatsächlich verbessert werden kann. Zum Testen bitte erst im Spielplatz üben.

====== ELO Sync Konfiguration ======

Die Dokumentation ist hier ELO-seitig fragmentiert.
Auf der Hauptdokumentationsseite ist hier folgendes zu finden:

Das beschreibt das Userinterface und die Konfigurationsmöglichkeiten, grosso modo.

* https://docs.elo.com/user/elo-for-microsoft-365/de-de/elosync/

Der richtige Einstieg zur Einrichtung ist hier der folgende:

* https://docs.elo.com/admin/elo-sync/25.0/de-de/startup/

===== Voraussetzungen für ELO Sync =====

* ELO-Sync 25 kann hier installiert werden für
    * ELO 23 LTS mit ELOauth
    * ELO 23.06 mit ELOauth2
    * ELO 25 mit ELOauth 2

===== Voraussetzungen für ELOauth/ELOauth2 =====

* Wichtig: Auth2/Auth muss mit dem Profil elo_sync_oauth mit der Applikations-Id, die Sharepoint Zugriff hat konfiguriert werden (nicht mit der ELOauth Vorgabe)
  * Darüber hinaus kann hier auch mit ClientSecrets gearbeitet werden

===== Voraussetzungen an die Datenbank =====

* ORACLE: de facto zzt. unmöglich (Stand 14.04.2026) ohne Einbindung des Supports, der dann wahrscheinlich eine neue Version zur Verfügung stellen müsste, trotz Erwähnung in der Dokumentation
    * Probleme
      * ELO Sync 25: gar keine Assemblies für ORACLE mehr vorhanden, somit kein Connect möglich.
      * ELO Sync 23: Connect zu ORACLE noch möglich, danach allerdings schlägt das Anlegen der ersten Tabelle durch das EF schon fehl (DEFAULT False statt DEFAULT 0 führt zu einem ORA-Syntaxfehler). Selbst wenn man diese manuell anlegt wird sie einfach nicht erkannt, danach knallt es einfach wieder, weil er ohnehin wieder die erste Tabelle anlegen will.
  * SQLServer: funktioniert sowohl mit ELOSync 23/25
  * SQLite: 
    * ELO Sync 23/25: legt hier 27 von 29 Tabellen an, eine davon falsch mit fehlendem Feld
  * PostGres: unbekannt

===== Manuelle Installation oder Installation über das Serversetup =====

Eine automatisierte Installation steht hier über das ELO Serversetup ab Version 23.06 zur Verfügung. Hier müssen aber ggf. noch Nachbesserungen erfolgen.

* Diese erfolgen über die AppSettings.json des ELO-Sync Dienstes
    * Der Connection-String kann hier je nach Aktualität Ihrer Umgebung noch inkorrekt sein
      * Bspw. kann eine Ergänzung mit TrustServerCertificate=True;Encrypt=True notwendig sein, wenn hier im Log ein Hinweis auf einen Verbindungs-Fehler zum SQL Server auftaucht.
      * Es ist notwendig die Applikationsdaten aus O365 zu hinterlegen
        * Entweder ClientSecret oder Zertifikat
        * Tenant-Id, Applikations/ClientId
===== Vorbereitung eines Benutzers =====

Bereiten Sie einen Benutzer vor, der hier die E-Mail Adresse jenes Benutzers beinhaltet, der hier später im Azure Ad angemeldet werden kann. Vorzugsweise wird das Ihr eigener Benutzer oder jener des Administrators des Kunden sein. Dieser Benutzer braucht administrative Berechtigungen, um hier auf die Konfigurationsseite der ELO Sync zugreifen zu können.

===== Fehler in der Dokumentation =====

Bei der Konfiguration hat sich bei der Konfiguration des AzureAd ein Fehler eingeschlichen, bzw. wird möglicherweise mit einem alten Namenswert gearbeitet. Hier können ja Zertifikate hinterlegt werden. Im Normalfall muss hier auch über die Zertifikatsauthentifizierung gearbeitet werden. Hier wird ein Property mit dem Namen "CertificateSourceType" angegeben, der richtige Name wäre aber "SourceType".

===== Vorbereitungen Sharepoint =====

* Legen Sie im Azure Portal vorzugsweise eine neue Applikation für die Sync an
  * Bedenken Sie, dass ab 04/2026 keine ACS Registrierungen mehr im SharePoint möglich sind
    * ACS Registrierungen sind hier die Trustships von Sharepoint Service zu Applikation
    * Es gibt hier kein Replacement per se außer, dass man mit Zertifikatsauthentifizierung arbeiten muss
    * Dann werden die Zugriffe automatisch ermöglicht.
  * Anmeldungen mit ClientId/ClientSecret werden als "Legacy" bewertet und sind de facto eher abgekündigt für Sharepoint. Sie sollten generell Zertifikate verwenden.
  * Wenn Sie bestehende Applikationen verwenden wollen, dann stellen Sie hier sicher, dass hier keine Client-Secrets mehr verwendet werden (auch keine alten), hinterlegen Sie hier gleich ein Zertifikat.
    * Ansonsten kommt ggf. folgende Fehlermeldung selbst bei korrekter Installation
      * https://learn.microsoft.com/en-us/answers/questions/1694039/how-to-fix-aadsts90023-v2-tokens-require-asymmetri

===== Konfiguration EloAuth2 =====

Die Konfiguration von EloAuth2 erfolgt über die Admin-Console (Login settings)

* Tenant: <Tenant-Id>
    * Application-Id: <Application/Client Id der Sharepoint App>
    * Audience: 00000003-0000-0000-c000-000000000000
    * PKCE verwenden: ja
    * Name: deckungsgleich mit Config (Default: elo_sync_oauth)
    * Bezeichnung: frei, sinnvoller Name wie ELOSync
    * Hidden (neuere ELO Versionen): ja (versteckt den Login Button für den User, mit dem er ohnehin nicht viel anfangen kann)

Zusammenfassung

Hinweis: Durch das Bearbeiten dieser Seite geben Sie Ihr Einverständnis, dass Ihr Inhalt unter der folgenden Lizenz veröffentlicht wird: CC Attribution-Share Alike 4.0 International