Manual de integração — Ruijie Reyee
O Ruijie Reyee oferece três modos de integração com o CaptiveWeb, dependendo de como os equipamentos são gerenciados. Escolha o modo correto ao cadastrar o equipamento no painel.
Modos de integração disponíveis
| Tipo no painel | Quando usar | Como autoriza |
|---|---|---|
RUIJIE_STANDALONE | AP/roteador sem nuvem, configurado localmente | Redirect via IP do AC/gateway + RADIUS |
RUIJIE_CLOUD | Equipamentos gerenciados pelo Reyee Cloud Portal | API Reyee Cloud para autorizar MAC do guest |
RUIJIE_RADIUS | Qualquer modo, usando só RADIUS padrão | RADIUS CoA (sem API de nuvem) |
Parâmetros RADIUS (todos os modos)
| Parâmetro | Valor |
|---|---|
| Servidor RADIUS (Auth) | 45.234.216.27 |
| Porta Auth | 1812 |
| Porta Accounting | 1813 |
| Shared Secret | Copie em Equipamentos → seu equipamento → Configuração RADIUS |
O passo-a-passo abaixo foi homologado com o Ruijie Reyee (linha EG/RG, ex.: EG310GH-P-E) em modo standalone pelo eWeb. Os mesmos valores valem para o Ruijie Cloud — configure os campos equivalentes na nuvem. Baixe sempre o arquivo de instruções em Equipamentos → seu equipamento → Baixar configuração: ele já traz a URL e o Shared Secret deste equipamento prontos para copiar.
A) Portal cativo externo — eWeb → Autenticação → Portal cativo
Defina o modo e o gateway
Modo: Externo. Dispositivo de autenticação: Gateway da Reyee. Protocolo de autenticação: WISPr. Rede/VLAN: a VLAN dos clientes (ex.: VLAN 147).
URL do servidor de autenticação (forma limpa)
Cole a URL exibida em Equipamentos → seu equipamento → Captive Link. Ela tem o formato
https://portal.captiveweb.com.br/public/portal-connect/ruijie-redirect/SUA_CHAVE— a chave vai no caminho, sem?key=, para evitar a URL malformada de alguns firmwares.Parâmetros de solicitação (autenticação externa)
Selecione Custom, método get. O campo "Val" é obrigatório — preencha com o texto literal
NULLem todas as linhas, conforme a tabela abaixo. Em Login Parameters: Name = username, Password = password, Post Url = next_url.Formato e tipo de autenticação
Formato de endereço MAC:
XXXXXXXXXXXX(sem separador). Tipo de autenticação: RADIUS. Criptografia RADIUS: PAP (não use CHAP). Grupo de servidores RADIUS: o configurado na seção B.
| Type | Key | Val |
|---|---|---|
client_mac | client_mac | NULL |
login_url | login_url | NULL |
client_ip | client_ip | NULL |
ssid | ssid | NULL |
nas_mac | nas_mac | NULL |
B) Servidor RADIUS — eWeb → grupo de servidores
- IP do servidor RADIUS:
45.234.216.27 - Porta de autenticação:
1812· Porta de accounting:1813· Accounting: ligado - Shared Secret: os 32 caracteres deste equipamento — copie em Equipamentos → seu equipamento → Configuração RADIUS (ou direto no arquivo de instruções)
- NAS-Identifier: opcional (o tenant é resolvido pela chave no caminho/IP)
C) Walled Garden — liberar antes do login
Libere o acesso a estes destinos antes da autenticação: portal.captiveweb.com.br, o IP do servidor RADIUS (45.234.216.27) e o DNS.
Modo RUIJIE_CLOUD — gerenciado pelo Reyee Cloud
Cadastre o equipamento como RUIJIE_CLOUD
Em Equipamentos → Novo equipamento, selecione tipo RUIJIE_CLOUD.
Configure os mesmos campos na nuvem
No painel do Reyee Cloud, configure o Portal cativo externo (seção A), o servidor RADIUS (seção B) e o Walled Garden (seção C) com os mesmos valores.
login_url informado pelo gateway. O usuário não precisa reconectar — o acesso libera automaticamente.RUIJIE_RADIUS, a configuração é idêntica — RADIUS (seção B) + redirect (seção A). A diferença é que o CaptiveWeb usa apenas CoA RADIUS para reativar sessões, sem API de nuvem.Modelos compatíveis
| Série / Modelo | Descrição |
|---|---|
| RG-EW1800GX PRO | Roteador Wi-Fi 6 AX1800 — residencial/SOHO |
| RG-EW3000GX PRO | Roteador Wi-Fi 6 AX3000 com 4 portas Gigabit |
| RG-EW3200GX PRO | Roteador Wi-Fi 6 AX3200 com porta 2.5G WAN |
| RG-NBS3100-8GT2SFP-P | Switch PoE gerenciável com AC integrado |
| RG-RAP1200(P) | AP Wi-Fi 5 dual-band PoE, teto/parede |
| RG-RAP2200(E) | AP Wi-Fi 5 dual-band para área empresarial |
| RG-RAP2260(G) | AP Wi-Fi 6 AX1800 indoor |
| RG-RAP6262(G) | AP Wi-Fi 6 AX1800 de alto desempenho |
| RG-RAP6260(G) | AP Wi-Fi 6 tri-band AX3000 |
| RG-RAP62-OD | AP Wi-Fi 6 AX3000 outdoor IP65, –30 °C a +65 °C, PoE 802.3af/at. Recomendado com RUIJIE_CLOUD ou RUIJIE_STANDALONE. RADIUS CoA não suportado (ReyeeOS). |
RUIJIE_STANDALONE, RUIJIE_CLOUD e RUIJIE_RADIUS funcionam com qualquer AP Ruijie Reyee. A escolha depende de como o equipamento é gerenciado. Para o modelo RG-RAP62-OD (outdoor), evite RUIJIE_RADIUS puro pois o ReyeeOS não suporta CoA.Esse artigo foi útil?
Obrigado pelo feedback! ✅