Pular para o conteúdo
ThingFace

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: e blob: (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 com target=_blank), baixar arquivos e mostrar alert/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 com addEventListener. 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: fetch a 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 (o sandbox sem allow-same-origin), e cada um desses lança SecurityError. Use dev.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-Policy bloqueia 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.