# Portal IBMF Chrome Bridge Dev

Extensao MV3 usada somente no `app_dev` para abrir BI Metasul e Useall Cloud em uma aba real do Chrome.

## Instalar no Chrome

1. No Portal dev, abra `/perfil.html` e use `Baixar extensao Chrome` na area de Integracoes.
2. Extraia `portal-bridge.zip` em uma pasta local do seu PC.
3. Abra `chrome://extensions`.
4. Ative `Modo do desenvolvedor`.
5. Clique em `Carregar sem compactacao`.
6. Selecione a pasta extraida `portal-bridge`.
7. Confirme o ID `nhbgmbnkibbhjbamaghpmdikajiajgnd`. O compose dev ja publica esse ID em `PORTAL_CHROME_EXTENSION_IDS`; se o Chrome gerar outro ID, ajuste a variavel e reinicie o backend dev.
8. Recarregue `/perfil.html` ou `/home.html`.

Sem a extensao ativa, Home e Perfil nao criam nem consomem token de credencial no navegador comum.

O Portal consegue baixar `portal-bridge.zip` automaticamente apos um clique do usuario, mas o Chrome nao permite instalacao silenciosa de extensao MV3 descompactada. A primeira instalacao precisa ser feita em `chrome://extensions` com `Carregar sem compactacao`.

## Politica

- A pagina do Portal envia apenas token efemero via `window.postMessage`.
- A extensao consome `POST /api/integracoes/launch/:token/consume-extension`.
- O backend libera credenciais somente para `Origin: chrome-extension://<id permitido>`.
- A extensao nao executa JavaScript vindo do backend; o autofill usa `chrome.scripting.executeScript` com funcao local.