Stoppen Sie den Server und öffnen Sie die Datei SmartNotesService.config in einem Editor.
Gehen Sie zum Abschnitt appSettings und legen Sie die nebenstehenden Einstellungen fest.
Panel
title
Client-seitige Konfiguration
Section
Column
width
40%
Column
width
60%
Beenden Sie den SmartNotes-Client, wechseln Sie in den Installationsordner und öffnen Sie die Datei SmartNotes.config im Editor. Entkommentieren Sie die Section „AuthenticationSettings" indem Sie die Zeichen „<!--" (am Anfang der Zeile) und „-->" (am Ende der Zeile) entfernen.
Section
Column
width
40%
Column
width
60%
Entkommentieren Sie ebenfalls die „AuthenticationSettings" und legen die folgenden Einstellungen fest:
ClientId
AuthorizationEndpoint
ClientSecret
TokenEndpoint
UseDefaultBrowser=“True“
ProviderMetadata
Section
Column
width
40%
<add key="useSingleSignOn" value="True" />
<add key="SingleSignOnMethod" value="OAuth" />
Column
width
60%
Gehen Sie nun zum Abschnitt „AppSettings" und ändern Sie die nebenstehende zwei Einstellungen bzw. tragen diese ein, falls noch nicht vorhanden.
Panel
title
Einrichten der Azure AD Authentication
Section
Column
width
40%
Column
width
60%
Serverseitige Konfiguration
Die Einrichtung der Authentication über Azure AD ist vereinfacht und erfordert nicht die Eingabe von Metadata, Redirect URI und ähnlichem, da diese bereits fest in der Programmierung vorhanden ist.
Öffnen Sie bitte die SmartNotesServer.exe.config im SmartNotesServer-Installationsverzeichnis.
Bitte entfernen Sie die <!-- und → im Bereich AzureActiveDirectoryConnectionSettings.
Section
Column
width
40%
<add key="SingleSignOnMethod" value="Azure" />
<add key="DisableSingleSignOn" value="false" />
Column
width
60%
Fügen Sie bitte diese Einträge im Bereich AppSettings hinzu.
Section
Column
width
40%
Column
width
60%
Im Abschitt AzureActiveDirectoryEntries müssen Sie dann noch die Client- und TenantId pflegen.
Section
Column
width
40%
<add key="ClientId" value="Needed Value" />
<add key="TenantId" value="Needed Value" />
<add key="SingleSignOnMethod" value="Azure" />
<add key="UseSingleSignOn" value="false" />
Column
width
60%
Clientseitige Einrichtung
Fügen Sie bitte diese Einträge im Bereich AppSettings hinzu.
Panel
title
Verschlüsselung des Client Secrets
Section
Column
width
40%
Column
width
60%
Bei manchen oAuth Diensten kann es notwendig sein, einen Client Secret einzugeben. SmartNotes bietet für die Verschlüsselung eine Methode an.
Ö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.
Section
Column
width
40%
Column
width
60%
Sie erhalten nun das verschlüsselte Client Secret, welches Sie in der Config eintragen können.
Panel
title
Test der oAuth Verbindung
Section
Column
width
40%
Column
width
60%
Der SmartNotes Client bietet die Möglichkeit, die Verbindungsdaten zu oAuth zu testen, bevor diese produktiv verwendet werden.
Sie umgehen mit einem vorherigen Test möglicherweise Fehler in der Konfiguration. Starten Sie dazu bitte einfach die Amana.SmartNotes.AuthenticationApp.exe
Section
Column
width
40%
Column
width
60%
Geben Sie bitte hier Ihre oAuth Daten ein. Beachten Sie bitte, dass unter Umständen alle Felder oder nur einzelne benötigt werden.
Über das Dropdown auf der linken Seite können Sie zwischen oAuth und Azure Authentication auswählen.
Im Screenshot sehen Sie beispielhaft eine Authentication über Google oAuth.
Stop the server and open the SmartNotesService.config file in an editor.
Go to the appSettings section and set the adjoining settings.
Panel
title
Client side configuration
Section
Column
width
40%
Column
width
60%
Exit the SmartNotes client, go to the installation folder and open the SmartNotes.config file in the editor. Uncomment the section "AuthenticationSettings" by removing the characters "<!--" (at the beginning of the line) and "-->" (at the end of the line).
Section
Column
width
40%
Column
width
60%
Also uncomment the "AuthenticationSettings" and set the following settings:
ClientId
AuthorizationEndpoint
TokenEndpoint
UseDefaultBrowser=“True“
ProviderMetadata
Section
Column
width
40%
<add key="useSingleSignOn" value="True" />
<add key="SingleSignOnMethod" value="OAuth" />
Column
width
60%
Now go to the "AppSettings" section and change the two settings opposite or enter them if they do not yet exist.
Panel
title
Setting up Azure AD Authentication
Section
Column
width
40%
Column
width
60%
Server-side configuration
Setting up authentication via Azure AD is simplified and does not require entering metadata, redirect URI and the like, as it is already hardcoded.
Please open the SmartNotesServer.exe.config in the SmartNotesServer installation directory.
Please remove the <!-- and → in the AzureActiveDirectoryConnectionSettings section.
Section
Column
width
40%
<add key="SingleSignOnMethod" value="Azure" />
<add key="DisableSingleSignOn" value="false" />
Column
width
60%
Please add these entries in the AppSettings section.
Section
Column
width
40%
Column
width
60%
In the AzureActiveDirectoryEntries section, you must then maintain the ClientId and TenantId.
Section
Column
width
40%
<add key="ClientId" value="Needed Value" />
<add key="TenantId" value="Needed Value" />
<add key="SingleSignOnMethod" value="Azure" />
<add key="UseSingleSignOn" value="false" />
Column
width
60%
Client-side configuration
Please add these entries in the AppSettings section.
Panel
title
Encryption of the Client Secret
Section
Column
width
40%
Column
width
60%
For some oAuth services it may be necessary to enter a client secret. SmartNotes provides a method for encryption.
Open command line (cmd) and navigate to the SmartNotes server directory (by default: C:\Program Files (x86)\Amana Consulting\SmartNotesServer) and run SmartNotes.PasswordEncryptor.exe with the parameter set -p:[yourClientSecret] and your Client Secret.
Section
Column
width
40%
Column
width
60%
You will now receive the encrypted Client Secret, which you can enter in the Config.
Panel
title
Testing the oAuth Connection
Section
Column
width
40%
Column
width
60%
The SmartNotes Client offers the possibility to test the connection data to oAuth before using it productively.
You may bypass errors in the configuration with a previous test. To do this, simply start the Amana.SmartNotes.AuthenticationApp.exe
Section
Column
width
40%
Column
width
60%
Please enter your oAuth data here. Please note that all fields or only some of them may be required.
Use the dropdown on the left to choose between oAuth and Azure Authentication.
The screenshot shows an example of an authentication via Google oAuth.