UpdateUser

Atualiza as informações do usuário.

Um registro único dos seguintes campos é retornado.

Method	string	A operação que solicitou essa resposta.
TransactionID	decimal	A ID única de mensagem para essa mensagem.
ErrorMessage	string	Se estiver em branco, nenhum erro foi retornado.
ErrorLocation	string	Se estiver em branco, nenhum erro foi retornado.

Algoritmo de hash

Com a versão 6.2, o K2 adotou o algoritmo de hash SHA-256 para autenticações seguras. Anteriormente, o padrão era SHA-1. Consulte o tópico Como alterar senhas usadas por aplicativos externos da ajuda on-line do Sistema para obter uma descrição geral desse aperfeiçoamento.

O hash é aplicado a uma senha recém-criada ou redefinida usando SHA-256.
Senhas herdadas que não tiverem sido redefinidas continuarão exigindo SHA-1.
O parâmetro HashingAlgorithm em Autenticar terá como padrão SHA-1, se deixado em branco.
O aplicativo C# da API de amostra e a página ASP da API de amostra fornecem uma opção para alternar o algoritmo de hash entre SHA1 e SHA-256.
Senhas VSA podem ser redefinidas somente usando o aplicativo VSA, não pela API.
Aviso: Alterar uma senha usada por um aplicativo externo herdado desativará a integração até que o aplicativo externo seja atualizado para usar o algoritmo de hash SHA-256 necessário, ou até que uma nova credencial SHA-1 seja criada e implementada. Certifique-se de que senhas usadas por aplicativos externos não sejam alteradas até que a atualização seja implementada. Consulte Como criar uma nova credencial SHA-1 para um aplicativo externo herdado a seguir.

Práticas recomendadas

Para garantir uma migração tranquila de versões anteriores a esta versão, a Kaseya recomenda que o código cliente da API de serviços da Web seja escrito ou modificado para tentar a autenticação usando primeiro SHA-256 e então SHA-1, sucessivamente. Isso garantirá que o código cliente seja compatível com senhas criadas em versões atuais e anteriores do VSA.

Defina o parâmetro HashingAlgorithm na solicitação Autenticar como SHA-256. Certifique-se de que o hash é aplicado à senha usando SHA-256. Emita a solicitação Autenticar. Verifique para confirmar se uma ID de sessão válida foi retornada.
- A autenticação terá êxito se o parâmetro SessionID retornar um valor que não seja zero e o parâmetro ErrorMessage estiver em branco.
- A autenticação não terá êxito se o parâmetro SessionID retornar um valor zero. Realize a etapa 2.
Defina o parâmetro HashingAlgorithm como SHA-1. Aplique novamente o hash ao valor de senha usando SHA-1. Emita de novo a solicitação Autenticar. Verifique para confirmar se uma ID de sessão válida foi retornada.