Actualiza información del usuario.
Se devuelve un registro simple de los siguientes campos.
Method |
string |
La operación que solicitó esta respuesta. |
TransactionID |
decimal |
La ID única de mensaje para este mensaje. |
ErrorMessage |
string |
Si está en blanco, no devolvió error. |
ErrorLocation |
string |
Si está en blanco, no devolvió error. |
Algoritmo hash
Con la versión 6.2, K2 adoptó el algoritmo hash SHA-256 para autenticaciones seguras. Anteriormente, el estándar era el SHA-1. Consulte el tema Cambio de contraseñas que usan las aplicaciones externas de la ayuda del sistema en línea para acceder a una introducción general sobre esta mejora.
HashingAlgorithm
en Autenticar tiene como valor predeterminado SHA-1
.Advertencia: Al cambiar una contraseña que utiliza una aplicación externa heredada, se deshabilita la integración hasta que la aplicación externa se actualice para usar el algoritmo hash SHA-256 o hasta que se cree una credencial SHA-1 nueva y se implemente. Asegúrese de no cambiar las contraseñas que usan las aplicaciones externas antes de que se implemente la actualización. Consulte Creación de una credencial SHA-1 nueva para una aplicación externa heredada a continuación.
Prácticas recomendadas
Para asegurar una migración sin problemas de versiones anteriores a esta versión, Kaseya recomienda que el código de cliente de servicios web API se escriba o modifique para intentar una autenticación primero en SHA-256 y después en SHA-1, en orden sucesivo. Esto asegura que el código de cliente sea compatible con contraseñas creadas en la versión actual y en versiones anteriores del VSA.
HashingAlgorithm
en la solicitud Autenticar en SHA-256
. Asegúrese de que se aplique el algoritmo hash SHA-256 a la contraseña. Emita la solicitud Autenticar. Compruebe si se devuelve un ID de sesión válido.SessionID
devuelve un valor distinto de cero y el parámetro ErrorMessage
está en blanco.SessionID
devuelve un valor igual a cero. Realice el paso 2.HashingAlgorithm
en SHA-1
. Vuelva a aplicar un algoritmo hash (SHA-1) al valor de la contraseña. Emita nuevamente la solicitud Autenticar. Compruebe si se devuelve un ID de sesión válido.