Verschlüsselte Anmeldeinformationen angeben

Verwenden Sie die Befehlszeilenschnittstelle, um die verschlüsselten Anmeldeinformationen in den Konfigurationsdateien festzulegen, z. B. den Parameter clientCredential und den Parameter password. Die Anmeldeinformationen dienen zur Authentifizierung von ARIS Connector for SAP Solutions bei Ihrem ARIS Enterprise-Mandanten und dem SAP-System.

Warnung

Nehmen Sie keine manuellen Änderungen in den Dateien UpdateARISConfiguration.json, ARISConfiguration.json, UpdateSAPConfiguration.json oder SAPConfiguration.json vor.

Voraussetzung

ARIS Connector for SAP Solutions wird ausgeführt.

Vorgehen

  1. Öffnen Sie im Ordner <ARIS Connector for SAP Solutions-Installationsverzeichnis>\bin eine Eingabeaufforderung oder einen Linux-Terminal.

  2. Zum Verschlüsseln und Übermitteln des fehlenden Werts clientCredentials in der Datei UpdateARISConfiguration.json geben Sie Folgendes ein:

    ConfigureConnector.bat/.sh -crd <aus ARIS Architect kopierter Client-Anmeldeinformationsschlüssel>>

    Beispiel für Linux: ./ConfigureConnector.sh -crd 378ae18d-8d4d-499b-8579-1bd4601d30f0/15502484-88ab-4cb2-920f-153d21ab5915

    Sollten Probleme auftreten, werden in der Befehlszeilenschnittstelle Fehlermeldungen angezeigt. Über die Links gelangen Sie zur Problemlösung.

    Sollten Probleme auftreten, werden in der Befehlszeilenschnittstelle Fehlermeldungen angezeigt. Die Meldungen werden in der Datei ConnectorCLI.log protokolliert.

    Über die Links gelangen Sie zur Problemlösung.

    SAP_CONFIGURATION_DIFFERENT_USERS

    Sie haben versucht, das SAP-Kennwort zu verschlüsseln und in die Datei UpdateSAPConfiguration.json einzugeben, aber der im Befehl angegebene Benutzer ist nicht in der Datei angegeben. Stellen Sie sicher, dass Sie den Wert des entsprechenden user-Parameters verwenden, der in der Datei UpdateSAPConfiguration.json zur Verschlüsselung angegeben ist.

    CONFIG_FILE_MISSING_P_CFG_NAME

    Die erforderliche Konfigurationsdatei ist im Ordner <ARIS Connector for SAP Solutions-Installationsverzeichnis>/conf nicht vorhanden.

    CONFIG_FILE_INVALID_P_CFG_NAME

    Eine Dateioperation in Bezug auf die entsprechende Konfiguration ist fehlgeschlagen. Der Ausnahmefehler wurde in die Protokolldatei geschrieben.

    CONFIG_VALUE_OUT_OF_BOUNDS_P_CFG_NAME_P_NAME_P_VALUE_P_MIN_P_MAX

    Sie haben einen Konfigurationsparameter mit einem falschen minimalen oder maximalen Wert angegeben. Sie finden den gültigen Wertebereich in der Fehlermeldung. Weitere Informationen zur Verwendung aller Parameter erhalten Sie in der entsprechenden *.md-Datei.

    CONFIG_VALUE_NOT_SET_P_CFG_NAME_P_NAME

    Ein erforderlicher Konfigurationsparameter wurde nicht angegeben. Sie finden den gültigen Konfigurationsparameter in der Fehlermeldung.

    SAP_CONFIG_ALIAS_NOT_UNIQUE_P_CFG_NAME_P_ALIAS

    Sie haben mehrere SAP-Systeme mit identischen alias-Werten konfiguriert. Sie müssen für jedes SAP-System einen eindeutigen alias-Wert festlegen.

    CONFIG_FILE_COULD_NOT_PERSIST

    Ein Dateispeichervorgang in Bezug auf die entsprechende Konfigurationsdatei ist fehlgeschlagen. Der Ausnahmefehler wurde in die Protokolldatei geschrieben.

    SAP_CONFIG_CONNECTION_PARAMETERS_NOT_CORRECT

    Sie müssen eine gültige SAP-Server-URL als Wert für den Parameter serverUrl und einen Großbuchstaben für den Parameter language angeben. Die Werte werden für die Verbindung zum SAP-System verwendet, das als alias angegeben ist, der ARIS Connector for SAP Solutions verwendet. Weitere Informationen zur Verwendung aller Parameter erhalten Sie in der entsprechenden *.md-Datei.

    SAP_CONFIG_AUTHENTICATION_PARAMETERS_NOT_CORRECT

    Sie haben ungültige SAP-Verbindungsparameter angegeben.

    SAP_CONFIG_LANGUAGE_PARAMETER_NOT_CORRECT

    Sie haben den Wert des Sprachparameters falsch angegeben. Verwenden Sie einen Großbuchstaben. Weitere Informationen zur Verwendung aller Parameter erhalten Sie in der entsprechenden *.md-Datei.

    ARIS_CONFIG_URL_NOT_VALID

    Sie haben den Wert für den Parameter arisCloudUrl falsch angegeben. Die URL hat eine falsche Syntax. Weitere Informationen zur Verwendung aller Parameter erhalten Sie in der Datei UpdateARISConfiguration.md.

    ARIS_CONFIG_CLIENT_CREDENTIALS_NOT_VALID

    Der Wert des Parameters clientCredentials ist ungültig. Kopieren Sie die Anmeldeinformationen des entsprechenden ARIS Connector for SAP Solutions aus ARIS Architect. Die Syntax des Wertes muss so lauten: <Client-ID>/<Geheimer Client-Schlüssel>. Der Wert besteht aus Client-ID und Geheimer Client-Schlüssel, die durch einen Schrägstrich (/) getrennt sind.

    ENCRYPTION_GENERAL

    Das gespeicherte verschlüsselte Kennwort kann mit der Datei key.secret, die im Ordner <ARIS Connector for SAP Solutions-Installationsverzeichnis>/conf abgelegt ist, nicht mehr entschlüsselt werden. Der geheime Client-Schlüssel wurde wahrscheinlich geändert. Dies kann passieren, wenn Sie die Datei key.secret löschen und ARIS Connector for SAP Solutions neu starten. In einem solchen Fall wird eine neue key.secret-Datei mit einem neuen Schlüssel angelegt. Es müssen alle Anmeldedaten erneut verschlüsselt werden. Verwenden Sie dazu die folgenden Befehle: ConfigureConnector.bat -crd <Aus ARIS Architect kopierte Anmeldeinformationen>, ConfigureConnector.bat -sys <Alias> -usr <Benutzer> -pwd <Kennwort> <wiederholtes Kennwort>, ConfigureConnector.bat -upd.

    SAP_INSTALLATION_CHECK_ERROR

    Die Verbindung zum SAP-System ist wegen eines Problems fehlgeschlagen, das nicht mit der Authentifizierung zusammenhängt.

    ARIS_AUTHORIZATION_ERROR and ARIS_AUTHENTICATION_FAILED_ERROR

    Die Verbindung zu ARIS ist fehlgeschlagen. Mögliche Ursachen sind eine falsche arisCloudUrl, falsche clientCredentials, ein falsches Zertifikat (cacerts, abgelegt im Ordner <ARIS Connector for SAP Solutions-Installation>/jre/lib/security) oder Netzwerkprobleme.

    Die Protokolldateien befinden sich im Ordner <ARIS Connector for SAP Solutions-Installationsverzeichnis>\logs.

    • Connector.log enthält Informationen, die während des Starts von ARIS Connector for SAP Solutions protokolliert werden, und über das verbundene SAP-System.

    • ConnectorCLI.log enthält Meldungen, die von der Befehlszeilenschnittstelle protokolliert werden.

    • ConnectorCommunication.log enthält Meldungen, die sich auf die Kommunikation zwischen ARIS Connector for SAP Solutions und ARIS beziehen.

    • SCCService.log enthält Meldungen, die vom Startprozess protokolliert werden.

    Wenn Sie Anmeldedaten verschlüsseln, wird von ARIS Connector for SAP Solutions eine Datei key.secret im Ordner <ARIS Connector for SAP Solutions-Installationsverzeichnis>\conf erstellt. Die Datei key.secret wird ab jetzt für die Verschlüsselung verwendet.

    Legen Sie unbedingt eine Sicherung dieser Datei an. Der darin enthaltene Schlüssel darf nicht geändert werden. Es ist wichtig, dass Sie die Datei key.secret aus dem Ordner conf wiederherstellen können, falls Sie die Datei löschen sollten, und somit der Verschlüsselungsschlüssel und die verschlüsselten Anmeldedaten nicht gespeichert sind. Diese Datei ist für den Neustart von ARIS Connector for SAP Solutions zwingend erforderlich. Sollten Sie die zur Verschlüsselung verwendete Datei key.secret nicht wiederherstellen können, müssen Sie die Anmeldeinformationen neu verschlüsseln und übermitteln. Ansonsten können keine Verbindungen hergestellt werden.

  3. Zum Verschlüsseln und Eingeben des fehlenden SAP-Kennworts in der Datei UpdateSAPConfiguration.json geben Sie in das Fenster der Eingabeaufforderung oder den Linux-Terminal Folgendes ein:

    ConfigureConnector.bat/.sh -sys <Wert des Parameters alias> -usr <Wert des Parameters user> -pwd <Kennwort> <Kennwort bestätigen>

    Beispiel für Windows: .\ConfigureConnector.bat -sys SM01 -usr ARIS_SAP_SYNC_USER -pwd ******** ********

    Das Kennwort ist während der Eingabe sichtbar.

Sie haben den verschlüsselten in der Datei UpdateARISConfiguration.json verwendeten clientCredentials-Parameter und den in der Datei UpdateSAPConfiguration.json verwendeten password-Parameter festgelegt.

Führen Sie zum Aktualisieren der von ARIS Connector for SAP Solutions verwendeten Konfigurationsdateien die entsprechenden Befehle aus.