Ferramentas de domínios próprios
Ligue um domínio ao projeto e verifique o DNS e o certificado.
Nesta página
Ligue um domínio, verifique o DNS e escolha o domínio principal. Configure os registos DNS no seu fornecedor.
Nota
A ligação aplica-se ao Space. Pertence a ele e o Space não está bloqueado. Um Space é uma área de trabalho partilhada na app.
As quatro ferramentas exigem Proprietário, Administrador ou Utilizador. Apenas leitura não é suficiente.
hosting_add_domain Add domain
altera dados
Adiciona um domínio próprio a um projeto. O domínio fica pendente: só serve o website quando o DNS estiver configurado, hosting_check_domain o tiver considerado correto e o certificado estiver disponível.
A resposta indica os registos DNS necessários. Se faltarem devido a uma transmissão pendente, chame hosting_check_domain.
- O nome de host tem no máximo 253 caracteres, não é um endereço IP e aparece sem
https://nem caminho. A TEISENDA rejeita nomes de host nas zonasteisenda.com,teisendapages.cometeisendahosting.com. - Um projeto tem no máximo 19 domínios próprios.
- O plano limita os domínios próprios por Space: tantos como os projetos permitidos, ou seja, 1 em Free e 10 em Max. Com Max contratado, há pacotes de 5 projetos adicionais e portanto 5 domínios próprios adicionais; consulte Comprar e remover pacotes adicionais. Se atingir o número, a TEISENDA rejeita a chamada e não altera nada.
Que registos DNS indica a resposta e para que servem?
A lista só inclui um AAAA se o nó de alojamento o indicar. O TXT com o nome _teisenda-hosting.<Domain> e o valor teisenda-hosting=<Nachweis> comprova que o domínio lhe pertence.
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto indicado por hosting_list_projects. |
hostname | Texto | obrigatório | Um nome de host sem https:// nem caminho, por exemplo www.example.com. |
hosting_check_domain Check domain
altera dados
Verifica o DNS e ativa o domínio se os registos corresponderem. O certificado é depois emitido em segundo plano.
Chame novamente a ferramenta para verificar o estado atual. Depois de uma falha do certificado, inicia uma nova tentativa.
Se o DNS não corresponder, a resposta indica os problemas e Defina o registo CNAME ou o registo A e, além disso, o registo TXT como prova de titularidade..
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto indicado por hosting_list_projects. |
hostname | Texto | obrigatório | Um nome de host sem https:// nem caminho, por exemplo www.example.com. |
hosting_set_primary_domain Set primary domain
altera dadoselimina, substitui ou altera o que é visível
Define o domínio principal: o endereço para o qual redirecionam todos os outros endereços do projeto. É um domínio próprio ativo ou, se hostname faltar, o endereço TEISENDA do projeto.
O domínio principal muda na primeira chamada. Um domínio próprio tem de estar ativo; os visitantes veem a alteração assim que for transmitida.
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto indicado por hosting_list_projects. |
hostname | Texto | opcional | O domínio próprio que passa a ser o principal: um nome de host sem https:// nem caminho, por exemplo www.example.com. Se faltar, o endereço TEISENDA passa a ser o principal. |
hosting_remove_domain Remove domain
altera dadoselimina, substitui ou altera o que é visíveldois passos
Remove o domínio e o certificado. Se era o principal, volta a aplicar-se o endereço TEISENDA.
Chame primeiro a ferramenta sem confirm. Só a segunda chamada com a frase de confirmação devolvida remove o domínio; a aplicação deve obter primeiro o seu consentimento.
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto indicado por hosting_list_projects. |
hostname | Texto | obrigatório | Um nome de host sem https:// nem caminho, por exemplo www.example.com. |
confirm | Texto | opcional | A aplicação deve omiti-lo na primeira chamada; a resposta indica então uma frase de confirmação. Só deve enviar essa mesma frase depois do seu consentimento. |
Se algo não funcionar
Quando uma solução indicar uma ferramenta, peça à aplicação que a chame. A mensagem do plano remete para a consulta do plano na TEISENDA, em Definições › Planos; nas definições, a opção chama-se Faturação.
Este não é um nome de anfitrião válido. Introduza-o sem https:// e sem caminho.
O nome de host não é válido. Tem no máximo 253 caracteres, não é um endereço IP e aparece sem https:// nem caminho. Indique apenas o nome de host, por exemplo www.example.com.
Este domínio está bloqueado.
O nome de host está numa zona que nenhum projeto pode utilizar: teisenda.com ou teisendapages.com. Utilize um domínio próprio.
Os endereços desta zona são atribuídos exclusivamente por TEISENDA.
O nome de host está na zona teisendahosting.com, onde a TEISENDA atribui os endereços TEISENDA. Utilize um domínio próprio.
Este domínio já leva a um projeto.
O domínio já está associado a um projeto: a este, a outro do Space ou a um de outro Space. A mesma mensagem aparece se o nó de alojamento conhecer o domínio num projeto. Um nome de host só pode pertencer a um projeto, considerando todos os Spaces. Remova-o primeiro do outro projeto com hosting_remove_domain ou utilize outro nome de host.
Não são permitidos mais de … domínios próprios.
O projeto já tem 19 domínios próprios. Remova primeiro um domínio.
O plano deste Space não permite mais domínios próprios: … de … já foram adicionados. Não foi alterado nada. O plano deste Space consta no TEISENDA, em Definições › Planos.
O plano do Space não permite outro domínio próprio: pode ter tantos como os projetos permitidos pelo plano. A TEISENDA não alterou nada. Remova um domínio. Max e os seus pacotes permitem mais projetos e portanto mais domínios próprios; consulte Planos Free e Max e Comprar e remover pacotes adicionais.
O domínio … não pertence a este projeto.
O domínio não pertence a este projeto. Consulte os domínios do projeto com hosting_project_status.
Só é possível quando o domínio está ativo.
hosting_set_primary_domain foi chamado para um domínio ainda não ativo. Conclua a configuração do DNS e chame hosting_check_domain até o domínio ficar ativo.
O DNS de … ainda não está correto:
Não é uma rejeição: hosting_check_domain verificou que o DNS do domínio ainda não está correto. Segue-se uma linha por problema; as linhas estão na secção seguinte. Configure os registos no seu fornecedor de DNS e chame hosting_check_domain novamente.
Problemas indicados por hosting_check_domain
Nenhuma destas linhas é uma rejeição. As primeiras nove aparecem no resultado de hosting_check_domain enquanto o DNS não estiver correto. As últimas três são o problema guardado no domínio; hosting_project_status e hosting_check_domain mostram-no como problema do domínio.
Não existe nenhum registo DNS para o domínio.
O nome do domínio não aponta para nenhum destino: no fim da cadeia CNAME, o nó de alojamento não encontra A nem AAAA. Configure o CNAME ou A indicado pelo resultado.
Falta o registo A.
O domínio tem um AAAA, mas nenhum A. Configure o A com o valor indicado pelo resultado ou utilize antes o CNAME.
Existe outro registo A que aponta para outro lado.
Além do A que aponta para o nó de alojamento, o domínio tem outro A que aponta para outro destino. Remova o outro A no seu fornecedor de DNS.
O domínio aponta para outro servidor.
O domínio tem registos A, mas nenhum é o endereço do nó de alojamento: aponta para outro servidor. Substitua o CNAME ou A existente pelo indicado no resultado.
Existe um registo AAAA que aponta para outro lado.
O domínio tem um AAAA diferente do endereço IPv6 do nó de alojamento. A autoridade certificadora dá preferência a IPv6 e falha com esse registo. Remova-o ou defina o valor indicado pelo resultado, se existir.
Um registo CAA proíbe a emissão do certificado.
Um CAA do domínio ou de um nome acima dele só permite certificados de outras autoridades além de Let's Encrypt, utilizada pelo nó de alojamento. Altere-o ou remova-o no seu fornecedor de DNS para permitir letsencrypt.org.
Falta a prova de titularidade: o registo TXT não está definido.
Falta a prova de propriedade: o domínio não aponta por CNAME para um endereço do mesmo projeto em teisendahosting.com nem o TXT _teisenda-hosting.<Domain> tem o valor esperado. Um A, por si só, não comprova nada. Configure o TXT com o nome e valor indicados pelo resultado.
O DNS do domínio não responde.
Os resolvedores consultados pelo nó de alojamento não responderam para o domínio. Não foi possível verificar o DNS. Verifique no seu fornecedor de DNS que o domínio é resolvido e chame hosting_check_domain novamente.
Os registos ainda não chegaram a todo o lado. Tente novamente dentro de alguns minutos.
Um dos dois resolvedores públicos consultados pelo nó já vê os registos corretos, o outro ainda não. Nesse caso, esta linha aparece sozinha. Aguarde alguns minutos e chame hosting_check_domain novamente.
O DNS ainda não está correto.
Uma tentativa de ativar o domínio encontrou o DNS incorreto nesse momento. Por isso, não foi pedido um certificado. Corrija o DNS e chame hosting_check_domain novamente.
O certificado foi rejeitado.
A emissão do certificado falhou, independentemente do motivo. O domínio tem então o estado failed. Verifique os registos DNS, sobretudo um CAA, e chame hosting_check_domain novamente; inicia uma nova tentativa assim que o DNS estiver correto. Se continuar a falhar, contacte o suporte.
O nó de alojamento comunica um problema com este domínio.
O nó de alojamento indica algo para o qual a TEISENDA não tem uma frase própria, por exemplo um reinício que interrompeu a emissão do certificado. Chame hosting_check_domain novamente.
As mensagens sobre o Space e o número de projeto estão nas ferramentas de Spaces e projetos. Todas as restantes que podem aparecer em qualquer ferramenta estão em Resolver problemas do Connector.