# Dominio

> Las direcciones de tu plataforma y cómo usar un dominio propio: el registro CNAME, la activación, el certificado y qué quiere decir cada estado.

Toda cuenta tiene una dirección de Cademí. También puede tener un dominio propio, como cursos.tumarca.com, para que los alumnos entren con tu marca. En **Configuraciones > Dominio** ves las direcciones de la cuenta, registras el dominio propio y activas el certificado.

## La idea en un minuto

Tres piezas hacen funcionar el dominio propio:

- La **dirección principal** es la dirección a la que la plataforma lleva al alumno.
- El **registro CNAME** es lo que creas en tu proveedor de DNS. Apunta tu dominio a Cademí.
- El **certificado** es el candado del navegador (https). Cademí pide el certificado después de revisar el CNAME.

**La regla más importante:** el dominio propio solo se vuelve la dirección principal cuando su estado es **Activo**. Mientras tanto, los alumnos siguen en la dirección de Cademí.

## Las direcciones de la plataforma

La sección **Direcciones de la plataforma** muestra las tres direcciones por las que abre la plataforma:

| Dirección | Qué es |
|---|---|
| **Clave de la plataforma** | La dirección predeterminada, creada sola cuando nace la plataforma. Siempre funciona |
| **Subdominio** | Una dirección más corta en Cademí, opcional. Para definirla o cambiarla, habla con el soporte |
| **Dominio Personalizado** | Tu dominio, cuando está registrado, con el estado actual al lado |

Las direcciones de Cademí funcionan siempre. Quien entra por ellas va a la dirección principal. La principal es la de mayor prioridad entre las que existen, en este orden: **Dominio Personalizado** (solo cuando está **Activo**), después **Subdominio**, después **Clave de la plataforma**.

El flujo de abajo muestra cuál dirección es la principal y qué pasa con quien entra por otra:

```mermaid
flowchart TD
    accTitle: Cuál dirección es la principal
    accDescr: Cuando el alumno abre una dirección de la plataforma, la principal es el Dominio Personalizado si está Activo; si no, el Subdominio, si existe; si no, la Clave de la plataforma. Quien entró por la principal ve la plataforma directo; quien entró por otra dirección es redirigido a la principal.
    acesso["El alumno abre una dirección de la plataforma"]
    custom{"¿Dominio Personalizado Activo?"}
    sub{"¿Tiene Subdominio?"}
    pc["Principal: Dominio Personalizado"]
    ps["Principal: Subdominio"]
    pk["Principal: Clave de la plataforma"]
    mesmo{"¿Entró por la principal?"}
    redir["Redirige a la principal"]
    abre["La plataforma abre"]
    acesso --> custom
    custom -->|Sí| pc
    custom -->|No| sub
    sub -->|Sí| ps
    sub -->|No| pk
    pc --> mesmo
    ps --> mesmo
    pk --> mesmo
    mesmo -->|Sí| abre
    mesmo -->|No| redir
    redir --> abre
    classDef destaque stroke:#ff005c,stroke-width:2px
    class redir destaque
```

Ninguna dirección deja de funcionar: lo que cambia es a dónde se lleva al alumno. Un dominio registrado que todavía no llegó a **Activo** no es el principal.

El dominio propio tiene que ser un subdominio, como cursos.tumarca.com o miembros.tumarca.com. Un dominio raíz (tumarca.com) no se acepta. Cada dominio solo puede estar en una cuenta.

## Los estados del dominio

| Estado | Qué quiere decir |
|---|---|
| **Inactivo** | Ningún dominio propio registrado |
| **Procesando** | El dominio se guardó y espera la activación, o el certificado se está emitiendo |
| **Inválido** | El registro CNAME no se encontró en el DNS |
| **Apuntamiento inválido** | El registro existe, pero no apunta a core.cademi.com.br |
| **Verificado** | El apuntamiento está bien; falta pedir el certificado |
| **Activo** | Dominio funcionando, con certificado |

Desde el registro hasta **Activo**, el dominio pasa por estos estados:

```mermaid
stateDiagram-v2
    accTitle: Los estados del dominio propio
    accDescr: Sin dominio, el estado es Inactivo. Al guardar el dominio, queda Procesando, en la cola. Activar ahora revisa el CNAME: sin registro, el estado es Inválido; con el registro apuntando a otro lugar, Apuntamiento inválido; con el registro correcto, Verificado. Desde los dos errores y desde Verificado, Activar ahora revisa de nuevo. Desde Verificado, se pide el certificado y el estado queda Procesando, con el certificado en emisión. Con el certificado listo, el estado es Activo.
    state "Inactivo" as Inativo
    state "Procesando (en cola)" as Fila
    state checa <<choice>>
    state "Inválido" as Invalido
    state "Apuntamiento inválido" as Apontamento
    state "Verificado" as Verificado
    state "Procesando (certificado)" as Emitindo
    state "Activo" as Ativo
    [*] --> Inativo
    Inativo --> Fila: Guardar ahora
    Fila --> checa: Activar ahora
    Invalido --> checa: Activar ahora
    Apontamento --> checa: Activar ahora
    checa --> Invalido: CNAME no encontrado
    checa --> Apontamento: Apunta a otro lugar
    checa --> Verificado: CNAME correcto
    Verificado --> Emitindo: Certificado pedido
    Verificado --> checa: Activar ahora
    Emitindo --> Ativo: Certificado listo
```

Los dos **Procesando** se ven iguales en la pantalla. En el primero, el botón es **Activar ahora**. En el segundo, es **Verificar certificado**. Si el certificado ya sale listo al activar, el dominio va directo a **Activo**. **Redefinir Dominio** vuelve a **Inactivo** desde cualquier estado.

## Paso a paso

### Registrar el dominio

1. En el panel, abre **Configuraciones > Dominio**.
2. En **Dominio Personalizado**, escribe el subdominio que van a usar los alumnos. Por ejemplo: cursos.tumarca.com.
3. Haz clic en **Guardar ahora**.

El estado pasa a **Procesando**. La pantalla muestra el botón **Activar ahora**.

### Crear el registro en tu proveedor de DNS

El proveedor de DNS es donde registraste o alojas tu dominio.

1. Abre el panel de tu proveedor de DNS.
2. Crea el registro que muestra la sección **Configuración DNS**: **Tipo** CNAME, nombre igual al subdominio (cursos) y **Apunta a** core.cademi.com.br.
3. Para no equivocarte en el destino, usa el botón de copiar de la pantalla.
4. Espera la propagación del DNS.

La propagación depende de tu proveedor. Puede tardar de minutos a horas.

**Atención: aquí es donde ocurren más errores.** Marcos usa Cloudflare y crea el CNAME con la nube naranja (proxy) activada. La verificación no encuentra el CNAME, y el estado queda en **Apuntamiento inválido**. Para evitarlo, desactiva el proxy o la CDN del proveedor en ese registro. La verificación busca un registro CNAME puro, que apunte a core.cademi.com.br.

### Activar el dominio

1. Vuelve al panel y haz clic en **Activar ahora**.
2. Confirma en **Continuar**.

La plataforma revisa el CNAME y pide el certificado SSL. Si el apuntamiento está bien, el mensaje es "¡CNAME verificado! El certificado SSL se está emitiendo y se activará en instantes." El estado queda **Procesando**.

### Revisar el certificado

Mientras se emite el certificado, la pantalla muestra el botón **Verificar certificado**.

1. Haz clic en **Verificar certificado**.

Cuando el certificado está listo, el estado pasa a **Activo** y el mensaje es "¡Dominio activado con éxito!". Si el certificado ya sale listo al activar, el estado va directo a **Activo**.

### Si la verificación falla

El mensaje dice el motivo, y el estado muestra el diagnóstico:

- **Inválido**: el registro no se encontró. El DNS todavía no se propagó, o el registro se creó con otro nombre.
- **Apuntamiento inválido**: el registro apunta a otro lugar.

Corrige en el proveedor, espera la propagación y haz clic en **Activar ahora** de nuevo.

## Qué cambia con el dominio activo

- Los correos que Cademí envía al alumno pasan a usar tu dominio: el enlace de acceso y el botón de entrar con un clic.
- Quien entra por las direcciones de Cademí va a tu dominio. Los enlaces antiguos siguen funcionando.
- La **URL de Postback** de las entregas sigue en la dirección de Cademí ([Entregas](/es/vendas/entregas)). Cambiar o redefinir el dominio no afecta las ventas que llegan de los gateways.

## Redefinir

Con un dominio registrado, el botón **Redefinir Dominio** borra el registro. El estado vuelve a **Inactivo**. El área del alumno vuelve a usar el dominio de Cademí, y el acceso por el dominio personalizado se detiene. Esta acción no se puede deshacer. Para usar el dominio de nuevo, regístralo otra vez y repite la activación.

## Para tener en cuenta

- **El registro tiene que ser un CNAME puro.** La verificación busca, en el DNS, un registro CNAME que apunte a core.cademi.com.br. Si tu proveedor tiene proxy o CDN sobre el registro (la nube naranja de Cloudflare, por ejemplo), desactívalo en ese registro. Con el proxy activado, la verificación no encuentra el CNAME y el estado queda en **Apuntamiento inválido**.
- **Solo subdominio.** Para que tumarca.com lleve a la plataforma, crea en tu proveedor una redirección del dominio raíz al subdominio registrado.
- **Dominio ya en uso.** Un dominio registrado en otra cuenta de Cademí no se puede guardar ni activar en esta. El mensaje es "El dominio proporcionado ya está en uso".
- **Certificado detenido en Procesando.** Haz clic en **Verificar certificado** de nuevo después de unos minutos. Si sigue igual, revisa en el proveedor si alguna regla impide emitir certificados para el dominio. Después, habla con el soporte.
- **Clon.** Un clon nace sin el dominio de la cuenta de origen y puede registrar el suyo.

## Preguntas frecuentes

**¿Puedo usar mi dominio principal, sin subdominio?** No. La plataforma solo acepta subdominios, como cursos.tumarca.com. En tu proveedor, apunta el dominio raíz al subdominio registrado.

**Creé el CNAME y salió Inválido.** El DNS todavía no se propagó, o el nombre del registro no es el mismo que registraste. Revisa el nombre, espera y haz clic en **Activar ahora** de nuevo.

**Uso Cloudflare y el estado quedó en Apuntamiento inválido.** El proxy está activado en el registro. Desactiva la nube naranja en ese registro y haz clic en **Activar ahora** de nuevo.

**Registré el dominio y los alumnos siguen en la dirección de Cademí.** El dominio solo se vuelve el principal en el estado **Activo**. Revisa el estado y termina la activación.

**Voy a cambiar de dominio. ¿Pierdo algo?** No. Redefine el dominio actual y registra el nuevo. Las direcciones de Cademí siguen funcionando mientras tanto, y las entregas no dependen del dominio propio.