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

# Modelo de Domínio do Sistema

> Define o formato do endereço que o painel cria para cada conta nova, o domínio do sistema, com o qual o cliente abre o site antes de ter um domínio próprio.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Modelos** >
**Modelo de Domínio do Sistema**

![Tela Modelo de Domínio do Sistema: a explicação dos espaços reservados e o campo com o esquema de fábrica](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/dominio-do-sistema.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=e690ba79acb601b994c7deb11c1cb13c)

1. Em **Esquema de Domínio do Sistema**, escreva o formato.
2. Clique em **Salvar**.

O painel responde *"As configurações foram atualizadas."*

O campo vem com `<USERNAME>.<PANEL_DOMAIN>` e é obrigatório. Os dois espaços
reservados, como a tela explica:

| Espaço reservado | Vira |
| - | - |
| `<USERNAME>` | o nome de usuário da conta |
| `<PANEL_DOMAIN>` | o domínio do painel, o mesmo de [Nome de Domínio](/keyhelp-admin/nome-de-dominio) |

Com o de fábrica, a conta `ana` num painel em `servidor.seuprovedor.com.br`
recebe `ana.servidor.seuprovedor.com.br`.

## Onde o esquema aparece

No formulário de [Criar uma conta de cliente](/keyhelp-admin/criar-conta-de-cliente),
na caixa **Criar domínio do sistema**, que vem marcada. O texto dela mostra o
esquema, e **mudou na hora** depois de salvar um esquema novo aqui. Com
`<USERNAME>.kb.<PANEL_DOMAIN>`, passou a dizer:

> Cria o domínio do sistema de acordo com o seguinte esquema:
> `<NOME DE USUÁRIO>.kb.servidor.seuprovedor.com.br`

**A conta criada depois recebe o esquema novo.** Medido criando uma conta com
`<USERNAME>.kb.<PANEL_DOMAIN>` salvo: ela nasceu com o domínio do sistema nesse
formato, e o site dela respondeu por esse endereço.

**Os domínios de sistema que já existem não mudam.** Conferido na lista de
domínios depois de trocar o esquema: os das contas antigas continuaram com o nome
de antes.

## O que o campo aceita

**Medido, salvando cada um:**

| Esquema | Resultado |
| - | - |
| `kb-<USERNAME>.<PANEL_DOMAIN>` | aceito |
| `<USERNAME>-kb.<PANEL_DOMAIN>` | aceito |
| `<USERNAME>.kb.<PANEL_DOMAIN>` | aceito |
| `<USERNAME>.exemplo.com.br`, sem o domínio do painel | aceito |
| `kb.<PANEL_DOMAIN>`, **sem o nome de usuário** | **aceito**, ver o aviso abaixo |
| `<USERNAME>`, sem ponto | recusado |
| `<USERNAME>_kb.<PANEL_DOMAIN>`, com sublinhado | recusado |
| `<USERNAME> kb.<PANEL_DOMAIN>`, com espaço | recusado |
| `<username>.<panel_domain>`, marcadores em minúsculas | recusado |
| vazio | o navegador não deixa salvar |

A recusa é sempre a mesma: *"Entrada inválida no campo Esquema de Domínio do
Sistema."*, e o campo volta com o esquema que estava gravado.

> [!WARNING]
>
> **O painel aceita um esquema sem `<USERNAME>`**
>
> Com `kb.<PANEL_DOMAIN>` salvo, o formulário de conta mostrou o mesmo endereço,
> `kb.servidor.seuprovedor.com.br`, para qualquer nome de usuário: conferido
> escrevendo dois nomes diferentes.
>
> **Medido criando duas contas com um esquema fixo:** a primeira ganhou o
> endereço, e a segunda foi **recusada** com *"O domínio de sistema já existe."*,
> sem ser criada. O formulário voltou com o nome de usuário e **sem a senha**.
> Deixe sempre o `<USERNAME>` no esquema.

## O endereço precisa de DNS fora do painel

**Medido neste servidor, com o esquema de fábrica:** o painel cria uma zona de DNS
para cada domínio de sistema, e o servidor de DNS do próprio painel responde pelo
endereço da conta. **Na internet, o mesmo endereço não existe**: servidores de DNS
públicos respondem que o nome não existe.

O motivo é que o DNS do domínio do painel é de outro servidor, e ele não manda
esses nomes para o servidor do painel. Para o domínio do sistema abrir na
internet, o DNS do domínio de cima precisa apontar esses nomes para o servidor.
Isso é configurado fora do painel, onde fica o DNS daquele domínio.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **O domínio do sistema não abre na internet** | o DNS do domínio do painel não aponta esses nomes para o servidor | configurar o DNS do domínio de cima, fora do painel |
| **Contas novas mostram todas o mesmo endereço** | o esquema está sem `<USERNAME>` | pôr o `<USERNAME>` de volta |
| **Ao criar uma conta:** *"O domínio de sistema já existe."* | o esquema está sem `<USERNAME>`, e o endereço que ele gera já é de outra conta | pôr o `<USERNAME>` de volta no esquema, e gerar a senha de novo no formulário |
| *"Entrada inválida no campo Esquema de Domínio do Sistema."* | espaço, sublinhado, falta de ponto, ou marcador em minúsculas | escrever os marcadores em maiúsculas, `<USERNAME>` e `<PANEL_DOMAIN>`, separados por ponto ou hífen |
| Mudei o esquema e as contas antigas continuam com o endereço velho | o esquema entra na criação da conta, e os domínios antigos não mudam | é o comportamento do painel |

## Ver também

* [Criar uma conta de cliente](/keyhelp-admin/criar-conta-de-cliente), onde o domínio do sistema é criado
* [Nome de Domínio](/keyhelp-admin/nome-de-dominio), o domínio do painel que entra no `<PANEL_DOMAIN>`
* [Servidor de DNS](/keyhelp-admin/servidor-de-dns), o DNS do próprio painel


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.