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

# Controladora Omada

> Configuração de redes e hotspot na controladora Omada para integração com SenhaLivre.

## Sobre este Guia

Este guia explica como configurar a Omada Controller para criar redes Wi-Fi e configurar o portal cativo que redireciona visitantes para o SenhaLivre.

## Acesso à Controladora Omada

### Credenciais de Acesso

Acesse a interface web da sua Omada Controller usando as credenciais configuradas durante a instalação:

* **URL:** `https://<IP_OU_HOSTNAME_DA_CONTROLADORA>:<PORTA>`
* **Username:** (seu usuário configurado)
* **Password:** (sua senha configurada)

<Info>
  A porta padrão da Omada Controller geralmente é `8043` para HTTPS. Se você não souber o endereço da sua controladora, consulte a documentação da sua instalação ou verifique nas configurações de rede.
</Info>

## Adotar o AP na Controladora

### Passo 1: Localizar o AP

1. Na controladora Omada, acesse a seção de dispositivos
2. O AP deve aparecer como disponível para adoção

### Passo 2: Adotar o Equipamento

1. Selecione o AP na lista
2. Clique em **Adotar** ou **Adopt**
3. A adoção provavelmente falhará na primeira vez, tente adotar novamente inserindo as credenciais que você criou durante a configuração do AP.
   * **Username:** (o que você criou na Parte 1)
   * **Password:** (a senha criada na Parte 1)
4. Confirme a adoção

### Passo 3: Verificar Status

Após a adoção, o AP deve aparecer como online na controladora e estar pronto para uso.

## Criar Redes na Controladora

Você precisará criar a rede na qual seus clientes acessarão o seu Wi-Fi:

**Configuração:**

Em Settings->Wireless->WLan, voce poderá criar uma rede .....

* **Nome da rede:** Configure o SSID do hotspot
* **Tipo:** Rede pública/hotspot
* **Autenticação:** Portal cativo (será configurado com SenhaLivre)

<Warning>
  **Importante:** A rede do hotspot deve estar configurada como aberta (sem senha) para que o portal cativo funcione corretamente.
</Warning>

## Configurar Hotspot

Após criar as redes, configure o hotspot:

1. Acesse as configurações de hotspot na controladora
2. Configure o portal cativo
3. Defina as regras de autenticação
4. Configure o redirecionamento para o SenhaLivre

### Configuração do Portal Externo

Na Omada Controller, você precisa configurar o portal externo para apontar para o SenhaLivre:

1. Acesse **Settings → Hotspot** (ou **Configurações → Hotspot**)
2. Configure o **External Portal Server**:
   * **Portal Server URL:** `http://<SEU_DOMINIO_SENHALIVRE>/portal` (ou `https://` se usar HTTPS)
   * **Portal Type:** External Portal

<Info>
  Substitua `<SEU_DOMINIO_SENHALIVRE>` pelo domínio ou IP público do servidor onde o SenhaLivre está hospedado. Por exemplo: `http://senhalivre.com/portal` ou `http://meuservidor.com/portal`.
</Info>

### Status do Hotspot

Após a configuração, o hotspot estará funcional e pronto para receber visitantes. Porém, o ponto ainda não estará cadastrado no SenhaLivre — isso será feito na próxima etapa.

## Vídeo de Referência

Para visualizar o processo de configuração na controladora:

<Card title="Vídeo: Configuração na Controladora" icon="video" href="https://www.youtube.com/watch?v=H3FvWB87duw">
  Tutorial de configuração de redes e hotspot na controladora Omada
</Card>

## Testar o Portal

Após configurar tudo, teste o portal:

1. Conecte-se à rede Wi-Fi do hotspot (sem senha)
2. Abra um navegador e tente acessar qualquer site
3. Você deve ser redirecionado automaticamente para o portal do SenhaLivre
4. Complete o fluxo da campanha
5. Ao final, você deve ser autorizado e ter acesso à internet

<Note>
  Se o redirecionamento não funcionar, verifique:

  * Se o portal externo está configurado corretamente
  * Se a URL do servidor está correta
  * Se o firewall não está bloqueando as conexões
  * Se a rede Wi-Fi está configurada como aberta (sem senha)
</Note>

## Próximo Passo

Após configurar tudo na controladora, prossiga para:

* [Cadastro no SenhaLivre](/guia-instalacao/cadastro-senhalivre) — Adicionar o ponto de acesso ao sistema