Fazer um teste da API JavaScript

Fazer um teste é um aplicativo UWP baseado em navegador que renderiza avaliações online bloqueadas para testes de alto risco, permitindo que os educadores se concentrem no conteúdo da avaliação em vez de como fornecer um ambiente de teste seguro. Para isso, ele usa uma API JavaScript que qualquer aplicativo Web pode utilizar. A API take-a-test dá suporte ao padrão de API do navegador SBAC para testes básicos comuns de alto risco.

Consulte a referência técnica do aplicativo Take a Test para obter mais informações sobre o aplicativo em si. Para obter ajuda para solucionar problemas, consulte "Solução de problemas do Microsoft Take a Test com o Visualizador de Eventos".

Documentação de referência

As APIs fazer um teste existem nos namespaces a seguir. Observe que todas as APIs dependem de um objeto global SecureBrowser .

Namespace de segurança

O namespace de segurança permite que você bloqueie o dispositivo, verifique a lista de processos de usuário e sistema, obtenha endereços MAC e IP e limpe os recursos da Web armazenados em cache.

Bloqueio

Bloqueia o dispositivo. Também usado para desbloquear o dispositivo. O aplicativo Web de teste invocará essa chamada antes de permitir que os alunos iniciem o teste. O implementador é necessário para executar todas as ações necessárias para proteger o ambiente de teste. As etapas tomadas para proteger o ambiente são específicas do dispositivo e, por exemplo, incluem aspectos como desabilitar capturas de tela, desabilitar o chat de voz quando estiver no modo seguro, limpar a área de transferência do sistema, entrar em um modo de quiosque, desabilitar espaços em dispositivos OSX 10.7+ etc. O aplicativo de teste habilitará o bloqueio antes do início de uma avaliação e desabilitará o bloqueio quando o aluno concluir a avaliação e estiver fora do teste seguro.

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

Parâmetros

• enable - true para executar o aplicativo Take-a-Test acima da tela de bloqueio e aplicar políticas discutidas na referência técnica do aplicativo Take-a-Test. false para de executar Take-a-Test acima da tela de bloqueio e fecha-o, a menos que o aplicativo não esteja bloqueado; nesse caso, não há nenhum efeito.
• onSuccess - [opcional] Função a ser chamada após o bloqueio ter sido habilitado ou desabilitado com sucesso. Deve ser da forma Function(Boolean currentlockdownstate).
• onError - [opcional] A função a ser chamada se a operação de bloqueio falhou. Deve ser do formato Function(Boolean currentlockdownstate).

Requisitos
Windows 10, versão 1709 ou posterior

éAmbienteSeguro

Determina se o contexto de bloqueio ainda é aplicado ao dispositivo. O aplicativo Web de teste invocará isso antes de permitir que os alunos iniciem o teste e periodicamente quando estiverem dentro do teste.

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

Parâmetros

• callback - A função a ser chamada quando essa função for concluída. Ele deve ser do formulário Function(String state) em que state há uma cadeia de caracteres JSON contendo dois campos. O primeiro é o campo secure, que será exibido true somente se todos os bloqueios necessários estiverem ativados (ou recursos desativados) para criar um ambiente de teste seguro, e nenhum deles for comprometido desde que o aplicativo entrou no modo de bloqueio. O outro campo inclui messageKeyoutros detalhes ou informações específicas do fornecedor. A intenção aqui é permitir que os fornecedores coloquem informações adicionais que aumentem o sinalizador booliano secure :

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

Requisitos
Windows 10, versão 1709 ou mais recente

getDeviceInfo

Obtém detalhes sobre a plataforma na qual o aplicativo de teste está em execução. Isso é usado para suplementar qualquer informação que tenha sido perceptível do agente de usuário.

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

Parâmetros

• callback - A função a ser chamada quando essa função for concluída. Ele deve ser do formulário Function(String infoObj) em que infoObj há uma cadeia de caracteres JSON contendo vários campos. Os seguintes campos devem ter suporte:
  • os representa o tipo de sistema operacional (por exemplo: Windows, macOS, Linux, iOS, Android etc.)
  • name representa o nome da versão do sistema operacional, se houver (por exemplo: Sierra, Ubuntu).
  • version representa a versão do sistema operacional (por exemplo: 10.1, 10 Pro etc.)
  • brand representa a identidade visual do navegador seguro (por exemplo: OAKS, CA, SmarterApp etc.)
  • model representa o modelo de dispositivo somente para dispositivos móveis; nulo/não utilizado para navegadores da área de trabalho.

Requisitos
Windows 10, versão 1709 ou mais recente

examineProcessList

Obtém a lista de todos os processos em execução no computador cliente de propriedade do usuário. O aplicativo de teste invocará isso para examinar a lista e compará-la com uma lista de processos que foram inclusos na lista de negação durante o ciclo de testes. Essa chamada deve ser invocada no início de uma avaliação e periodicamente enquanto o aluno está fazendo a avaliação. Se um processo em lista de bloqueio for detectado, a avaliação deverá ser interrompida para preservar a integridade do teste.

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

Parâmetros

• denylistedProcessList - A lista de processos que o aplicativo de teste incluiu na lista de bloqueio.
  callback - A função a ser invocada depois que os processos ativos forem encontrados. Ele deve estar na forma: Function(String foundDenylistedProcesses) onde foundDenylistedProcesses está no formulário: "['process1.exe','process2.exe','processEtc.exe']". Ele ficará vazio se nenhum processo listado por negação tiver sido encontrado. Se for nulo, isso indicará que ocorreu um erro na chamada de função original.

Observações A lista não inclui processos do sistema.

Requisitos
Windows 10, versão 1709 ou mais recente

fechar

Fecha o navegador e desbloqueia o dispositivo. O aplicativo de teste deve invocar isso quando o usuário optar por sair do navegador.

Sintaxe
void SecureBrowser.security.close(restart);

Parâmetros

• restart - Esse parâmetro é ignorado, mas deve ser fornecido.

Observações No Windows 10, versão 1607, o dispositivo deve ser bloqueado inicialmente. Em versões posteriores, esse método fecha o navegador independentemente de o dispositivo ser bloqueado.

Requisitos
Windows 10, versão 1709 ou mais recente

getPermissiveMode

O aplicativo Web de teste deve invocar isso para determinar se o modo permissivo está ativado ou desativado. No modo permissivo, espera-se que um navegador relaxe alguns de seus ganchos de segurança rigorosos para permitir que a tecnologia adaptativa funcione com o navegador seguro. Por exemplo, navegadores que impedem agressivamente a apresentação de outras interfaces do usuário do aplicativo sobre eles podem querer relaxar isso quando estiverem no modo permissivo.

Sintaxe
void SecureBrowser.security.getPermissiveMode(Function callback)

Parâmetros

• callback - A função a ser invocada quando essa chamada for concluída. Ele deve estar no formulário: Function(Boolean permissiveMode) onde permissiveMode indica se o navegador está atualmente no modo permissivo. Se for indefinido ou nulo, ocorreu um erro na operação de obtenção.

Requisitos
Windows 10, versão 1709 ou mais recente

setPermissiveMode

O aplicativo Web de teste deve invocar isso para ativar ou desativar o modo permissivo. No modo permissivo, espera-se que um navegador relaxe alguns de seus ganchos de segurança rigorosos para permitir que a tecnologia adaptativa funcione com o navegador seguro. Por exemplo, navegadores que impedem agressivamente a apresentação de outras interfaces do usuário do aplicativo sobre eles podem querer relaxar isso quando estiverem no modo permissivo.

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

Parâmetros

• enable - O valor booliano que indica o status do modo permissivo pretendido.
• callback - A função a ser invocada quando essa chamada for concluída. Ele deve estar no formulário: Function(Boolean permissiveMode) onde permissiveMode indica se o navegador está atualmente no modo permissivo. Se for indefinido ou nulo, ocorreu um erro na operação de atribuição.

Requisitos
Windows 10, versão 1709 ou mais recente

emptyClipBoard

Limpa a área de transferência do sistema. O aplicativo de teste deve invocar isso para forçar a limpeza de todos os dados que possam estar armazenados na área de transferência do sistema. A função lockDown também executa essa operação.

Sintaxe
void SecureBrowser.security.emptyClipBoard();

Requisitos
Windows 10, versão 1709 ou mais recente

getMACAddress

Obtém a lista de endereços MAC para o dispositivo. O aplicativo de teste deve invocar isso para ajudar no diagnóstico.

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

Parâmetros

• callback - A função a ser invocada quando essa chamada for concluída. Ele deve estar na forma: Function(String addressArray) onde addressArray está no formulário: "['00:11:22:33:44:55','etc']".

Comentários
É difícil contar com endereços IP de origem para distinguir entre computadores de usuário final dentro dos servidores de teste porque firewalls/NATs/Proxies geralmente estão em uso nas escolas. Os endereços MAC permitem que o aplicativo distingue computadores cliente finais por trás de um firewall comum para fins de diagnóstico.

Requisitos
Windows 10, versão 1709 ou mais recente

getStartTime

Obtém a hora em que o aplicativo de teste foi iniciado.

Sintaxe
DateTime SecureBrowser.security.getStartTime();

Retornar
Um objeto DateTime que indica a hora em que o aplicativo de teste foi iniciado.

Requisitos
Windows 10, versão 1709 ou mais recente

getCapability

Consulta se uma funcionalidade está habilitada ou desabilitada.

Sintaxe
Object SecureBrowser.security.getCapability(String feature)

Parâmetros

feature - A cadeia de caracteres para determinar qual funcionalidade consultar. As cadeias de caracteres de funcionalidade válidas são "screenMonitoring", "printing" e "textSuggestions" (não diferencia maiúsculas de minúsculas).

Valor retornado
Essa função retorna um objeto JavaScript ou literal com o formato: {<feature>:true|false}. true se a funcionalidade consultada estiver habilitada, false se a funcionalidade não estiver habilitada ou se a cadeia de caracteres de funcionalidade for inválida.

Requisitos Windows 10, versão 1703 ou mais recente

setCapability

Habilita ou desabilita uma funcionalidade específica no navegador.

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

Parâmetros

• feature - A cadeia de caracteres para determinar qual funcionalidade deve ser definida. As cadeias de caracteres de funcionalidade válidas são "screenMonitoring", "printing"e "textSuggestions" (não diferencia maiúsculas de minúsculas).
• value - A configuração pretendida para o recurso. Deve ser "true" ou "false".
• onSuccess - [opcional] A função a ser chamada após a operação de definição ter sido concluída com sucesso. Deve ser da forma Function(String jsonValue) em que jsonValue está na forma: {<feature>:true|false|undefined}.
• onError - [opcional] A função a ser chamada se a operação de atribuição falhar. Deve ser da forma Function(String jsonValue) em que jsonValue está na forma: {<feature>:true|false|undefined}.

Comentários
Se o recurso de destino for desconhecido para o navegador, essa função passará um valor de undefined para a função de retorno chamada.

Requisitos Windows 10, versão 1703 ou mais recente

isRemoteSession

Verifica se a sessão atual está conectada remotamente.

Sintaxe
Boolean SecureBrowser.security.isRemoteSession();

Valor retornado
true se a sessão atual for remota, caso contrário, false.

Requisitos
Windows 10, versão 1709 ou posterior

isVMSession

Verifica se a sessão atual está em execução em uma máquina virtual.

Sintaxe
Boolean SecureBrowser.security.isVMSession();

Valor retornado
true se a sessão atual estiver em execução em uma máquina virtual, caso contrário, false.

Comentários
Essa verificação de API só pode detectar sessões de VM em execução em determinados hipervisores que implementam as APIs apropriadas

Requisitos
Windows 10, versão 1709 ou posterior