A interface dentro da CSP
A interface de um dispositivo vem do firmware (a pasta web/, empacotada pelo devui pack) ou da publicação do produto (a mesma pasta, publicada pelo devui publish). Nos dois casos, ela é servida pela nuvem num endereço só dela, https://<rótulo>.thingface.com, e roda dentro da moldura do portal. A nuvem não confia nela: o bundle é entrada hostil, e a página roda presa por uma política de segurança de conteúdo (CSP) e por um sandbox. Esta página diz o que cabe dentro disso, para a interface funcionar na primeira tentativa.
O que a página pode
- Carregar os próprios arquivos por caminho relativo: scripts (
<script src=js/app.js>), módulos, folhas de estilo, imagens, fontes, áudio e vídeo do bundle. - Estilo embutido (
style="..."e<style>): permitido. - Imagens e mídia de
data:eblob:(um gráfico desenhado na hora, um arquivo que a página gerou). - Falar com a placa pela lib,
/_devui/v1.js(o único caminho absoluto aceito):send,request,on, o estado. A lib abre o canal na própria origem da página, o único destino de rede permitido. - Workers do próprio bundle ou de
blob:, e WebAssembly. - Abrir janelas (
window.open, um link comtarget=_blank), baixar arquivos e mostraralert/confirm. - Guardar dados neste navegador pela lib (
dev.storage): o portal guarda por usuário e por dispositivo, até 64 KiB no plano Grátis e 256 KiB nos pagos. Sai no logout, quando outra pessoa entra no navegador e depois de 90 dias sem uso.
O que a página não pode
- Atributo de evento (
onclick=,onload=,href="javascript:..."): a CSP recusa. Ligue os eventos comaddEventListener. Um<script>embutido no HTML do bundle pode: a nuvem calcula o hash de cada um ao receber o bundle e o põe na CSP, então ele tem de estar no HTML que subiu, não ser montado depois pela página. - Caminho absoluto (
/js/app.js,url(/fonte.woff2),href="/"): a nuvem recusa o upload do bundle que tem um fora de/_devui/. Use caminhos relativos. - Rede fora da própria origem:
fetcha outro site, CDN, fonte externa, analytics. Tudo o que a página usa vai dentro do bundle. - Cookies,
localStorage,sessionStorage, IndexedDB e Cache Storage: a página roda numa origem opaca (osandboxsemallow-same-origin), e cada um desses lançaSecurityError. Usedev.storage. - Formulário que envia (
form-action 'none'): trate o envio em JavaScript e mande pela lib. - Moldura dentro da página (
frame-src 'none'),<object>e<embed>, e<base>. - Câmera, microfone, localização, USB, serial, Bluetooth, tela cheia e área de transferência: a
Permissions-Policybloqueia todos. - Ser emoldurada por outro site: só o portal do mercado pode mostrar a página.
Conferir antes de gravar ou publicar
O devui pack (e o devui publish, que empacota do mesmo jeito) empacota a pasta e recusa o que a nuvem recusaria (caminho absoluto, extensão fora da lista, tamanho). Para ver a página como a nuvem a serve, abra-a pelo portal: o console do navegador mostra cada recusa da CSP com a diretiva, e o exemplo do LED é um ponto de partida que já cabe em tudo isso.
