# Portal white-label con dominio propio

El modulo white-label permite que tus clientes accedan al portal de documentos y declaraciones bajo tu propio dominio (ej: `clientes.tuasesoria.es`) en lugar del dominio generico de Frihet. Esto refuerza la imagen de marca de tu gestoria y mejora la confianza del cliente.

Esta funcionalidad esta disponible en plan **Gestoria Pro**.

## Como funciona

Frihet proporciona la infraestructura (servidores, SSL, CDN) mientras tu aportas el dominio y la identidad visual. El proceso completo tarda menos de 5 minutos mas el tiempo de propagacion DNS (tipicamente 15-60 minutos).

## Asistente de configuracion de dominio

1. Ve a **Configuracion** → **Gestoria** → **Dominio personalizado**.
2. Introduce el subdominio que quieres usar. Recomendamos usar un subdominio (ej: `clientes.tuasesoria.es`), no el dominio raiz.
3. El asistente te muestra las instrucciones DNS especificas para tu dominio.

## Configuracion DNS — instrucciones CNAME

En el panel de tu proveedor de DNS (Cloudflare, GoDaddy, OVH, IONOS, etc.), crea el siguiente registro:

```
Tipo:    CNAME
Nombre:  clientes          (o el subdominio que hayas elegido)
Valor:   portal.frihet.io
TTL:     Auto / 3600
```

:::warning Dominio raiz (apex)
Si quieres usar el dominio raiz (ej: `tuasesoria.es` sin subdominio), debes usar un registro **ALIAS** o **ANAME** en lugar de CNAME. No todos los proveedores DNS soportan este tipo. En ese caso, recomendamos usar un subdominio como `portal.tuasesoria.es`.
:::

### Instrucciones por proveedor DNS popular

**Cloudflare:**

```
DNS → Add record → Type: CNAME → Name: clientes → Target: portal.frihet.io → Proxy: OFF (nube gris)
```

Importante: desactiva el proxy (nube naranja → nube gris) para que Frihet pueda gestionar el SSL.

**GoDaddy:**

```
DNS → Manage → Add → Type: CNAME → Host: clientes → Points to: portal.frihet.io → TTL: 1 hora
```

**IONOS (1&1):**

```
Dominios → Subdominos → Crear subdominio: clientes → Tipo: CNAME → Apunta a: portal.frihet.io
```

## Provision SSL automatica

Una vez que el CNAME propaga correctamente, Frihet detecta la configuracion y emite automaticamente un certificado SSL/TLS via **Let's Encrypt**. El proceso tarda entre 2 y 10 minutos tras la propagacion DNS.

El estado del SSL es visible en **Configuracion** → **Gestoria** → **Dominio personalizado**:

- Pendiente DNS: esperando propagacion del CNAME
- Emitiendo SSL: certificado en proceso (2-10 min)
- Activo: tu dominio esta funcionando con HTTPS
- Error: ver seccion de gotchas

El certificado se renueva automaticamente cada 90 dias — no necesitas hacer nada.

## Personalizacion de marca

Con el dominio activo, personaliza el portal en **Configuracion** → **Gestoria** → **Marca**:

| Elemento                      | Personalizable                     |
| ----------------------------- | ---------------------------------- |
| Logo (cabecera)               | Si — PNG/SVG, max 2MB              |
| Colores primario y secundario | Si — selector hex                  |
| Nombre de la gestoria         | Si — aparece en pie y emails       |
| Favicon                       | Si — ICO/PNG 32x32                 |
| Mensaje de bienvenida         | Si — texto libre, soporte Markdown |
| Correo de soporte al cliente  | Si — aparece en pie de pagina      |

Los colores y logo se aplican tambien a los **emails automaticos** enviados a tus clientes (notificaciones de declaracion lista, solicitudes de documentacion).

## Verificar que todo funciona

Tras la activacion, comprueba:

1. Accede a `https://clientes.tuasesoria.es` desde un navegador en modo incognito.
2. Verifica que el candado SSL esta activo (HTTPS verde).
3. Verifica que aparece tu logo y colores.
4. Accede con las credenciales de un cliente de prueba.

## Multiples portales (multi-marca)

Si gestionas varias marcas o lineas de negocio bajo la misma cuenta Frihet, puedes configurar hasta **3 dominios personalizados** en el plan Gestoria Pro. Cada dominio puede tener su propio logo y paleta de colores, pero comparten la base de datos de clientes de Frihet.

Para portales completamente separados (datos aislados), contacta a soporte para explorar la opcion de **instancias multi-tenant**.

## Gotchas

- **Propagacion DNS lenta**: en algunos proveedores DNS la propagacion puede tardar hasta 48h. Comprueba la propagacion en [dnschecker.org](https://dnschecker.org) antes de contactar a soporte.
- **Cloudflare con proxy activo**: si dejas el proxy de Cloudflare activo (nube naranja), Frihet no puede verificar el dominio y el SSL no se emite. Usa nube gris para este subdominio.
- **Certificado SSL bloqueado por CAA**: si tu dominio tiene registros CAA restrictivos, anade `letsencrypt.org` como CA autorizada.
- **Dominio ya usado**: cada dominio/subdominio solo puede apuntar a un portal Frihet. Si ya lo tienes configurado en otra cuenta, deberas quitarlo primero.
- **Email en el mismo dominio**: si usas `@tuasesoria.es` para correo, el registro CNAME del subdominio no afecta al correo — son registros independientes.

## Relacionado

- [Modulo Gestoria — resumen](./gestoria)
- [Self-onboard de clientes VIES](./gestoria-self-onboard)
- [App movil gestoria](./gestoria-movil)
- [Notificaciones a clientes](../configuracion/notificaciones)