...
| width | 60% |
|---|
...
| width | 100% |
|---|
...
...
...
| width | 40% |
|---|
...
| bgColor | #ECECEC |
|---|
...
...
| German | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
|
...
...
|
...
|
...
...
| title | Client side configuration |
|---|
...
| Column | ||
|---|---|---|
| ||
|
| Column | ||
|---|---|---|
| ||
Exit the SmartNotes client, go to the installation folder and open the SmartNotes.config file in the editor. |
...
| Column | ||
|---|---|---|
| ||
|
...
| width | 60% |
|---|
Also uncomment the "AuthenticationSettings" and set the following settings:
- ClientId
- AuthorizationEndpoint
- TokenEndpoint
- UseDefaultBrowser=“True“
- ProviderMetadata
...
| Column | ||
|---|---|---|
| ||
<add key="useSingleSignOn" value="True" /> <add key="SingleSignOnMethod" value="OAuth" /> |
| Column | ||
|---|---|---|
| ||
Now go to the "AppSettings" section and change the two settings opposite or enter them if they do not yet exist. |
...
| title | Setting up Azure AD Authentication |
|---|
...
| Column | ||
|---|---|---|
| ||
|
| Column | ||
|---|---|---|
| ||
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. |
...
| Column | ||
|---|---|---|
| ||
<add key="SingleSignOnMethod" value="Azure" /> <add key="DisableSingleSignOn" value="false" /> |
| Column | ||
|---|---|---|
| ||
Please add these entries in the AppSettings section. |
...
| width | 40% |
|---|
...
| Column | ||
|---|---|---|
| ||
In the AzureActiveDirectoryEntries section, you must then maintain the ClientId and TenantId. |
...
| Column | ||
|---|---|---|
| ||
<add key="ClientId" value="Needed Value" /> <add key="TenantId" value="Needed Value" /> <add key="SingleSignOnMethod" value="Azure" /> <add key="UseSingleSignOn" value="false" /> |
| Column | ||
|---|---|---|
| ||
Client-side configuration Please add these entries in the AppSettings section. |
...
| title | Encryption of the Client Secret |
|---|
...
| width | 40% |
|---|
...
| Column | ||
|---|---|---|
| ||
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. |
...
| width | 40% |
|---|
...
| Column | ||
|---|---|---|
| ||
You will now receive the encrypted Client Secret, which you can enter in the Config. |
...
| title | Testing the oAuth Connection |
|---|
...
| width | 40% |
|---|
...
| Column | ||
|---|---|---|
| ||
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 |
...
| Column | ||
|---|---|---|
| ||
|
| Column | ||
|---|---|---|
| ||
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. |
...
| borderColor | #666666 |
|---|---|
| bgColor | #ECECEC |
| borderWidth | 2 |
...
| Column | ||
|---|---|---|
| ||
| Column | ||
|---|---|---|
| ||
...
| width | 33% |
|---|
...
|
...
| borderColor | #666666 |
|---|---|
| bgColor | #ECECEC |
| borderWidth | 2 |
...
| Column | ||
|---|---|---|
| ||
| Column | ||
|---|---|---|
| ||
| Column | ||
|---|---|---|
| ||
...
| width | 60% |
|---|
...
| width | 100% |
|---|
How to configure OAuth authentication in SmartNotes
As with all other user types in SmartNotes: native or ActiveDirectory;
OAuth Azure AD users must exist in SmartNotes to be able to log in and must be marked with SSO.
ActiveDirectory users can be imported with the AD connector, the rest must be created manuall
| Info |
|---|
OAuth authentication is only possible from the next SmartNotes version (>2.9.0.225)! |
...
| width | 40% |
|---|
| Panel | ||
|---|---|---|
| ||
...
| title | Server side configuration |
|---|
...
| Column | ||
|---|---|---|
| ||
<add key="ClientId" value="Needed Value" /> <add key="ProviderMetadata" value="Needed Value" /> <add key="SingleSignOnMethod" value="OAuth" /> <add key="DisableSingleSignOn" value="false" /> |
| Column | ||
|---|---|---|
| ||
Stop the server and open the SmartNotesService.config file in an editor. Go to the appSettings section and set the adjoining settings. |