Overzicht van Windows Device Portal

De Windows Device Portal (WDP) is een webserver die is opgenomen in Windows apparaten waarmee u de instellingen voor het apparaat kunt configureren en beheren via een netwerk- of USB-verbinding (lokale verbindingen worden ook ondersteund op apparaten met een webbrowser).

WDP biedt ook geavanceerde diagnostische hulpprogramma's voor het oplossen van problemen en het weergeven van de realtime prestaties van uw Windows-apparaat.

WDP-functionaliteit wordt programmatisch weergegeven via een verzameling REST API's.

Dit artikel bevat een algemene beschrijving van de Windows Device Portal en bevat koppelingen naar artikelen met meer specifieke informatie over elke Windows apparaatfamilie.

Note

Een apparaatfamilie identificeert de API's, systeemkenmerken en gedragingen die u kunt verwachten voor een klasse van apparaten.

Warning

Apparaatportal is standaard uitgeschakeld. U moet de ontwikkelaarsmodus inschakelen en vervolgens apparaatportal expliciet inschakelen in Settings > System > Advanced voordat u deze gebruikt.

Configuratie

Elke apparaatfamilie biedt een versie van de WDP, maar functies en installatie variëren op basis van de vereisten van een apparaat.

Dit zijn de basisstappen voor alle apparaten.

  1. Schakel de ontwikkelaarsmodus in. Zie Instellingen voor ontwikkelaars voor instructies.

    Schermopname van het venster Settings > System > Advanced met de ontwikkelaarsmodus ingeschakeld.

  2. Schakel de apparaatportal in op uw apparaat (Instellingen > systeem > geavanceerd).

    Schermopname van het venster Settings > System > Advanced met de instellingen van de apparaatportal die beschikbaar zijn nadat deze is ingeschakeld.

  3. Sluit uw apparaat en pc aan via een lokaal netwerk of via USB.

  4. Navigeer naar de pagina Apparaatportal in uw browser. In deze tabel ziet u de poorten en protocollen die door elke apparaatfamilie worden gebruikt.

De volgende tabel bevat apparaatspecifieke details voor de WDP.

Apparaatfamilie Standaard ingeschakeld? HTTP HTTPS USB Aanwijzingen
Desktop en IoT voor ondernemingen Inschakelen in dev-modus 50080* 50043* N/A Apparaatportal voor Desktop- of IoT Enterprise-apparaat

* Dit is niet altijd het geval, omdat Device Portal op de desktop poorten in het dynamische poortbereik claimt (>50.000) om conflicten met bestaande poorttoewijzingen op het apparaat te voorkomen. Zie de sectie Op register gebaseerde configuratie in Windows Device Portal for Desktop voor meer informatie.

Features

Werkbalk en navigatie

De werkbalk boven aan de pagina biedt toegang tot veelgebruikte functies.

  • Energie: Opties voor toegang tot energie.
    • Afsluiten: hiermee schakelt u het apparaat uit.
    • Opnieuw opstarten: start het apparaat opnieuw op.
  • Help: Hiermee opent u de Help-pagina.

Gebruik de koppelingen in het navigatiedeelvenster aan de linkerkant van de pagina om naar de beschikbare beheer- en bewakingshulpprogramma's voor uw apparaat te navigeren.

Hulpprogramma's die veel voorkomen in apparaatfamilies, worden hier beschreven. Er zijn mogelijk andere opties beschikbaar, afhankelijk van het apparaat. Zie de specifieke pagina voor uw apparaattype voor meer informatie.

Apps-beheer

Apps Manager biedt functionaliteit voor het installeren/verwijderen en beheren van app-pakketten en -bundels op het hostapparaat.

Beheerpagina voor Device Portal-apps

  • Apps implementeren: implementeer verpakte apps van lokale, netwerk- of webhosts en registreer losse bestanden van netwerkshares.
  • Geïnstalleerde apps: gebruik de vervolgkeuzelijst om apps te verwijderen of te starten die op het apparaat zijn geïnstalleerd.
  • Actieve apps: krijg informatie over de apps die momenteel worden uitgevoerd en sluit deze indien nodig.

Een app installeren (sideloaden)

U kunt apps sideloaden tijdens de ontwikkeling met behulp van Windows Device Portal:

  1. Wanneer u een app-pakket hebt gemaakt, kunt u het op afstand installeren op uw apparaat. Nadat u deze in Visual Studio hebt gemaakt, wordt er een uitvoermap gegenereerd.

    App-installatie

  2. Ga in Windows Device Portal naar de pagina Apps-beheer.

  3. Selecteer Lokale opslag in de sectie Apps implementeren.

  4. Selecteer onder Selecteer het toepassingspakket de optie Bestand kiezen en blader naar het app-pakket dat u wilt sideloaden.

  5. Selecteer Onder Certificaatbestand selecteren (.cer) dat wordt gebruikt om het app-pakket te ondertekenen, selecteert u Bestand kiezen en bladert u naar het certificaat dat is gekoppeld aan dat app-pakket.

  6. Schakel de respectieve selectievakjes in als u optionele of frameworkpakketten wilt installeren, samen met de app-installatie en selecteer Volgende om deze te kiezen.

  7. Selecteer Installeren om de installatie te starten.

  8. Als het apparaat Windows 10 in de S-modus gebruikt en dit de eerste keer is dat het opgegeven certificaat op het apparaat is geïnstalleerd, start u het apparaat opnieuw.

Een certificaat installeren

U kunt het certificaat ook installeren via Windows Device Portal en de app op een andere manier installeren:

  1. Ga in Windows Device Portal naar de pagina Apps-beheer.

  2. Selecteer Certificaat installeren in de sectie Apps implementeren.

  3. Selecteer Onder Certificaatbestand selecteren (.cer) dat wordt gebruikt om een app-pakket te ondertekenen, selecteert u Bestand kiezen en bladert u naar het certificaat dat is gekoppeld aan het app-pakket dat u wilt sideloaden.

  4. Selecteer Installeren om de installatie te starten.

  5. Als het apparaat Windows 10 in de S-modus gebruikt en dit de eerste keer is dat het opgegeven certificaat op het apparaat is geïnstalleerd, start u het apparaat opnieuw.

Een app verwijderen

  1. Zorg ervoor dat uw app niet actief is.
  2. Als dat het is, gaat u naar Actieve apps en sluit u deze. Als u probeert te verwijderen terwijl de app wordt uitgevoerd, veroorzaakt dit problemen wanneer u de app opnieuw probeert te installeren.
  3. Selecteer de app in de vervolgkeuzelijst en klik op Verwijderen.

Actieve processen

Op deze pagina ziet u details over processen die momenteel worden uitgevoerd op het hostapparaat. Dit omvat zowel apps als systeemprocessen. U kunt zowel app- als systeemprocessen beëindigen vanaf deze pagina.

Verkenner

Op deze pagina kunt u bestanden bekijken en bewerken die zijn opgeslagen door sideloadende apps. Bekijk de lokale opslag van uw app via de pagina Bestandsverkenner om uw appgegevens weer te geven en te beheren.

Performance

Op de pagina Prestaties ziet u realtime grafieken van diagnostische gegevens van het systeem, zoals energieverbruik, framesnelheid en CPU-belasting.

Dit zijn de beschikbare metrische gegevens:

  • CPU: Percentage van het totale beschikbare CPU-gebruik
  • Geheugen: Totaal, in gebruik, beschikbaar, vastgelegd, gepaginad en niet-gepaginad
  • I/O: gegevenshoeveelheden lezen en schrijven
  • Netwerk: Ontvangen en verzonden gegevens
  • GPU: Percentage van het totale beschikbare GPU-enginegebruik

Event Tracing for Windows (ETW)-logboekregistratie

De pagina voor ETW-logboekregistratie beheert realtime Event Tracing for Windows (ETW)-informatie op het apparaat.

Schakel Providers verbergen in om alleen de lijst met gebeurtenissen weer te geven.

  • Geregistreerde providers: selecteer de gebeurtenisprovider en het traceringsniveau. Het traceringsniveau is een van de volgende waarden:

    1. Abnormale afsluiting of beëindiging
    2. Ernstige fouten
    3. Warnings
    4. Waarschuwingen voor zaken die geen fouten zijn
    5. Gedetailleerde tracering

    Klik of tik op Inschakelen om tracering te starten. De provider wordt toegevoegd aan de vervolgkeuzelijst Ingeschakelde providers .

  • Aangepaste providers: Selecteer een aangepaste ETW-provider en het traceringsniveau. Identificeer de provider aan de hand van de GUID. Gebruik geen haakjes in de GUID.

  • Ingeschakelde providers: hiermee worden de ingeschakelde providers vermeld. Selecteer een provider in de vervolgkeuzelijst en klik of tik op Uitschakelen om tracering te stoppen. Klik of tik op Alles stoppen om alle tracering te onderbreken.

  • Geschiedenis van providers: hiermee worden de ETW-providers weergegeven die zijn ingeschakeld tijdens de huidige sessie. Klik of tik op Inschakelen om een provider te activeren die is uitgeschakeld. Klik of tik op Wissen om de geschiedenis te wissen.

  • Filters/gebeurtenissen: De sectie Gebeurtenissen bevat ETW-gebeurtenissen van de geselecteerde providers in tabelindeling. De tabel wordt in realtime bijgewerkt. Gebruik het menu Filters om aangepaste filters in te stellen waarvoor gebeurtenissen worden weergegeven. Klik op de knop Wissen om alle ETW-gebeurtenissen uit de tabel te verwijderen. Hiermee worden geen providers uitgeschakeld. U kunt op Opslaan klikken om de momenteel verzamelde ETW-gebeurtenissen te exporteren naar een lokaal CSV-bestand.

Prestatieanalyse

De Windows Performance Toolkit bevat de pagina Prestatietracering, waarmee u Windows WPR-traceringen (Performance Recorder) van het hostapparaat kunt bekijken.

  • Beschikbare profielen: selecteer het WPR-profiel in de vervolgkeuzelijst en klik of tik op Start om tracering te starten.
  • Aangepaste profielen: klik of tik op Bladeren om een WPR-profiel op uw pc te kiezen. Klik of tik op Uploaden en beginnen met traceren.

Als u de tracering wilt stoppen, klikt u op Stoppen. Blijf op deze pagina totdat het traceringsbestand (. ETL) is gedownload.

Vastgelegde .ETL-bestanden kunnen voor analyse worden geopend in Windows Performance Analyzer.

Apparaatbeheer

Op de pagina Apparaatbeheer worden alle randapparatuur opgesomd die aan uw apparaat is gekoppeld. U kunt op de instellingenpictogrammen klikken om de eigenschappen van elk pictogram weer te geven.

Networking

De pagina Netwerken beheert netwerkverbindingen op het apparaat. Als u niet via USB met Device Portal bent verbonden, zal het wijzigen van deze instellingen waarschijnlijk de verbinding met Device Portal verbreken.

  • Beschikbare netwerken: toont de Wi-Fi-netwerken die beschikbaar zijn voor het apparaat. Als u op een netwerk klikt of tikt, kunt u er verbinding mee maken en zo nodig een wachtwoordsleutel opgeven. Apparaatportal biedt nog geen ondersteuning voor Enterprise Authentication. U kunt ook de vervolgkeuzelijst Profielen gebruiken om verbinding te maken met een van de Wi-Fi-profielen die bekend zijn met het apparaat.
  • IP-configuratie: geeft adresgegevens weer over de netwerkpoorten van elk hostapparaat.

Functies en opmerkingen

DNS-SD

Het Device Portal maakt zijn aanwezigheid op het lokale netwerk bekend met behulp van DNS-SD. Alle Device Portal-instanties worden, ongeacht hun apparaattype, geadverteerd als "WDP._wdp._tcp.local". De TXT-records voor het service-exemplaar bieden het volgende:

Sleutel Typologie Description
S int Beveiligde poort voor Device Portal. Als 0 (nul) is, luistert de apparaatportal niet naar HTTPS-verbindingen.
D string Apparaattype. Dit heeft bijvoorbeeld de notatie 'Windows.*', bijvoorbeeld Windows. Bureaublad of Windows. IoTEnterprise.
A string Apparaatarchitectuur. Dit is Arm, x86 of AMD64.
T Lijst met door null-tekens gescheiden tekenreeksen Door de gebruiker toegepaste tags voor het apparaat. Zie de TAGS REST API voor het gebruik hiervan. De lijst wordt afgesloten met twee nultekens.

Verbinding via de HTTPS-poort wordt aangeraden, omdat niet alle apparaten luisteren op de HTTP-poort die in de DNS-SD-record wordt geadverteerd.

CSRF-beveiliging en -scripts

Om te beschermen tegen CSRF-aanvallen, is een uniek token vereist voor alle niet-GET-aanvragen. Dit token, de X-CSRF-Token requestheader, is afgeleid van een sessiecookie, CSRF-Token. In de webinterface van de Device Portal wordt de CSRF-Token-cookie bij elke aanvraag naar de X-CSRF-Token-header gekopieerd.

Important

Deze beveiliging voorkomt het gebruik van de REST API's van een zelfstandige client (zoals opdrachtregelprogramma's). Dit kan op drie manieren worden opgelost:

  • Gebruik een 'auto-' gebruikersnaam. Clients die 'automatisch' aan hun gebruikersnaam hebben toegevoegd, omzeilen CSRF-beveiliging. Het is belangrijk dat deze gebruikersnaam niet wordt gebruikt om u via de browser aan te melden bij Device Portal, omdat de service wordt geopend voor CSRF-aanvallen. Voorbeeld: Als de gebruikersnaam van de apparaatportal 'beheerder' is, curl -u auto-admin:password <args> moet worden gebruikt om CSRF-beveiliging te omzeilen.
  • Implementeer het cookie-to-header-schema in de client. Hiervoor is een GET-aanvraag vereist om de sessiecookie in te stellen en vervolgens zowel de header als de cookie mee te sturen bij alle volgende verzoeken.
  • Schakel verificatie uit en gebruik HTTP. CSRF-beveiliging is alleen van toepassing op HTTPS-eindpunten, dus verbindingen op HTTP-eindpunten hoeven geen van de bovenstaande handelingen uit te voeren.

Beveiliging tegen Cross-Site WebSocket Hijacking (CSWSH)

Ter bescherming tegen CSWSH-aanvallen moeten alle clients die een WebSocket-verbinding openen met de apparaatportal ook een Origin-header opgeven die overeenkomt met de hostheader. Hiermee wordt aan de Apparaatportal bewezen dat het verzoek afkomstig is van de gebruikersinterface van de Apparaatportal of van een geldige clienttoepassing. Zonder de Origin-header wordt uw aanvraag geweigerd.

Zie ook

Naslaginformatie over de core-API voor de apparaatportal

  • Last updated on