Senhas

Este guia descreve como salvar, atualizar e gerir as senhas que o usuário introduz num novo formulário online.

Visão geral

O Chromium tem uma funcionalidade incorporada que permite recordar as credenciais introduzidas quando o usuário submete um novo formulário com nome de usuário e senha. A biblioteca perguntar-lhe-á se pretende salvar as credenciais.

Se os salvar, da próxima vez que carregar o formulário, a biblioteca irá sugerir o preenchimento automático.

Salvando senhas

Quando o usuário submete um novo formulário que contém um nome de usuário e uma senha o SavePasswordHandler será chamado. No handler, você pode decidir se quer salvar as credenciais para este site Web, devolvendo a opção “Salvar” ou “Nunca”. Por exemplo:

Browser.Passwords.SavePasswordHandler = 
    new Handler<SavePasswordParameters, SavePasswordResponse>(p =>
    {
        return SavePasswordResponse.Save;
    });

Browser.Passwords.SavePasswordHandler = 
    New Handler(Of SavePasswordParameters, SavePasswordResponse)(Function(p)
        Return SavePasswordResponse.Save
    End Function)

Se você optar por salvar a senha, esta será adicionada ao armazenamento de senhas. Se selecionar a opção “Nunca”, a biblioteca deixará de sugerir que salve as senhas desta página Web.

Atualizando senhas

Quando o usuário submete o formulário previamente submetido com o mesmo nome de usuário e uma nova senha, o UpdatePasswordHandler será chamado. Neste handler, você pode decidir se quer atualizar as credenciais existentes ou ignorar o novo valor. Por exemplo:

Browser.Passwords.UpdatePasswordHandler = 
    new Handler<UpdatePasswordParameters, UpdatePasswordResponse>(p =>
    {
        return UpdatePasswordResponse.Update;
    });

Browser.Passwords.UpdatePasswordHandler = 
    New Handler(Of UpdatePasswordParameters, UpdatePasswordResponse)(Function(p)
        Return UpdatePasswordResponse.Update
    End Function)

Gerindo as senhas

Cada elemento no armazenamento de senhas é representado por uma instância PasswordRecord. Ela contém o login do usuário e o URL de uma página web onde o formulário foi submetido. Ela não contém a senha propriamente dita.

Para ler todos os registros salvos e colocados na lista de bloqueio, utilize:

IReadOnlyList<PasswordRecord> allPasswords = 
    Engine.Profiles.Default.PasswordStore.All;

Dim allPasswords As IReadOnlyList(Of PasswordRecord) = 
    Engine.Profiles.Default.PasswordStore.All

Para ler apenas os registros salvos, utilize:

IReadOnlyList<PasswordRecord> savedPasswords = 
    Engine.Profiles.Default.PasswordStore.AllSaved;

Dim savedPasswords As IReadOnlyList(Of PasswordRecord) = 
    Engine.Profiles.Default.PasswordStore.AllSaved

Para ler apenas os registros com os sites Web para os quais as senhas nunca serão salvas, utilize:

IReadOnlyList<PasswordRecord> neverSavedPasswords = 
    Engine.Profiles.Default.PasswordStore.AllNeverSaved;

Dim neverSavedPasswords As IReadOnlyList(Of PasswordRecord) = 
    Engine.Profiles.Default.PasswordStore.AllNeverSaveded

Para remover todos os registros armazenados, utilize:

PasswordStore.Clear();

PasswordStore.Clear()

Para remover os registros associados a um URL específico, utilize:

PasswordStore.RemoveByUrl(url);

PasswordStore.RemoveByUrl(url)