App Registrierung im Azure AD

Da die Integration verschiedener SSO-Funktionalitäten mit steigenden Sicherheitsanforderungen immer relevanter wird möchten wir Ihnen die Integration der Azure AD Integration vollständig zeigen. Beachten Sie bitte, dass die Azure AD Integration erst ab Version 2.9.0.225 möglich ist.

40%

60%

Wählen Sie dazu innerhalb Ihrer Azure AD Registrierung den Punkt „App Registrierung“ und legen Sie eine neue Registrierung an.

40%

60%

Im nächsten Schritt wird die App selbst registriert. Im Standardfall können Sie die App wie folgt registrieren. Wählen Sie bitte einen eindeutigen Namen und wählen Sie „Nur Konten in diesem Organisationsverzeichnis“. Somit haben Sie eine App registriert und Sie werden in das Untermenü dieser App weitergeleitet.

40%

60%

Sie werden direkt in den Punk Authentifizierung geleitet. Falls Sie unter einen anderen Punkt geleitet wurden, wählen Sie bitte Authentifizierung aus. Hier fügen Sie bitte eine Plattform hinzu und wählen in der Spalte Rechts eine „Mobilgerät- und Desktopanwendung“

40%

60%

Azure AD bietet eine Reihe von Standard-Redirect URIs, wählen Sie im nächsten Schritt https://login.microsoftonline.com/common/oauth2/nativeclient aus.

40%

60%

Sie haben nun die Azure AD Registrierung erstellt.

Wählen Sie nun bitte den Punkt Übersicht. Hier sehen Sie nun die notwendige Client- und Tenant ID. Diese ist für die weitere Konfiguration wichtig.

Sie können die App natürlich weiter konfigurieren. Unter dem Punkt „Rollen und Administration“ können Sie die User oder ganze Gruppen hinzufügen.

Optional: Administratorzustimmung erteilen

40%

60%

Je nach Konfiguration der Azure AD kann es notwendig sein, eine Administratorzustimmung zu erteilen. Klicken Sie hierzu auf den Punkt „API Berechtigungen“ und wählen Sie dann „Administratorzustimmung für Standardverzeichnisse erteilen“.

Konfiguration der Azure AD in SmartNotes

40%

60%

Konfiguration des SmartNotes Servers

Die kopierte Client- und Tenant ID müssen Sie nun in die Konfigurationsdateien des Servers und des Clients einfügen. Die Serverconfig finden Sie in Ihrem Server-Verzeichnis (im Standard C:\Program Files (x86)\Amana Consulting\SmartNotesServer).

Suchen Sie hier den Bereich Appsettings und fügen Sie dort die Client- und Tenant ID ein. Beachten Sie bitte, dass zusätzlich noch die Einträge für SingleSignOnMethod und disableSingleSignOn gesetzt werde müssen (Azure und False) damit die Konfiguration funktioniert.

<add key="TenantId" value="Ihre-Tenant-ID" />

<add key="ClientId" value="Ihre-Client-ID" />

<add key="SingleSignOnMethod" value="Azure" />

<add key="disableSingleSignOn" value="False" />

Starten Sie anschließend den SmartNotes Server neu.

40%

60%

Konfiguration des SmartNotes Clients

Die Config-Datei für den Client finden Sie in Ihrem Client-Verzeichnis (C:\Program Files (x86)\Amana Consulting\SmartNotesClient).

Suchen Sie auch hier den Eintrag Appsettings und fügen Sie dort die folgenden Zeilen hinzu:

<add key="TenantId" value="Ihre-Tenant-ID" />

<add key="ClientId" value="Ihre-Client-ID" />

<add key="SingleSignOnMethod" value="Azure" />

<add key="UseSingleSignOn" value="True" />

Anlage der SmartNotes User

40%

60%

Für den sauberen Abgleich zu SmartNotes sind zu der Anlage der Azure AD App Registrierung auch User innerhalb von SmartNotes notwendig. Öffnen Sie dazu bitte die Berechtigungsverwaltung und legen Sie dort einen neuen Benutzer an.

40%

60%

Mit der Konfiguration als SSO Benutzer erhalten Sie dann beim Start die Azure AD Anmeldemaske. Wichtig ist, dass die Benutzer analog zu Ihrer Anmeldung im Azure AD angelegt werden.

Verknüpfen von Azure AD/Entra ID Gruppen zu SmartNotes

Sie haben auch die Möglichkeit, die Azure AD vollständig anzubinden. Dabei werden die User bei Änderungen automatisch in bestimmten Intervallen aus dem AD geladen. Im Standard passiert dies einmal täglich.

Um diese Anbindung einzurichten, sind zusätzlich Anpassungen in der Serverconfig erforderlich:

Öffnen Sei bitte die SmartNotesServerService.exe.config und kommentieren Sie die folgenden Zeilen ein:

Fügen Sie an dieser Stelle bitte Ihre Client- und Tenant-ID ein, sowie das Secret ein. Dadurch wird der Server technisch für die Anbindung der Azure AD vorbereitet.

Fügen Sie im Bereich AppSettings in der Serverconfig nun bitte noch den Eintrag <add key="UserProvider" value="Azure" /> hinzu.

Außerdem muss ein Secret angegeben werden, welches zuvor verschlüsselt werden muss. Öffnen Sie Kommandozeile (cmd) und navigieren Sie in das SmartNotes Serverzeichnis (im Standard: C:\Program Files (x86)\Amana Consulting\SmartNotesServer) und führen Sie SmartNotes.PasswordEncryptor.exe mit dem Parameterset -p:[IhrClientSecret] und Ihrem Client Secret aus.

Sie erhalten nun das verschlüsselte Client Secret, welches Sie in der Config eintragen können.

In der Clientconfig werden Client- und Tenant-ID wie in der Dokumentation angegeben hinerlegt.

Im letzten Schritt muss in den SmartNotes Systemeinstellungen der Eintrag enableActiveDirectoryAuthentication hinzugefügt werden. Öffnen Sie dazu SmartNotes, und navigieren Sie zu Dokument-> Einstellungen->Grundlegende Einstellungen->Systemeinstellungen öffnen. Hier finden Sie die datenbankseitigen Systemeinstellungen. Scrollen Sie in der Übersicht nach unten und fügen Sie den Eintrag enableActiveDirectoryAuthentication hinzu. Setzen Sie den Wert dazu auf 1 und drücken Sie enter. Anschließend können Sie die Übersicht schließen und in den Einstellungen speichern. Es ist ein Neustart des SmartNotes Servers erforderlich.

Sie können nun in der Gruppen und Rollenverwaltung mit einem Klick auf den Button “Von ActiveDirectory” eine SmartNotes Gruppe an eine Azure AD Gruppe anbinden.