> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telepatia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalacao Manifest V3

> Guia de implantacao institucional do Scribe Web Companion — build MV3 (Chrome, Edge, Chromium >= 88)

<Info>
  **Publico-alvo:** Equipes de TI e Seguranca da Informacao de hospitais.
  Este guia cobre o build **Manifest V3** — o build recomendado para Google Chrome, Microsoft Edge e forks do Chromium com versao >= 88.
</Info>

## Extension ID

```
fobdkddljbpmhnlclknlgcgbeeeojcnb
```

Este e o identificador de 32 caracteres derivado da chave publica de assinatura do build MV3. Use este ID em todas as configuracoes de politica abaixo.

## Pre-requisitos

Antes de comecar, conclua o [checklist de avaliacao do ambiente](/pt-BR/scribe-web-companion/installation#institutional-deployment) e confirme:

* As estacoes de trabalho executam **Google Chrome**, **Microsoft Edge** ou um fork do Chromium com versao **>= 88**
* Conectividade HTTPS de saida para `cdn.telepatia.ai` esta liberada (porta 443)
* Uma plataforma de gerenciamento de politicas esta disponivel (ManageEngine, Intune, GPO ou equivalente)

## Trecho de Politica

A extensao e configurada pela politica `ExtensionSettings`, suportada nativamente pelo Chromium. Cole este JSON na sua plataforma de gerenciamento de politicas:

```json theme={null}
{
  "fobdkddljbpmhnlclknlgcgbeeeojcnb": {
    "installation_mode": "force_installed",
    "update_url": "https://cdn.telepatia.ai/scribe-extension/update-manifest.xml"
  }
}
```

### Campos

| Campo                              | Descricao                                                                                                            |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `fobdkddljbpmhnlclknlgcgbeeeojcnb` | Extension ID do MV3 — estavel, derivado da chave de assinatura                                                       |
| `installation_mode`                | `"force_installed"` instala silenciosamente e impede o usuario de desabilitar ou remover a extensao                  |
| `update_url`                       | Manifesto Omaha XML hospedado pela Telepatia. O navegador verifica esta URL periodicamente em busca de novas versoes |

### Bloqueio de outras extensoes (opcional)

Para permitir apenas o Scribe Companion e bloquear todas as outras extensoes:

```json theme={null}
{
  "*": {
    "installation_mode": "blocked"
  },
  "fobdkddljbpmhnlclknlgcgbeeeojcnb": {
    "installation_mode": "force_installed",
    "update_url": "https://cdn.telepatia.ai/scribe-extension/update-manifest.xml"
  }
}
```

## Obtendo o CRX

Para plataformas que exigem upload local do CRX (ex.: ManageEngine via Upload Directly):

<Steps>
  <Step title="Verifique o manifesto">
    Abra `https://cdn.telepatia.ai/scribe-extension/update-manifest.json` a partir de uma estacao de trabalho com acesso a internet.
  </Step>

  <Step title="Baixe o CRX do MV3">
    Use a URL do campo `v3.crx.downloadUrl`.
  </Step>

  <Step title="Verifique a integridade">
    ```powershell theme={null}
    Get-FileHash -Algorithm SHA256 .\extension-v3-<version>.crx
    ```

    Compare com o valor `v3.crx.sha256` do manifesto.
  </Step>
</Steps>

<Note>
  Esta e apenas a versao inicial. Apos a instalacao, o navegador atualiza automaticamente via o endpoint Omaha XML — nao e necessario baixar novamente a cada lancamento.
</Note>

## Implantacao via ManageEngine Endpoint Central

<Steps>
  <Step title="Navegue ate Browsers → Manage → Extension Repository" />

  <Step title="Add Extensions → Add Extensions for Google Chrome → Upload Directly" />

  <Step title="Faca upload do arquivo CRX">
    O ManageEngine o registra e exibe o Plugin Identifier — confirme que corresponde a `fobdkddljbpmhnlclknlgcgbeeeojcnb`.
  </Step>

  <Step title="Aplique a politica aos hosts/grupos de destino">
    Selecione por hostname, grupo de maquinas ou departamento.
  </Step>

  <Step title="Aguarde a propagacao">
    As estacoes de trabalho de destino recebem a politica na proxima sincronizacao do agente.
  </Step>

  <Step title="Valide">
    Siga a [validacao pos-instalacao](#validacao-pos-instalacao) abaixo.
  </Step>
</Steps>

## Implantacao via GPO

<Steps>
  <Step title="Abra o Group Policy Management Console">
    Edite (ou crie) a GPO direcionada a OU das estacoes de trabalho clinicas.
  </Step>

  <Step title="Navegue ate a politica">
    **Computer Configuration → Administrative Templates → Google Chrome → Extensions → ExtensionSettings**
    (Para Edge: mesmo caminho em "Microsoft Edge".)
  </Step>

  <Step title="Habilite e cole o trecho JSON acima" />

  <Step title="Vincule a GPO a OU de destino" />

  <Step title="Aguarde a atualizacao da GPO (~90 min) ou force com gpupdate /force" />

  <Step title="Valide">
    Siga a [validacao pos-instalacao](#validacao-pos-instalacao) abaixo.
  </Step>
</Steps>

## Requisitos de Rede

| Destino            | Porta       | Finalidade                                          |
| ------------------ | ----------- | --------------------------------------------------- |
| `cdn.telepatia.ai` | 443 / HTTPS | Manifestos, download do CRX, atualizacao automatica |

<Warning>
  Bloquear `cdn.telepatia.ai` impede silenciosamente a instalacao e todas as atualizacoes futuras. A estacao de trabalho permanece na versao instalada, sem receber correcoes de bugs e patches de seguranca.
</Warning>

### Inspecao SSL

Se o hospital realiza interceptacao TLS, configure uma excecao para `cdn.telepatia.ai`. O Chromium valida a assinatura criptografica do CRX — algumas implementacoes de inspecao SSL modificam cabecalhos que afetam a entrega de binarios.

## Atualizacao Automatica

Apos a instalacao, o navegador atualiza automaticamente a extensao a cada \~5 horas (com variacao entre \~2,5h e \~7,5h). Nenhuma intervencao de TI e necessaria.

Para forcar uma verificacao manual de atualizacao em uma estacao de trabalho especifica:

1. Abra `chrome://extensions`
2. Ative o modo Desenvolvedor
3. Clique em "Update"
4. Desative o modo Desenvolvedor em seguida

## Validacao Pos-Instalacao

Valide em pelo menos uma estacao de trabalho piloto:

<Tabs>
  <Tab title="Camada 1: Instalada">
    * Abra `chrome://extensions`
    * Confirme que **Telepatia Scribe Companion** aparece
    * Confirme que indica *Installed by your administrator*
    * Confirme que o usuario nao consegue desabilitar ou remover
  </Tab>

  <Tab title="Camada 2: ID Correto">
    * Em `chrome://extensions`, expanda os detalhes da extensao
    * Confirme que o **ID** e `fobdkddljbpmhnlclknlgcgbeeeojcnb`
    * Uma divergencia significa que o CRX ou a politica errada foi aplicada
  </Tab>

  <Tab title="Camada 3: Atualizacao automatica funciona">
    * Ative o modo Desenvolvedor, clique em "Update"
    * Ou valide a conectividade:

    ```powershell theme={null}
    Invoke-WebRequest -Uri https://cdn.telepatia.ai/scribe-extension/update-manifest.xml -UseBasicParsing
    ```

    * HTTP 200 = caminho aberto. Qualquer outra resposta = revise os requisitos de rede
  </Tab>
</Tabs>

## Operacoes Continuas

| Telepatia                                                           | Hospital                                                |
| ------------------------------------------------------------------- | ------------------------------------------------------- |
| Compilar, assinar e publicar novas versoes do CRX                   | Manter a configuracao da politica                       |
| Manter os endpoints do update-manifest                              | Manter o direcionamento de hosts/grupos                 |
| Notificar sobre mudancas de comportamento ou correcoes de seguranca | Manter conectividade HTTPS com `cdn.telepatia.ai`       |
| Agir em incidentes de distribuicao                                  | Reportar comportamento anomalo das estacoes de trabalho |
| Reverter via manifesto quando necessario                            | Monitorar propagacao apos mudancas de politica          |

## Suporte

Durante a instalacao, reporte comportamentos inesperados pelos canais acordados com a Telepatia. Para urgencias operacionais apos a implantacao (estacoes param de atualizar, comportamento anomalo), utilize os canais de suporte estabelecidos.