UpdateUser

Aktualisiert Benutzerdaten.

Es wird ein einzelner Datensatz der folgenden Felder zurückgegeben.

Hash-Algorithmus

Ab Version 6.2 implementiert K2 für sichere Authentifizierungen den Hash-Algorithmus SHA-256. Der bisherige Standard war SHA-1. Eine allgemeine Beschreibung dieser Verbesserung finden Sie im Thema Passwörter externer Anwendungen ändern der Online-Hilfe zum System.

• Neu erstellte oder zurückgesetzte Passwörter werden mit SHA-256 gehasht.
• Für nicht zurückgesetzte Legacy-Passwörter ist SHA-1 weiterhin erforderlich.
• Der Parameter HashingAlgorithm in Authenticate wird standardmäßig auf SHA-1 gesetzt, wenn er nicht eigens angegeben wird.
• Die API-Beispielanwendung für C# und die API-Beispielseite für ASP bieten eine Option zum Wechseln zwischen SHA1 und SHA-256.
• VSA-Passwörter können nur in der VSA-Anwendung zurückgesetzt werden, nicht über die API.

  Warnung: Jegliche Änderung des Passworts einer externen Legacy-Anwendung führt zu einer Unterbrechung der Integration, bis entweder die externe Anwendung zur Nutzung des erforderlichen SHA-256-Hash-Algorithmus aktualisiert wurde oder neue SHA-1-Anmeldedaten erstellt und angewendet wurden. Stellen Sie also sicher, dass keine Passwörter externer Anwendungen geändert werden, bevor die Aktualisierung vorgenommen wurde. Siehe Neue SHA-1-Anmeldedaten für externe Legacy-Anwendungen erstellen unten.

Best Practices

Für eine nahtlose Migration zwischen früheren Versionen und der aktuellen Version empfiehlt Kaseya, den Clientcode der API-Webdienste so zu programmieren bzw. umzuprogrammieren, damit zunächst die Authentifizierung mit SHA-256 versucht und erst anschließend SHA-1 verwendet wird. Dadurch stellen Sie sicher, dass der Clientcode mit Passwörtern aus früheren Versionen und der aktuellen Version von VSA kompatibel ist.

1. Setzen Sie den Parameter HashingAlgorithm in der Anfrage Authenticate auf SHA-256. Vergewissern Sie sich, dass das Passwort mit SHA-256 gehasht wird. Geben Sie die Anfrage Authenticate aus. Prüfen Sie, dass eine gültige Sitzungs-ID zurückgegeben wird.
   • Die Authentifizierung war erfolgreich, wenn der Parameter SessionID einen anderen Wert als Null zurückgibt und der Parameter ErrorMessage leer ist.
   • Die Authentifizierung war nicht erfolgreich, wenn der Parameter SessionID den Wert Null zurückgibt. Führen Sie Schritt 2 aus.
2. Setzen Sie den Parameter HashingAlgorithm auf SHA-1. Hashen Sie das Passwort erneut, diesmal mit SHA-1. Geben Sie die Anfrage Authenticate erneut aus. Prüfen Sie, dass eine gültige Sitzungs-ID zurückgegeben wird.