# Domínio

> Os endereços da sua plataforma e como usar um domínio próprio: o registro CNAME, a ativação, o certificado e o que cada status quer dizer.

Toda conta tem um endereço da Cademí. Ela também pode ter um domínio próprio, como cursos.suamarca.com.br, para os alunos entrarem com a sua marca. Em **Configurações > Domínio** você vê os endereços da conta, cadastra o domínio próprio e ativa o certificado.

## A ideia em um minuto

Três peças fazem o domínio próprio funcionar:

- O **endereço principal** é o endereço para onde a plataforma leva o aluno.
- O **registro CNAME** é o que você cria no seu provedor de DNS. Ele aponta o seu domínio para a Cademí.
- O **certificado** é o cadeado do navegador (https). A Cademí pede o certificado depois de conferir o CNAME.

**A regra mais importante:** o domínio próprio só vira o endereço principal quando o status dele é **Ativo**. Antes disso, os alunos continuam no endereço da Cademí.

## Os endereços da plataforma

A seção **Endereços da plataforma** mostra os três endereços pelos quais a plataforma abre:

| Endereço | O que é |
|---|---|
| **Chave da plataforma** | O endereço padrão, criado sozinho quando a plataforma nasce. Sempre funciona |
| **Subdomínio** | Um endereço mais curto na Cademí, opcional. Para definir ou mudar, fale com o suporte |
| **Domínio Customizado** | O seu domínio, quando cadastrado, com o status atual ao lado |

Os endereços da Cademí funcionam sempre. Quem entra por eles é levado ao endereço principal. O principal é o de maior prioridade entre os que existem, nesta ordem: **Domínio Customizado** (só quando está **Ativo**), depois **Subdomínio**, depois **Chave da plataforma**.

O fluxo abaixo mostra qual endereço é o principal e o que acontece com quem entra por outro:

```mermaid
flowchart TD
    accTitle: Qual endereço é o principal
    accDescr: Quando o aluno abre um endereço da plataforma, o principal é o Domínio Customizado se ele estiver Ativo; senão, o Subdomínio, se houver; senão, a Chave da plataforma. Quem entrou pelo principal vê a plataforma direto; quem entrou por outro endereço é redirecionado para o principal.
    acesso["Aluno abre um endereço da plataforma"]
    custom{"Domínio Customizado Ativo?"}
    sub{"Tem Subdomínio?"}
    pc["Principal: Domínio Customizado"]
    ps["Principal: Subdomínio"]
    pk["Principal: Chave da plataforma"]
    mesmo{"Entrou pelo principal?"}
    redir["Redireciona para o principal"]
    abre["Plataforma abre"]
    acesso --> custom
    custom -->|Sim| pc
    custom -->|Não| sub
    sub -->|Sim| ps
    sub -->|Não| pk
    pc --> mesmo
    ps --> mesmo
    pk --> mesmo
    mesmo -->|Sim| abre
    mesmo -->|Não| redir
    redir --> abre
    classDef destaque stroke:#ff005c,stroke-width:2px
    class redir destaque
```

Nenhum endereço deixa de funcionar: o que muda é para onde o aluno é levado. Um domínio cadastrado que ainda não chegou a **Ativo** não é o principal.

O domínio próprio precisa ser um subdomínio, como cursos.suamarca.com.br ou membros.suamarca.com.br. Um domínio raiz (suamarca.com.br) não é aceito. Cada domínio só pode estar em uma conta.

## Os status do domínio

| Status | O que quer dizer |
|---|---|
| **Inativo** | Nenhum domínio próprio cadastrado |
| **Processando** | O domínio foi salvo e espera a ativação, ou o certificado está sendo emitido |
| **Inválido** | O registro CNAME não foi encontrado no DNS |
| **Apontamento Inválido** | O registro existe, mas não aponta para core.cademi.com.br |
| **Verificado** | O apontamento está certo; falta pedir o certificado |
| **Ativo** | Domínio funcionando, com certificado |

Do cadastro ao **Ativo**, o domínio passa por estes status:

```mermaid
stateDiagram-v2
    accTitle: Os status do domínio próprio
    accDescr: Sem domínio, o status é Inativo. Ao salvar o domínio, ele fica Processando, na fila. Ativar agora confere o CNAME: sem registro, o status é Inválido; com o registro apontando para outro lugar, Apontamento Inválido; com o registro certo, Verificado. Dos dois erros e do Verificado, Ativar agora confere de novo. Do Verificado, o certificado é pedido e o status fica Processando, com o certificado sendo emitido. Com o certificado pronto, o status é Ativo.
    state "Inativo" as Inativo
    state "Processando (na fila)" as Fila
    state checa <<choice>>
    state "Inválido" as Invalido
    state "Apontamento Inválido" as Apontamento
    state "Verificado" as Verificado
    state "Processando (certificado)" as Emitindo
    state "Ativo" as Ativo
    [*] --> Inativo
    Inativo --> Fila: Salvar agora
    Fila --> checa: Ativar agora
    Invalido --> checa: Ativar agora
    Apontamento --> checa: Ativar agora
    checa --> Invalido: CNAME não encontrado
    checa --> Apontamento: Aponta para outro lugar
    checa --> Verificado: CNAME certo
    Verificado --> Emitindo: Certificado pedido
    Verificado --> checa: Ativar agora
    Emitindo --> Ativo: Certificado pronto
```

Os dois **Processando** aparecem iguais na tela. No primeiro, o botão é **Ativar agora**. No segundo, é **Verificar certificado**. Se o certificado já sai pronto ao ativar, o domínio vai direto a **Ativo**. **Redefinir Domínio** volta a **Inativo** a partir de qualquer status.

## Passo a passo

### Cadastrar o domínio

1. No painel, abra **Configurações > Domínio**.
2. Em **Domínio Customizado**, digite o subdomínio que os alunos vão usar. Por exemplo: cursos.suamarca.com.br.
3. Clique em **Salvar agora**.

O status passa a **Processando**. A tela mostra o botão **Ativar agora**.

### Criar o registro no seu provedor de DNS

O provedor de DNS é onde o seu domínio foi registrado ou está hospedado.

1. Abra o painel do seu provedor de DNS.
2. Crie o registro que a seção **Apontamento DNS** mostra: **Tipo** CNAME, nome igual ao subdomínio (cursos) e **Aponta para** core.cademi.com.br.
3. Para não errar o destino, use o botão de copiar da tela.
4. Espere a propagação do DNS.

A propagação depende do seu provedor. Ela pode levar de minutos a horas.

**Atenção: é aqui que mais acontece erro.** O Marcos usa a Cloudflare e cria o CNAME com a nuvem laranja (proxy) ligada. A verificação não encontra o CNAME, e o status fica em **Apontamento Inválido**. Para evitar isso, desligue o proxy ou a CDN do provedor nesse registro. A verificação procura um registro CNAME puro, apontando para core.cademi.com.br.

### Ativar o domínio

1. Volte ao painel e clique em **Ativar agora**.
2. Confirme em **Continuar**.

A plataforma confere o CNAME e pede o certificado SSL. Se o apontamento está certo, a mensagem é "CNAME verificado! O certificado SSL está sendo emitido e será ativado em instantes." O status fica **Processando**.

### Conferir o certificado

Enquanto o certificado é emitido, a tela mostra o botão **Verificar certificado**.

1. Clique em **Verificar certificado**.

Quando o certificado fica pronto, o status vira **Ativo** e a mensagem é "Domínio ativado com sucesso!". Se o certificado já sai pronto ao ativar, o status vai direto para **Ativo**.

### Se a verificação falhar

A mensagem diz o motivo, e o status mostra o diagnóstico:

- **Inválido**: o registro não foi encontrado. O DNS ainda não propagou, ou o registro foi criado com outro nome.
- **Apontamento Inválido**: o registro aponta para outro lugar.

Corrija no provedor, espere a propagação e clique em **Ativar agora** de novo.

## O que muda com o domínio ativo

- Os e-mails que a Cademí envia ao aluno passam a usar o seu domínio: o link de acesso e o botão de entrar com um clique.
- Quem entra pelos endereços da Cademí é levado ao seu domínio. Links antigos continuam funcionando.
- A **URL de Postback** das entregas continua no endereço da Cademí ([Entregas](https://help.cademi.cloud/pt/vendas/entregas.md)). Trocar ou redefinir o domínio não afeta as vendas que chegam dos gateways.

## Redefinir

Com um domínio cadastrado, o botão **Redefinir Domínio** apaga o cadastro. O status volta para **Inativo**. A área do aluno volta a usar o domínio Cademí, e o acesso pelo domínio customizado para. Essa ação não pode ser desfeita. Para usar o domínio de novo, cadastre-o outra vez e repita a ativação.

## Bom saber

- **O registro tem de ser um CNAME puro.** A verificação procura, no DNS, um registro CNAME apontando para core.cademi.com.br. Se o seu provedor tem proxy ou CDN sobre o registro (a nuvem laranja da Cloudflare, por exemplo), desligue nesse registro. Com o proxy ligado, a verificação não encontra o CNAME e o status fica em **Apontamento Inválido**.
- **Só subdomínio.** Para suamarca.com.br levar à plataforma, crie no seu provedor um redirecionamento do domínio raiz para o subdomínio cadastrado.
- **Domínio já em uso.** Um domínio cadastrado em outra conta Cademí não pode ser salvo nem ativado nesta. A mensagem é "O domínio fornecido já está em uso".
- **Certificado parado em Processando.** Clique em **Verificar certificado** de novo depois de alguns minutos. Se continuar assim, confira no provedor se alguma regra impede a emissão de certificados para o domínio. Depois, fale com o suporte.
- **Clone.** Um clone nasce sem o domínio da conta de origem e pode cadastrar o próprio.

## Perguntas frequentes

**Posso usar meu domínio principal, sem subdomínio?** Não. A plataforma só aceita subdomínios, como cursos.suamarca.com.br. No seu provedor, aponte o domínio raiz para o subdomínio cadastrado.

**Criei o CNAME e deu Inválido.** O DNS ainda não propagou, ou o nome do registro não é o mesmo que você cadastrou. Confira o nome, espere e clique em **Ativar agora** de novo.

**Uso a Cloudflare e o status ficou em Apontamento Inválido.** O proxy está ligado no registro. Desligue a nuvem laranja nesse registro e clique em **Ativar agora** de novo.

**Cadastrei o domínio e os alunos continuam no endereço da Cademí.** O domínio só vira o principal no status **Ativo**. Confira o status e termine a ativação.

**Vou trocar de domínio. Perco alguma coisa?** Não. Redefina o domínio atual e cadastre o novo. Os endereços da Cademí continuam funcionando no meio do caminho, e as entregas não dependem do domínio próprio.