Visão geral do Portal de Dispositivos Windows

O Portal de Dispositivos Windows (WDP) é um servidor web incluído em dispositivos Windows que permite configurar e gerir as definições do dispositivo através de uma ligação de rede ou USB (as ligações locais também são suportadas em dispositivos com navegador web).

O WDP também fornece ferramentas avançadas de diagnóstico para resolução de problemas e visualização do desempenho em tempo real do seu dispositivo Windows.

A funcionalidade do WDP é exposta programaticamente através de um conjunto de APIs REST.

Este artigo fornece uma descrição geral do Portal de Dispositivos Windows e inclui ligações para artigos com informações mais específicas sobre cada família de dispositivos Windows.

Note

Uma família de dispositivos identifica as APIs, características do sistema e comportamentos que pode esperar numa classe de dispositivos.

Warning

O Portal do Dispositivo está desativado por defeito. Deve ativar o Modo Desenvolvedor e depois ativar explicitamente o Portal de Dispositivos nas Definições > Sistema > Avançado antes de usar.

Setup

Cada família de dispositivos fornece uma versão do WDP, mas as funcionalidades e a configuração variam consoante os requisitos do dispositivo.

Estes são os passos básicos para todos os dispositivos.

  1. Ativar o Modo Desenvolvedor. Consulte Definições para programadores para instruções.

    Captura de ecrã da janela Definições > Sistema > Avançadas a mostrar o Modo de Programador ativado.

  2. Ativa o Portal de Dispositivos no teu dispositivo (Definições > System > Advanced).

    Captura de ecrã da janela Definições > System > Advanced que mostra as definições do Portal de Dispositivos disponíveis após a ativação.

  3. Ligue o seu dispositivo e PC através de uma rede local ou por USB.

  4. Navegue até à página do Portal do Dispositivo no seu navegador. Esta tabela mostra as portas e protocolos usados por cada família de dispositivos.

A tabela seguinte inclui detalhes específicos do dispositivo para o WDP.

Família de dispositivos Ativado por predefinição? HTTP HTTPS USB Instruções
Empresa de Desktop e IoT Ativar dentro do Modo Dev 50080* 50043* N/A Portal de Dispositivos para Desktop ou dispositivos IoT Enterprise

* Isto nem sempre acontece, pois o Portal de Dispositivos no desktop declara portas na faixa efémera (>50.000) para evitar colisões com reivindicações de porta existentes no dispositivo. Para saber mais, consulte a secção de configuração baseada em Registo no Portal de Dispositivos Windows para Ambiente de Trabalho.

Features

Barra de ferramentas e navegação

A barra de ferramentas no topo da página dá acesso a funcionalidades mais usadas.

  • Energia: Aceder a opções de energia.
    • Desligamento: Desliga o dispositivo.
    • Reiniciar: Desliga e volta a ligar o dispositivo.
  • Ajuda: Abre a página de ajuda.

Use os links no painel de navegação ao lado esquerdo da página para navegar até às ferramentas de gestão e monitorização disponíveis para o seu dispositivo.

Ferramentas comuns entre famílias de dispositivos são descritos aqui. Podem existir outras opções dependendo do dispositivo. Para mais informações, consulte a página específica para o seu tipo de dispositivo.

Gestor de aplicações

O gestor de aplicações fornece funcionalidades de instalação, desinstalação e gestão de pacotes e conjuntos de aplicações no dispositivo host.

Página do gestor de aplicações do Portal do Dispositivo

  • Implementar aplicações: Distribuir aplicações empacotadas a partir de alojamentos locais, de rede ou web e registar ficheiros soltos a partir de partilhas de rede.
  • Aplicações instaladas: Use o menu suspenso para remover ou iniciar aplicações instaladas no dispositivo.
  • Aplicações de execução: Obtenha informações sobre as aplicações que estão atualmente a correr e feche-as conforme necessário.

Instalar (manualmente) uma aplicação

Pode instalar aplicações manualmente durante o desenvolvimento usando o Windows Device Portal:

  1. Quando criar um pacote de aplicações, pode instalá-lo remotamente no seu dispositivo. Depois de o compilar no Visual Studio, é gerada uma pasta de saída.

    Instalação de aplicações

  2. No Portal de Dispositivos Windows, navegue até à página do gestor de Apps.

  3. Na secção Implementar aplicações , selecione Armazenamento Local.

  4. Em Selecionar o pacote da aplicação, selecione Selecionar Ficheiro e navegue até ao pacote da aplicação que pretende instalar manualmente.

  5. Em Selecionar ficheiro de certificado (.cer) utilizado para assinar o pacote da aplicação, selecione Escolher ficheiro e procure o certificado associado a esse pacote da aplicação.

  6. Assinala as respetivas caixas se quiseres instalar pacotes opcionais ou framework juntamente com a instalação da aplicação, e seleciona Próximo para os escolher.

  7. Selecione Instalar para iniciar a instalação.

  8. Se o dispositivo estiver a correr Windows 10 em modo S, e for a primeira vez que o certificado fornecido é instalado no dispositivo, reinicie-o.

Instalar um certificado

Alternativamente, pode instalar o certificado através do Portal de Dispositivos Windows e instalar a aplicação por outros meios:

  1. No Portal de Dispositivos Windows, navegue até à página do gestor de Apps.

  2. Na secção Implementar aplicações , selecione Certificado de Instalação.

  3. Em Selecionar o ficheiro de certificado (.cer) utilizado para assinar um pacote de aplicação, selecione Escolher ficheiro e procure o certificado associado ao pacote de aplicação que pretende instalar manualmente.

  4. Selecione Instalar para iniciar a instalação.

  5. Se o dispositivo estiver a correr Windows 10 em modo S, e for a primeira vez que o certificado fornecido é instalado no dispositivo, reinicie-o.

Desinstalar uma aplicação

  1. Certifique-se de que a sua aplicação não está a correr.
  2. Se estiver, vai a Aplicações em execução e fecha-a. Se tentar desinstalar enquanto a aplicação está a correr, vai causar problemas ao tentar reinstalar a aplicação.
  3. Selecione a aplicação no menu suspenso e clique em Remover.

Processos em execução

Esta página mostra detalhes sobre processos atualmente a correr no dispositivo anfitrião. Isto inclui tanto as aplicações como os processos do sistema. Pode terminar tanto processos da aplicação como do sistema a partir desta página.

Explorador de ficheiros

Esta página permite-lhe visualizar e manipular ficheiros armazenados por quaisquer aplicações instaladas fora da loja oficial. Consulte o armazenamento local da aplicação através da página do explorador de ficheiros para visualizar e gerir os dados da sua aplicação.

Performance

A página de Desempenho mostra gráficos em tempo real com informações de diagnóstico do sistema, como consumo de energia, taxa de fotogramas e carga do CPU.

Estas são as métricas disponíveis:

  • CPU: Percentagem da utilização total disponível da CPU
  • Memória: Total, em uso, disponível, confirmada, paginada e não paginada
  • I/O: Leitura e escrita de quantidades de dados
  • Rede: Dados recebidos e enviados
  • GPU: Percentagem da utilização total disponível do motor GPU

Registo de Rastreamento de Eventos para Windows (ETW)

A página de registo do ETW gere a informação de Event Tracing for Windows (ETW) em tempo real no dispositivo.

Verifique Ocultar fornecedores para mostrar apenas a lista de Eventos.

  • Fornecedores registados: Selecione o fornecedor do evento e o nível de rastreio. O nível de rastreamento é um destes valores:

    1. Saída ou encerramento anormal
    2. Erros graves
    3. Warnings
    4. Avisos sem erro
    5. Rastreio detalhado

    Clique ou toque em Ativar para começar a traçar. O provedor é adicionado à lista pendente Provedores Ativados.

  • Fornecedores personalizados: Selecione um fornecedor ETW personalizado e o nível de rastreamento. Identifique o fornecedor pelo seu GUID. Não inclua parênteses no GUID.

  • Fornecedores habilitados: Listam os fornecedores habilitados. Selecione um fornecedor no menu suspenso e clique ou toque em Desativar para parar o rastreio. Clique ou toque em Stop all para suspender todo o rastreamento.

  • Histórico dos fornecedores: Isto mostra os fornecedores ETW que foram ativados durante a sessão atual. Clique ou toque em Ativar para ativar um fornecedor que estava desativado. Clique ou toque em Limpar para limpar o histórico.

  • Filtros / Eventos: A secção Eventos lista eventos ETW dos fornecedores selecionados em formato de tabela. A tabela é atualizada em tempo real. Use o menu Filtros para configurar filtros personalizados para os eventos que serão exibidos. Clique no botão Limpar para apagar todos os eventos ETW da tabela. Isto não desativa nenhum fornecedor. Pode clicar em Guardar para o ficheiro para exportar os eventos ETW atualmente recolhidos para um ficheiro CSV local.

Rastreamento de desempenho

O Windows Performance Toolkit inclui a página de rastreamento de desempenho, que permite visualizar traços do Windows Performance Recorder (WPR) a partir do dispositivo anfitrião.

  • Perfis disponíveis: Selecione o perfil WPR na lista pendente e clique ou toque em Iniciar para iniciar o rastreio.
  • Perfis personalizados: Clique ou toque em Navegar para escolher um perfil WPR no seu PC. Clique ou toque em Carregar e comece a traçar.

Para parar o rastreio, clique em Parar. Permaneça nesta página até que o ficheiro de rastreio (.ETL) termine de ser transferido.

Os ficheiros .ETL capturados podem ser abertos para análise no Windows Analisador de Desempenho.

Gestor de dispositivos

A página do gestor de dispositivos enumera todos os periféricos ligados ao seu dispositivo. Pode clicar nos ícones de definições para ver as propriedades de cada um.

Rede

A página de Rede gere as ligações de rede no dispositivo. A menos que estejas ligado ao Portal do Dispositivo via USB, mudar estas definições provavelmente vai desligar-te do Portal do Dispositivo.

  • Redes disponíveis: Mostra as redes WiFi disponíveis para o dispositivo. Clicar ou tocar numa rede permite-te ligar-te a ela e fornecer uma chave de acesso se necessário. O Portal de Dispositivos ainda não suporta Autenticação Empresarial. Também pode usar o menu suspenso Perfis para tentar estabelecer ligação a qualquer um dos perfis Wi‑Fi guardados no dispositivo.
  • Configuração IP: Mostra a informação de endereço sobre cada uma das portas de rede do dispositivo anfitrião.

Características e notas de serviço

DNS-SD

O Portal de Dispositivos anuncia a sua presença na rede local usando DNS-SD. Todas as instâncias do Portal de Dispositivos, independentemente do tipo de dispositivo, anunciam-se como "WDP._wdp._tcp.local". Os registos TXT da instância de serviço fornecem o seguinte:

Key Tipo Descrição
S int Porta segura para o Portal do Dispositivo. Se for 0 (zero), o Portal de Dispositivos não está a escutar ligações HTTPS.
D cadeia (de caracteres) Tipo de dispositivo. Isto será no formato "Windows.*", por exemplo, Windows. Ambiente de trabalho ou Windows. IoTEnterprise.
A cadeia (de caracteres) Arquitetura do dispositivo. Isto será Arm, x86 ou AMD64.
T Lista de cadeias de caracteres delimitada por caráteres nulos Etiquetas aplicadas pelo utilizador para o dispositivo. Consulte a API REST das Etiquetas para saber como usar isto. A lista é duplamente nula terminada.

Recomenda-se estabelecer ligação através da porta HTTPS, uma vez que nem todos os dispositivos estão à escuta na porta HTTP anunciada pelo registo DNS-SD.

Proteção contra CSRF e Scripting

Para se proteger contra ataques CSRF, é necessário um token único em todos os pedidos que não sejam GET. Este token, o cabeçalho de pedido X-CSRF-Token, é derivado de um cookie de sessão, CSRF-Token. Na interface web do Portal do Dispositivo, o cookie CSRF-Token é copiado para o cabeçalho X-CSRF-Token em cada pedido.

Importante

Esta proteção impede a utilização das APIs REST a partir de um cliente autónomo (como utilidades de linha de comandos). Isto pode ser resolvido de 3 formas:

  • Use um nome de utilizador "auto-". Os clientes que colocam "auto-" no nome de utilizador vão contornar a proteção CSRF. É importante que este nome de utilizador não seja usado para iniciar sessão no Portal do Dispositivo através do navegador, pois isso abrirá o serviço a ataques CSRF. Exemplo: Se o nome de utilizador do Portal do Dispositivo for "admin", curl -u auto-admin:password <args> deve ser utilizado para contornar a proteção CSRF.
  • Implemente o mecanismo de cookie para cabeçalho no cliente. Isto requer um pedido GET para estabelecer o cookie da sessão, e depois a inclusão tanto do cabeçalho como do cookie em todos os pedidos subsequentes.
  • Desative a autenticação e use HTTP. A proteção CSRF aplica-se apenas a endpoints HTTPS, por isso as ligações em endpoints HTTP não precisarão de fazer nenhuma das opções acima.

Proteção contra captura de WebSocket entre sites (CSWSH)

Para proteger contra ataques CSWSH, todos os clientes que abrem uma ligação WebSocket ao Portal do Dispositivo devem também fornecer um cabeçalho Origin que corresponda ao cabeçalho Host. Isto prova ao Portal de Dispositivos que o pedido vem da interface do Portal de Dispositivos ou de uma aplicação cliente válida. Sem o cabeçalho Origin, o seu pedido será rejeitado.

Consulte também

Referência da API central do Device Portal

  • Last updated on