Installation des Backends

1. Navigieren Sie in einem Eingabeaufforderungsfenster zum Verzeichnis <enaio_install>\service-manager\tools\sam.

2. Führen Sie den folgenden Befehl aus: sam install <colab_localfolder>\colab-app.jar

   In einer Meldung wird angezeigt, dass die Konfiguration gespeichert und enaio® coLab installiert wurde.

3. Kopieren Sie die Datei <colab-localfolder>\colab-prod.yml in das Verzeichnis <enaio_installation>\service-manager\config.

1. Öffnen Sie die Konfigurationsdatei C:\Program Files\PostgreSQL\10\data\pg_hba.conf und suchen Sie den Eintrag host all all 127.0.0.1/32 md5.

2. Kopiere Sie die Zeile und füge Sie sie noch einmal ein.

3. Ersetzen Sie die IP 127.0.0.1 durch Ihre Server-IP-Adresse und speichern Sie die Datei.

4. Um die Postgres-Konfiguration neu zu laden, öffnen Sie 'pgAdmin 4' als Postgres-Benutzer.

5. Führen Sie die folgende Abfrage aus:

   select pg_reload_conf();

Ebenfalls notwendig ist für Neuinstallationen folgender Eintrag in der colab-prod.yml:

liquibase:
  contexts: legacy

1. Melden Sie sich unter https://console.developers.google.com an.

2. Erstellen Sie ein neues Projekt und wechseln Sie in den Bereich Credentials.

3. Klicken Sie auf Create credentials und wählen Sie den Eintrag OAuth client ID aus.

4. Wählen Sie als Anwendungstyp Web application aus.

5. Rufen Sie Client-ID und Client Secret ab und tragen Sie die Daten in den entsprechenden Bereich in der Konfigurationsdatei colab-prod.yml ein.

6. Klicken Sie auf Authorized JavaScript originsund geben Sie Ihre Domäne mit dem Protokoll ein, auf dem enaio® gateway installiert ist.

   Beispiel: http://<gateway-IP>:colab

7. Geben Sie unter Authorized redirect URIs Ihren Domänennamen gefolgt von /epr/login/google/ ein.

   Beispiel: http://<gateway-IP>/colab/epr/login/google

8. Passen Sie die Datei <enaio_installation>\service-manager\config\colab-prod.yml an:

google:
 enable: true
 client:
   clientId: <client_id>
   clientSecret: <client_secret>
   accessTokenUri: https://accounts.google.com/o/oauth2/token
   userAuthorizationUri: https://accounts.google.com/o/oauth2/auth
   clientAuthenticationScheme: form
   scope: profile email
   pre-established-redirect-uri: ${global.view.baseUrl}/epr/login/google
   use-current-uri: false
 resource:
   userInfoUri:  https://www.googleapis.com/oauth2/v3/userinfo

1. Melden Sie sich unter https://developer.linkedin.com/docs/oauth2 an und führen Sie nur den Schritt 1 aus. Nachdem Sie die Authentifizierungsschlüssel (Client-ID und Client Secret) erhalten haben, tragen Sie die Daten in den entsprechenden Abschnitt in der Konfigurationsdatei colab-prod.yml ein.

2. Wenn die Anwendung erstellt wurde, geben Sie Ihren Domainnamen unter Authorized redirect URLs zusammen mit dem Protokoll und dem Port und gefolgt von /epr/login/linkedin ein.

3. Passen Sie die Datei <enaio_installation>\service-manager\config\colab-prod.yml an:

linkedin:
 enable: true
 client:
   clientId: <client_id>
   clientSecret: <client_secret>
   accessTokenUri: https://www.linkedin.com/oauth/v2/accessToken
   userAuthorizationUri: https://www.linkedin.com/oauth/v2/authorization
   clientAuthenticationScheme: form
   scope: r_liteprofile,r_emailaddress
   pre-established-redirect-uri: ${global.view.baseUrl}/epr/login/linkedin
   use-current-uri: false
 resource:
   userInfoUri:  https://api.linkedin.com/v2/me

1. Melden Sie sich unter https://portal.azure.com an und suchen Sie über das Suchfeld nach App registration.

2. Klicken Sie auf 'New registration', füllen Sie alle Felder mit den entsprechenden Daten aus und klicken Sie auf 'Register'.

   Application- ID / Client-ID und Object-ID werden angezeigt.

3. Klicken Sie auf ‘Certificates & secrets’ und dann auf ‘New client secret’.
4. Kopieren Sie den Wert von 'Client secret'.

   Microsoft zeigt den Client Secret nur einmal an.

5. Gehen Sie zu 'Authentification', klicken Sie auf Add a platform und von der Konfigurations-Platform auf Web und gehen Sie zu 'RedirectURL' und geben Sie Ihren Domänennamen und Ihr Protokoll ein, gefolgt von /epr/login/microsoft.

   Beispiel: http://<gatewayIP>/colab/epr/login/microsoft

   Wenn der Prozess abgeschlossen ist, tragen Sie den Client Secret zusammen mit dem App Key in den entsprechenden Abschnitt in der Konfigurationsdatei colab-prod.yml ein.

6. Passen Sie die Datei <enaio_installation>\service-manager\config\colab-prod.yml an:

microsoft:
 enable: true
 client:
   clientId: <client_id>
   clientSecret: <client_secret>
   accessTokenUri: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
   userAuthorizationUri: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
   clientAuthenticationScheme: form
   scope: openid,profile,User.Read
   pre-established-redirect-uri: ${global.view.baseUrl}/epr/login/microsoft
   use-current-uri: false
 resource:
   userInfoUri:  https://graph.microsoft.com/v1.0/me