Requisitos de entrada na conta da Microsoft (HTML)
[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]
Seus aplicativos do Tempo de Execução do Windows podem permitir a entrada e saída de usuários com suas contas da Microsoft. Desse modo, os aplicativos podem acessar dados deles nos serviços em nuvem da Microsoft, como o Outlook.com e o Microsoft OneDrive.
Aplique estas diretrizes quando desenvolver a experiência de entrada e saída de seu aplicativo para que forneça ao usuário uma experiência uniforme com outros aplicativos do Tempo de Execução do Windows. Estas diretrizes também ajudam seu aplicativo a manter os dados dos usuários seguros.
Importante O tutorial deste tópico demonstra um aplicativo da Windows Store. Você também pode adicionar serviços da Microsoft a um aplicativo da Loja do Windows Phone. No entanto, uma vez que a interface do usuário do Windows Phone não dá suporte a submenus, você precisa usar as páginas em um aplicativo da Loja do Windows Phone para implementar os recursos para os quais submenus são usados neste tópico.
Visão geral
Para ter acesso aos dados dos usuários em serviços em nuvem da Microsoft, como o Outlook.com e o OneDrive, os usuários devem entrar em suas contas da Microsoft e permitir que o aplicativo acesse os dados de que precisa. Para ajudar os usuários a manter seus dados protegidos de outros usuários do computador, seu aplicativo da Windows Store também deve possibilitar a saída do aplicativo. Este tópico descreve como fazer isso.
Importante Se seu aplicativo não permite que os usuários saiam, ele pode acessar os dados do usuário sempre que o aplicativo é executado na conta do computador conectada em primeiro lugar. Embora isso seja muito conveniente para os usuários que nunca compartilham ou perdem o computador, apresenta uma possível vulnerabilidade de segurança em caso de uso do computador por outra pessoa ou roubo. Por esses motivos, seu aplicativo da Windows Store sempre deve indicar quando entrou na conta de um usuário e fornecer a opção de saída.
Observação Caso a conta do computador do usuário seja associada a uma conta da Microsoft, o usuário não poderá sair da conta da Microsoft usando o aplicativo. Isso deve ocorrer somente em computadores pessoais, não nos compartilhados.
Estas etapas descrevem, de modo geral, como seu aplicativo pode acessar as informações do perfil do usuário. Para ver instruções detalhadas, confira Como usar serviços Microsoft em seu aplicativo.
Inicializar a API JavaScript chamando WL.init()
O aplicativo deve chamar WL.init() uma vez em cada página que usa funções do Live SDK.
Você pode simplificar essa ação em seu aplicativo mantendo as funções que chamam o Live SDK em um único arquivo.
Adicionar comandos de configurações ao aplicativo
Adicione estas duas entradas ao painel Configurações do aplicativo.
Conta
O comando Conta no painel Configurações mostra o submenu por meio do qual os usuários podem entrar e sair de suas contas da Microsoft.
Política de privacidade
O comando Privacy no painel Configurações mostra o submenu que contém a política de privacidade do aplicativo.
Esta imagem mostra um painel de configurações com esses comandos adicionados de forma explícita. Se o seu aplicativo tiver ouras configurações, convém adicionar a funcionalidade de entrada e saída ou a política de privacidade em um submenus Configurações, com outras entradas relacionadas. O importante é que essas configurações estejam disponíveis e possam ser detectadas no aplicativo.
.png "Captura de tela da guia de configurações criada pelo exemplo de código")
Fornecer uma política de privacidade
Para saber mais, consulte as Políticas da Windows Store e da Loja do Windows Phone.
Realizar a entrada do usuário
Seu aplicativo pode fazer isso automaticamente ao iniciar ou permitir que o usuário entre somente quando precisar de acesso aos dados armazenados nos serviços em nuvem da Microsoft, como o Outlook.com e o OneDrive.
Importante Para fornecer a experiência mais segura e consistente, use penas o controle de entrada do Windows 8, mostrado aqui, para conectar um usuário.
.png "Captura de tela da interface do usuário de entrada na conta da Microsoft")
Caso o usuário ainda não tenha dado permissão ao aplicativo para que possa acessar as informações do perfil, ele verá esta tela.
.png "Captura de tela da interface do usuário de consentimento.")
Realizar a saída do usuário
Pense em como seu aplicativo será usado. Se ele acessar dados que o usuário possa considerar confidenciais, seu aplicativo deverá realizar a saída automática do usuário para evitar acesso não autorizado. Mas se o aplicativo é usado em um ambiente mais seguro, você pode deixar que o usuário opte por sair manualmente usando o comando das configurações de Conta.
Caso a conta do computador do usuário seja associada a uma conta da Microsoft, o usuário não poderá sair da conta da Microsoft usando o aplicativo. Isso deve ocorrer somente em computadores pessoais, não nos compartilhados.
Importante
Os usuários devem sempre saber quando o aplicativo está conectado à conta da Microsoft e quando não está.
Mostrar o estado de entrada na interface do usuário do aplicativo
Adicione algum tipo de indicação à interface do usuário do aplicativo para mostrar aos usuários quando estão conectados e quando o aplicativo pode acessar informações deles.
Observação É importante que o aplicativo informe aos usuários quando estão conectados. Para isso, é possível simplesmente exibir o nome ou listar elementos extraídos de dados armazenados no serviço em nuvem da Microsoft. Por exemplo, se seu aplicativo exibe fotos dos usuários do OneDrive, ele poderá mostrar uma lista de fotos quando o usuário estiver conectado, ou uma mensagem de que ele precisará entrar quando não estiver conectado. OneDrive