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\enaio-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-app\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 die Zeile 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:

spring:
  security:
    oauth2:
      client:
        registration:
          google:
            clientId: client_id
            clientSecret: client_secret
            redirect-uri: ${global.service.baseUrl}/epr/login/google
            scope: openid, email, profile

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:

spring:
  security:
    oauth2:
      client:
        registration:
          linkedin:
            clientId: client_id
            clientSecret: client_secret
            redirect-uri: ${global.service.baseUrl}/epr/login/linkedin
            scope: r_emailaddress, r_liteprofile
            client-authentication-method: post
            authorization-grant-type: authorization_code
        provider:
          linkedin:
            authorization-uri: https://www.linkedin.com/oauth/v2/authorization
            token-uri: https://www.linkedin.com/oauth/v2/accessToken
            user-info-uri: https://api.linkedin.com/v2/me
            user-name-attribute: id

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:

spring:
  security:
    oauth2:
      client:
        registration:
          microsoft:
            client-id: client_id
            client-secret: client_secret
            provider: microsoft
            redirect-uri: ${global.service.baseUrl}/epr/login/microsoft
            scope: openid, profile, email, https://graph.microsoft.com/.default
            client-authentication-method: basic
            authorization-grant-type: authorization_code
        provider:
          microsoft:
            authorization-uri: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
            token-uri: https://login.microsoftonline.com/common/oauth2/v2.0/token
            user-info-uri: https://graph.microsoft.com/v1.0/me
            jwk-set-uri: https://login.microsoftonline.com/common/discovery/v2.0/keys
            user-name-attribute: id