Een JavaScript-API testen

Een test maken is een op een browser gebaseerde UWP-app die vergrendelde online evaluaties weergeeft voor testen met hoge inzet, zodat docenten zich kunnen richten op de evaluatie-inhoud in plaats van hoe ze een veilige testomgeving kunnen bieden. Hiervoor wordt een JavaScript-API gebruikt die elke webtoepassing kan gebruiken. De Take-a-test-API ondersteunt de SBAC-browser-API-standaard voor algemene kerntests.

Zie de technische referentiegids van de Take a Test app voor meer informatie over de app zelf. Zie Problemen met Microsoft Take a Test oplossen met de logboeken voor hulp bij het oplossen van problemen.

Referentiedocumentatie

De Take a Test-API's bevinden zich in de volgende naamruimten. Houd er rekening mee dat alle API's afhankelijk zijn van een globaal SecureBrowser object.

Beveiligingsnaamruimte

Met de beveiligingsnaamruimte kunt u het apparaat vergrendelen, de lijst met gebruikers- en systeemprocessen controleren, MAC- en IP-adressen verkrijgen en webresources in de cache wissen.

Lockdown

Hiermee wordt het apparaat vergrendeld. Ook gebruikt om het apparaat te ontgrendelen. De testwebtoepassing roept deze aanroep aan voordat studenten kunnen beginnen met testen. De implementeerfunctie is vereist om eventuele acties uit te voeren die nodig zijn om de testomgeving te beveiligen. De stappen voor het beveiligen van de omgeving zijn specifiek voor apparaten en omvatten bijvoorbeeld aspecten zoals het uitschakelen van schermopnamen, het uitschakelen van spraakchat in de beveiligde modus, het wissen van het klembord van het systeem, het invoeren van een kioskmodus, het uitschakelen van Ruimten in OSX 10.7+ apparaten, enzovoort. De testtoepassing schakelt de vergrendeling in voordat een evaluatie begint en schakelt de vergrendeling uit wanneer de student de evaluatie heeft voltooid en buiten de veilige test valt.

Syntax
void SecureBrowser.security.lockDown(Boolean enable, Function onSuccess, Function onError);

Parameters

• enable - true om de Take-a-Test-app boven het vergrendelingsscherm uit te voeren en beleidsregels toe te passen die worden besproken in de technische referentie van de Take-a-Test-app. false stopt met het uitvoeren van Take-a-Test boven het vergrendelingsscherm en sluit deze, tenzij de app niet is vergrendeld; in dat geval is er geen effect.
• onSuccess - [optioneel] De functie die moet worden aangeroepen nadat de vergrendeling is ingeschakeld of uitgeschakeld. Het moet de vorm Function(Boolean currentlockdownstate) hebben.
• onError - [optioneel] De functie die moet worden aangeroepen als de vergrendelingsbewerking is mislukt. Het moet van de vorm Function(Boolean currentlockdownstate) zijn.

Requirements
Windows 10 versie 1709 of hoger

isEnvironmentSecure

Bepaalt of de vergrendelingscontext nog steeds wordt toegepast op het apparaat. De testwebtoepassing geeft dit aan voordat studenten kunnen beginnen met testen en doet dit periodiek tijdens de test.

Syntax
void SecureBrowser.security.isEnvironmentSecure(Function callback);

Parameters

• callback - De functie die moet worden aangeroepen wanneer deze functie is voltooid. Het moet van het formulier Function(String state) zijn waarin state een JSON-tekenreeks met twee velden is. De eerste is het secure veld, dat alleen wordt weergegeven true als alle benodigde vergrendelingen zijn ingeschakeld (of functies uitgeschakeld) om een veilige testomgeving in te schakelen, en geen van deze zijn gecompromitteerd sinds de app de vergrendelingsmodus heeft ingevoerd. Het andere veld, messageKeybevat andere details of informatie die specifiek is voor de leverancier. Het doel hier is om leveranciers in staat te stellen aanvullende informatie te plaatsen die de booleaanse secure vlag vergroot:

{
    'secure' : "true/false",
    'messageKey' : "some message"
}

Requirements
Windows 10, versie 1709 of hoger

getDeviceInfo

Hier vindt u informatie over het platform waarop de testtoepassing wordt uitgevoerd. Dit wordt gebruikt om alle informatie die te onderscheiden is van de gebruikersagent te verbeteren.

Syntax
void SecureBrowser.security.getDeviceInfo(Function callback);

Parameters

• callback - De functie die moet worden aangeroepen wanneer deze functie is voltooid. Het moet van het formulier Function(String infoObj) zijn waar infoObj een JSON-tekenreeks met verschillende velden is. De volgende velden moeten worden ondersteund:
  • os vertegenwoordigt het type besturingssysteem (bijvoorbeeld: Windows, macOS, Linux, iOS, Android, enzovoort)
  • name vertegenwoordigt de releasenaam van het besturingssysteem, indien van toepassing (bijvoorbeeld: Sierra, Ubuntu).
  • version vertegenwoordigt de versie van het besturingssysteem (bijvoorbeeld: 10.1, 10 Pro, enzovoort)
  • brand vertegenwoordigt de huisstijl van de beveiligde browser (bijvoorbeeld: OAKS, CA, SmarterApp, enzovoort)
  • model vertegenwoordigt alleen het apparaatmodel voor mobiele apparaten; null/ongebruikt voor desktopbrowsers.

Requirements
Windows 10, versie 1709 of hoger

examineProcessList

Hiermee haalt u de lijst op van alle processen die worden uitgevoerd op de clientcomputer die eigendom is van de gebruiker. De testtoepassing roept deze aan om de lijst te onderzoeken en te vergelijken met een lijst met processen die tijdens de testcyclus als geweigerd zijn beschouwd. Deze aanroep moet zowel aan het begin van een evaluatie als periodiek worden aangeroepen terwijl de student de evaluatie neemt. Als er een geblokkeerd proces wordt gedetecteerd, moet de beoordeling worden gestopt om de testintegriteit te behouden.

Syntax
void SecureBrowser.security.examineProcessList(String[] denylistedProcessList, Function callback);

Parameters

• denylistedProcessList - De lijst met processen die door de testtoepassing op de zwarte lijst zijn gezet.
  callback - De functie die moet worden aangeroepen zodra de actieve processen zijn gevonden. Deze moet zich in de vorm bevinden: Function(String foundDenylistedProcesses) waar foundDenylistedProcesses bevindt zich in de vorm: "['process1.exe','process2.exe','processEtc.exe']". Deze is leeg als er geen geblokkeerde processen zijn gevonden. Als het null is, geeft dit aan dat er een fout is opgetreden in de oorspronkelijke functieaanroep.

Opmerkingen De lijst bevat geen systeemprocessen.

Requirements
Windows 10, versie 1709 of hoger

close

Sluit de browser en ontgrendelt het apparaat. De testtoepassing moet deze aanroepen wanneer de gebruiker ervoor kiest om de browser af te sluiten.

Syntax
void SecureBrowser.security.close(restart);

Parameters

• restart - Deze parameter wordt genegeerd, maar moet worden opgegeven.

Opmerkingen In Windows 10 versie 1607 moet het apparaat in eerste instantie worden vergrendeld. In latere versies sluit deze methode de browser, ongeacht of het apparaat is vergrendeld.

Requirements
Windows 10, versie 1709 of hoger

getPermissiveMode

De testwebtoepassing moet deze aanroepen om te bepalen of de permissieve modus is ingeschakeld of uitgeschakeld. In de permissieve modus wordt verwacht dat een browser sommige van zijn strenge beveiligingshaken versoepelt om de samenwerking met ondersteunende technologie in een beveiligde browseromgeving te vergemakkelijken. Browsers die bijvoorbeeld agressief voorkomen dat andere toepassings-UIS's er bovenop worden weergegeven, willen dit mogelijk ontspannen in de permissieve modus.

Syntax
void SecureBrowser.security.getPermissiveMode(Function callback)

Parameters

• callback - De functie die moet worden aangeroepen wanneer deze aanroep is voltooid. Dit moet de vorm hebben: Function(Boolean permissiveMode) waarbij permissiveMode aangeeft of de browser momenteel in de permissieve modus is. Als deze niet gedefinieerd of null is, is er een fout opgetreden in de get-bewerking.

Requirements
Windows 10, versie 1709 of hoger

setPermissiveMode

De testwebtoepassing moet deze aanroepen om de permissieve modus in of uit te schakelen. In de permissieve modus wordt verwacht dat een browser sommige van zijn strenge beveiligingshaken versoepelt om de samenwerking met ondersteunende technologie in een beveiligde browseromgeving te vergemakkelijken. Browsers die bijvoorbeeld agressief voorkomen dat andere toepassings-UIS's er bovenop worden weergegeven, willen dit mogelijk ontspannen in de permissieve modus.

Syntax
void SecureBrowser.security.setPermissiveMode(Boolean enable, Function callback)

Parameters

• enable - De Booleaanse waarde die de beoogde permissieve modus status aangeeft.
• callback - De functie die moet worden aangeroepen wanneer deze aanroep is voltooid. Dit moet de vorm hebben: Function(Boolean permissiveMode) waarbij permissiveMode aangeeft of de browser momenteel in de permissieve modus is. Als deze niet gedefinieerd of null is, is er een fout opgetreden in de setbewerking.

Requirements
Windows 10, versie 1709 of hoger

emptyClipBoard

Leegmaakt het systeemklembord. De testtoepassing moet worden aangeroepen om eventuele gegevens die op het systeemklembord kunnen zijn opgeslagen, geforceerd te wissen. De lockDown-functie voert deze bewerking ook uit.

Syntax
void SecureBrowser.security.emptyClipBoard();

Requirements
Windows 10, versie 1709 of hoger

getMACAddress

Hiermee haalt u de lijst met MAC-adressen voor het apparaat op. De testtoepassing moet deze aanroepen om te helpen bij diagnostische gegevens.

Syntax
void SecureBrowser.security.getMACAddress(Function callback);

Parameters

• callback - De functie die moet worden aangeroepen wanneer deze aanroep is voltooid. Deze moet zich in de vorm bevinden: Function(String addressArray) waar addressArray bevindt zich in de vorm: "['00:11:22:33:44:55','etc']".

Remarks
Het is moeilijk om te vertrouwen op bron-IP-adressen om onderscheid te maken tussen computers van eindgebruikers binnen de testservers, omdat firewalls/NAT's/proxy's vaak worden gebruikt op de scholen. Met de MAC-adressen kan de app eindclientcomputers achter een gemeenschappelijke firewall onderscheiden voor diagnostische doeleinden.

Requirements
Windows 10, versie 1709 of hoger

getStartTime

Hiermee wordt de tijd opgehaald waarop de test-app is gestart.

Syntax
DateTime SecureBrowser.security.getStartTime();

Terug
Een DateTime-object dat aangeeft op welk moment de test-app is gestart.

Requirements
Windows 10, versie 1709 of hoger

getCapability

Vraagt of een functie is ingeschakeld of uitgeschakeld.

Syntax
Object SecureBrowser.security.getCapability(String feature)

Parameters

feature - De tekenreeks om te bepalen welke capaciteit moet worden bevraagd. Geldige functionaliteit strings zijn "screenMonitoring", "printing" en "textSuggestions" (hoofdletterongevoelig).

Retourwaarde
Deze functie retourneert een JavaScript-object of een letterlijke waarde in de vorm van: {<feature>:true|false}. waar als de opgevraagde mogelijkheid is ingeschakeld, onwaar als de mogelijkheid niet is ingeschakeld of als de mogelijkheidsreeks ongeldig is.

Eisen Windows 10, versie 1703 of hoger

setCapability

Hiermee schakelt u een specifieke functie in of uit in de browser.

Syntax
void SecureBrowser.security.setCapability(String feature, String value, Function onSuccess, Function onError)

Parameters

• feature - De tekenreeks om te bepalen welke functionaliteit moet worden ingesteld. Geldige mogelijkheidstekenreeksen zijn "screenMonitoring", "printing", en "textSuggestions" (niet-hoofdlettergevoelig).
• value - De beoogde instelling voor de functie. Het moet "true" of "false"zijn.
• onSuccess - [optioneel] De functie die moet worden aangeroepen nadat de setbewerking is voltooid. Het moet van het formulier Function(String jsonValue) zijn waarin jsonValue zich in de vorm bevindt: {<feature>:true|false|undefined}.
• onError - [optioneel] De functie die moet worden aangeroepen als de setbewerking is mislukt. Het moet van het formulier Function(String jsonValue) zijn waarin jsonValue zich in de vorm bevindt: {<feature>:true|false|undefined}.

Remarks
Als de doelfunctie onbekend is voor de browser, geeft deze functie een waarde van undefined de callback-functie door.

Eisen Windows 10, versie 1703 of hoger

isRemoteSession

Controleert of de huidige sessie extern is aangemeld.

Syntax
Boolean SecureBrowser.security.isRemoteSession();

Retourwaarde
waar als de huidige sessie op afstand is, anders onwaar.

Requirements
Windows 10 versie 1709 of hoger

isVMSession

Controleert of de huidige sessie wordt uitgevoerd binnen een virtuele machine.

Syntax
Boolean SecureBrowser.security.isVMSession();

Retourwaarde
waar als de huidige sessie wordt uitgevoerd op een virtuele machine, anders onwaar.

Remarks
Deze API-controle kan alleen VM-sessies detecteren die worden uitgevoerd in bepaalde hypervisors die de juiste API's implementeren

Requirements
Windows 10 versie 1709 of hoger