FONTE: https://github.com/intera-net-br/uisp-extension

Essa extensão é bem simples, não faz sequer tratamento de erros.

Se o IP estiver cadastrado no UISP, ele tenta gerar um ticket para fazer login.

Configure a URL e um token de acesso.

Na URL, finalize com /nms/api/v2.1

A partir da versão 1.2, um assistente de IA com acesso ao navegador consegue entrar nos equipamentos quando você pede, por exemplo, "entra no rádio 10.0.0.5". A integração é feita por uma skill no formato aberto SKILL.md.

Instruções e skill: https://intera-net-br.github.io/uisp-extension/

Como funciona:

1. A skill uisp-login manda o assistente abrir a página do equipamento (https://IP/) e, a partir dela, navegar para https://intera-net-br.github.io/uisp-extension/login.html#IP (pasta docs/, publicada no GitHub Pages). O IP vai depois do #, que o navegador não envia ao GitHub.
2. A extensão (content.js, que só roda nessa página) confere o referrer: se a navegação partiu do próprio equipamento (host do referrer igual ao IP), segue sozinha. Nenhum outro site consegue produzir esse referrer. Nos demais casos, mostra o botão "Entrar em IP", que só aceita clique real (event.isTrusted). Nada funciona dentro de iframe.
3. O background.js busca o IP no UISP, exige correspondência exata, gera o ticket e redireciona a aba para o IP devolvido pelo UISP.

O login.html registra um service worker (docs/sw.js) que guarda uma cópia local da página. Depois da primeira visita (feita ao clicar em "Preparar uso por assistente de IA"), a página abre mesmo com o GitHub fora e a navegação, que leva o referrer do equipamento, não sai do navegador. A cópia é atualizada no máximo uma vez por dia, sem referrer. Além disso, ao abrir a página o próprio navegador confere se o sw.js mudou; com updateViaCache: "all" essa checagem respeita o cache HTTP do GitHub Pages (10 minutos) e não leva o IP do equipamento (testado: o Referer é o próprio sw.js). Assim o GitHub pode perceber que a página foi aberta e em que horário, mas não em qual equipamento. Sem a cópia local (janela anônima, dados do navegador apagados), a página vem da rede e o GitHub recebe o IP do equipamento no cabeçalho Referer.

O token nunca sai da extensão: nem a página nem o assistente têm acesso a ele.

Nenhuma permissão nova é necessária: a extensão chama o UISP pelo mesmo CORS que a versão 1.1 já usava. Para já deixar a cópia local pronta, abra o popup e clique em Preparar uso por assistente de IA. O clique direito funciona igual à versão 1.1.

Instalação da skill: use o uisp-login-skill.zip da última release ou o SKILL.md conforme o seu assistente. Ferramentas que aceitam marketplace de plugins no formato .claude-plugin podem instalar direto deste repositório (ex.: /plugin marketplace add intera-net-br/uisp-extension e /plugin install uisp-login@uisp-extension).

A fonte da skill é plugin/skills/uisp-login/SKILL.md. Depois de alterá-la, rode scripts/build.sh para atualizar a cópia em docs/.

Gere os arquivos localmente e publique a release pelo gh (ou pela página Releases › Draft a new release do GitHub, arrastando os arquivos de dist/):

scripts/build.sh
git tag v1.2.1 && git push origin v1.2.1
gh release create v1.2.1 dist/*.zip --title v1.2.1 --generate-notes

Para trocar os arquivos de uma release existente: gh release upload v1.2.1 dist/*.zip --clobber.

Arquivos gerados em dist/:

• uisp-login-skill.zip: a skill para assistentes de IA;
• uisp-extension-chrome.zip: a extensão para Chrome. Para instalar sem a loja, descompacte e use chrome://extensions › Modo do desenvolvedor › Carregar sem compactação;
• uisp-extension-firefox.zip: a extensão para Firefox, sem assinatura. Sem a loja, só carrega temporariamente em about:debugging › Este Firefox › Carregar extensão temporária. É também o pacote enviado à AMO.

Só localmente (não vai para a release):

• uisp-extension-chrome.crx: o pacote enviado à Chrome Web Store. A loja usa uploads verificados: só aceita .crx assinado com a chave uisp_extension.pem (cadastrada no painel). O scripts/build.sh gera esse arquivo quando encontra a chave na raiz do projeto, ou no caminho da variável UISP_PEM, e o Chrome instalado. O comando usado é equivalente a:

  google-chrome --pack-extension=chrome --pack-extension-key=uisp_extension.pem

  A chave nunca vai para o Git (*.pem está no .gitignore). Guarde uma cópia em lugar seguro: sem ela não é possível publicar no Chrome até o suporte do Google redefinir a chave.

Mantenha esses nomes: os links da página usam releases/latest/download/<nome>, que sempre aponta para a release mais recente.

Para uso normal, prefira instalar pelas lojas (links no topo).

Para publicar a página: Settings › Pages › Deploy from branch › main /docs.

1. Validar a configuração no popup e mostrar erros
   • Ao salvar, exigir https:// (ou http://) e o final /nms/api/v2.1, mostrando erro em vez de salvar (ex.: ttps:// salvo por engano causou "Failed to fetch").
   • Botão "Testar conexão": chama o UISP com o token e mostra OK ou o erro exato (URL errada, token inválido, UISP fora).
   • Mostrar no clique direito os erros que hoje só aparecem no console (aviso no ícone da extensão ou faixa na página).
2. Trampolim mais rápido (~0,4 s): o content.js iniciar o login assim que a página abre (run_at: document_start), sem esperar o carregamento completo.
3. Verificar o certificado do equipamento pelo MAC: o certificado de fábrica da Ubiquiti tem CN=UBNT-<MAC>, e o UISP conhece o MAC de cada equipamento; comparar os dois confirma que o certificado é daquele rádio.
4. Salvar a senha do rádio no vault do UISP (substitui "abrir o cofre" e "salvar senha do Device")
   • Fluxo pelo clique direito: o técnico digita usuário e senha no login do airOS, escolhe "Entrar e salvar senha no UISP", confirma, e a extensão só envia ao vault depois que o login deu certo. A senha nunca é guardada na extensão e a função fica fora da skill dos assistentes.
   • Rotas encontradas na API do UISP: POST /vault/credentials/unlock (abrir o cofre), POST /vault/credentials, GET /vault/{deviceId}/credentials, POST /vault/{deviceId}/credentials/change e /regenerate. Confirmar os campos de cada uma antes de implementar.
   • Atenção: um token com acesso ao vault consegue ler a senha de todos os rádios (GET /vault/{deviceId}/credentials). Usar um usuário do UISP só com permissão de gravação, se o UISP permitir separar.
5. Login no UISP por sessão (opcional) (substitui "trabalhar com a senha e não com token"): o usuário entra com usuário e senha do UISP uma vez por sessão do navegador; a senha não é salva e o token temporário fica só na memória (storage.session). O token fixo continua disponível para quem preferir.
6. Equipamento não encontrado no UISP (substitui "configurar o UISP se estiver desconfigurado"): incluir no erro um link para a tela do UISP onde se adiciona o equipamento.

Descartado (2026-10):

• Eliminar o aviso de certificado dos rádios: o proxy do UISP (/devices/{id}/remoteuiproxy) não funciona com airMax, e o airOS 8.7.25 não aceita certificado próprio pela interface. O aviso é aceito uma vez por rádio.
• Levar o clique direito para o background para remover activeTab e scripting: ganho pequeno, e o fluxo do vault (item 4) vai precisar dessas permissões.
• Guardar no cache da extensão o IP→equipamento: ganharia ~1,3 s, mas arrisca mandar o ticket para um IP desatualizado.

UISP Extension

Extension to interact with UISP API.

This extension is intended to facilitate passwordless login, requiring only a right-click and a click on the context menu to open all devices connected to the UISP.

It can also be used by AI assistants with browser access, through the "uisp-login" skill: https://intera-net-br.github.io/uisp-extension/

Free and open source software (GPL-3.0): https://github.com/intera-net-br/uisp-extension

Legal Notice: This extension is an independent, user-developed tool created solely to simplify access to device redirect tickets. It is not affiliated with, endorsed by, or associated with Ubiquiti Inc. or any of its products or services. All trademarks and product names mentioned herein are the property of their respective owners.

Ferramenta

Português (Brasil)

Allows you to log in without a password, simply by clicking on the context menu. A UISP ticket will be used. Allow the user to generate a UISP redirect ticket for the currently opened device page. It performs this action only when the user explicitly selects the extension’s context-menu option, or clicks the "Log in" button on the extension's login page. The extension does not provide any additional features beyond generating the ticket and redirecting the user to the device’s ticket URL.

Used to locally save two configuration values (Base URL, Token) provided by the user. These values are stored only on the user’s device and are not sent anywhere.

Required to allow the extension to access the content of the currently active tab and only after the user interacts with the extension.

Required to add an item to the browser’s right-click menu. The extension only performs actions when the user selects this menu item.

Required to inject a small script into the current page, but only after the user triggers the action. The script is used to read the current URL or execute simple logic requested by the user. No data is collected or transmitted.

The only host access the extension declares. The content script runs only on the extension's own page https://intera-net-br.github.io/uisp-extension/, published from the open source repository. There, the user or an AI assistant with browser access can request a UISP login ticket for a device IP: automatically when the navigation comes from that device's own page, otherwise after a real click on a button. The UISP API token is never exposed to the page. Calls to the UISP API are made by the background script using the CORS headers of the UISP server (same as version 1.1), with no host permission.

npm install --global web-ext
cd /caminho/para/sua/extensao
web-ext lint

web-ext build

Isso gera a pasta web-ext-artifacts e dentro dela o arquivo <extensão>-<versão>.zip

Crie sua chave de API: https://addons.mozilla.org/pt-BR/developers/addon/api/key/

web-ext sign --channel listed --amo-metadata amo-metadata.json --approval-timeout 0

As chaves vão nas variáveis WEB_EXT_API_KEY e WEB_EXT_API_SECRET (nunca no repositório). O amo-metadata.json define a licença e a nota para o revisor:

{
  "version": {
    "license": "GPL-3.0-only",
    "approval_notes": "Source code: https://github.com/intera-net-br/uisp-extension (GPL-3.0). No build step, files are not minified."
  }
}

A AMO não aceita GPL-3.0-or-later; o identificador é GPL-3.0-only.

GPL-3.0. Projeto independente, sem relação com a Ubiquiti Inc.