Como alterar senhas usadas por aplicativos externos

Aplicativos externos e autenticação usando a API do Serviço Web

Aplicativos externos podem ser integrados no VSA via API do Serviço Web. Esses aplicativos externos podem ser fornecidos por fornecedores de software independentes (ISVs, independent software vendors) como Autotask, ConnectWise ou Tigerpaw. Aplicativos externos também podem ser desenvolvidos por empresas de consultoria ou qualquer organização com conhecimento técnico especializado. Para usar a API do Serviço Web, os aplicativos externos devem ser programados para realizar a autenticação usando um nome de usuário e senha válidos do VSA.

Alterações de senha na versão 6.2 que afetam aplicativos externos

As versões 6.1 e anteriores do VSA usavam um algoritmo SHA-1 para senhas com hash. Portanto, aplicativos externos que eram compatíveis com a versão 6.1 usavam um método de autenticação com base em SHA-1. A partir da versão 6.1, um algoritmo SHA-256 é usado para aplicar hash em qualquer senha que seja criada na versão 6.2. As senhas criadas em versões anteriores do VSA permanecem em hash com SHA-1 até que a senha seja alterada ou o usuário seja renomeado, sendo que nesse ponto a senha terá o hash aplicado usando SHA-256. Aplicativos externos que eram usados com a versão 6.1 devem ser atualizados, através de uma alteração na programação, para ter compatibilidade com senhas SHA-256 na versão 6.2.

Como atualizar aplicativos externos e senhas

Se você usava a versão 6.1 ou uma versão anterior do VSA com um aplicativo externo, certifique-se da compatibilidade com a credencial sendo usada. A Kaseya recomenda a obtenção de uma versão atualizada do aplicativo externo que seja compatível com a versão 6.2 do VSA. Até que isso ocorra, o procedimento para a Criação de uma nova credencial SHA-1 para um aplicativo externo herdado, descrito a seguir, pode ser usado para manter a compatibilidade com aplicativos de terceiros.

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.

Se você tiver usado a versão 6.1 ou uma versão anterior do VSA com um aplicativo externo fornecido por um ISV ou terceiro:

1. Entre em contato com o ISV ou terceiro que desenvolveu o aplicativo externo.
2. Solicite uma versão atualizada do aplicativo externo.
3. Implemente a versão atualizada do aplicativo externo.
4. Nesse ponto, você pode alterar a senha ou renomear a conta usada pelo aplicativo externo.

Para ISVs ou terceiros responsáveis pelo desenvolvimento de aplicativos externos

1. Consulte a seção Algoritmo de hash do tópico Autenticar na ajuda on-line. Esta seção fornece instruções sobre como atualizar o aplicativo externo para ser compatível com a versão 6.2 do VSA, mantendo, ao mesmo tenpo, a compatibilidade com versões anteriores do VSA.
2. Implemente a alteração de programação necessária para o aplicativo externo.

Como criar uma nova credencial SHA-1 para um aplicativo externo herdado

Se você estiver executando o VSA 6.2 ou versão posterior e precisar criar um nome de usuário e senha SHA-1 que sejam compatíveis com um aplicativo externo herdado e ele ainda não tiver sido atualizado para ser compatível com senhas da versão 6.2, use um dos procedimentos a seguir. É possível criar um novo usuário mestre e senha ou redefinir apenas a senha de um usuário mestre existente.

Nota: É necessário ter privilégios de administrador no servidor da Kaseya. Por motivos de segurança, não é possível executar os procedimentos a seguir remotamente.

Criar uma nova conta de usuário mestre

1. Conecte-se à máquina executando o servidor da Kaseya.
2. Acesse a seguinte página da Web:
   http://localhost/localAuth/setAccountV61.asp
3. Insira um novo nome de conta no campo Nome do usuário mestre.
4. Insira uma senha no campo Inserir senha e confirme-a ao redigitá-la no campo Confirmar senha.
5. Insira um endereço de e-mail em Endereço de e-mail.
6. Clique em Criar.

O aplicativo externo agora pode ser atualizado para usar a nova conta de usuário e senha SHA-1 para conexão com o VSA.

Redefinir a senha de uma conta de usuário mestre existente

Nota: A conta de usuário mestre não pode ser desativada.

1. Conecte-se à máquina executando o servidor da Kaseya.
2. Acesse a seguinte página da Web:
   http://localhost/localAuth/setAccountV61.asp
3. Insira um novo nome de conta de usuário mestre no campo Nome do usuário mestre.
4. Insira uma senha no campo Inserir senha e confirme-a ao redigitá-la no campo Confirmar senha.
5. Deixe Endereço de e-mail em branco. Não é possível redefinir o endereço de e-mail de um usuário existente nesta página da web.
6. Clique em Criar.

O aplicativo externo agora pode ser atualizado para usar a nova senha SHA-1 para conexão com o VSA.