Pular para o conteúdo
EntrarComeçar grátis
Todos os artigos de ajuda

Domínios de apps

Dê a um app um hostname próprio, como go.example.com para o Go Links, com endereços no seu nome: configure, aponte o DNS e escolha quem entra.

O que um domínio de app oferece

Um domínio de app é um hostname seu que serve um dos apps do seu espaço de trabalho, com endereços curtos e limpos:

  • O Go Links responde nele sem /go: go.example.com/roadmap leva para onde roadmap aponta, o que faz dele o endereço ideal para cartazes e slides.
  • Os eventos do Dory ficam em endereços como events.example.com/events/…, e os links de participação e QR codes compartilhados a partir do hostname apontam para ele.
  • Todos os outros apps funcionam do mesmo jeito, com as páginas deles no hostname.

Depois que um hostname é salvo, e-mails, mensagens do Slack, a API REST e os assistentes de IA passam os endereços do app nele. Configurações, cobrança, a página inicial do espaço de trabalho e os outros apps continuam no endereço do próprio Taktoria. Cada app pode ter um hostname.

Configurar um

Só um proprietário ou administrador do espaço de trabalho pode dar um hostname a um app.

  1. Abra Configurações → Domínios de apps.
  2. No app, digite o Host, como go.example.com, e selecione Salvar.
  3. Adicione o registro DNS que aparece em seguida, onde quer que o DNS do seu domínio seja gerenciado (veja abaixo).
  4. Espere alguns minutos. A linha abaixo do hostname diz em que ponto ele está, e Verificar novamente confere na hora.

Um hostname serve um app em um espaço de trabalho: um que já aponta para outro espaço de trabalho, ou que já serve outro app, é recusado.

O registro DNS

Salvar o hostname não faz nada sozinho: é o registro mostrado ao lado dele que o aponta para o Taktoria. É um CNAME para um hostname abaixo do seu domínio, como go.example.com, e um registro A para a raiz de um domínio, como example.com. O nome aparece na forma curta que a maioria dos provedores de DNS pede, go, ou @ para a raiz, com o valor ao lado.

Se o hostname já foi usado com o nosso provedor de hospedagem, também é pedido um registro TXT, para provar que você pode usá-lo.

Atrás da Cloudflare, configure o registro como somente DNS (a nuvem cinza). Com o proxy ativado, o tráfego nunca chega ao Taktoria e o certificado não pode ser emitido.

Verificação e certificado

Quando o registro está no lugar, o certificado do hostname é emitido automaticamente: não há nada para enviar nem renovar. A linha abaixo do hostname passa a dizer que ele está funcionando, e o registro deixa de aparecer, embora precise continuar no seu DNS.

Até lá, a linha diz o que está esperando: o registro DNS chegar até nós, ou o registro TXT verificar o hostname. Se ela disser que o hostname não está configurado no nosso provedor, salve-o de novo.

Login no hostname

As pessoas fazem login no hostname e continuam lá. Quem já está conectado ao Taktoria entra no hostname sem precisar fazer login de novo, e sair de um sai dos dois.

A página de login no hostname traz o nome do seu espaço de trabalho, e o ícone dele quando houver um; com a marca branca ativada, o cabeçalho também. Ela oferece só as formas de entrar que o seu espaço de trabalho permite: só o Google quando ele exige o Google, e o login único só quando há um provedor. Lá não há cadastro: as pessoas entram em um espaço de trabalho por convite.

Visitantes que não são membros

Algumas páginas de um hostname também são para pessoas de fora do seu espaço de trabalho, que nunca precisam de conta:

  • Go Links: cada link escolhe quem pode abri-lo, em Quem pode abri-lo no formulário dele. Pessoas de certos domínios de e-mail, o padrão, deixa entrar os membros e qualquer pessoa que comprove um endereço em um domínio da lista do seu espaço de trabalho em Configurações → Domínios, com Continuar com o Google ou Enviar um código por e-mail. Somente membros deste workspace deixa entrar só os membros, e Qualquer pessoa com o link deixa entrar todo mundo, o que o formulário avisa. Até alguém comprovar um endereço, um link que essa pessoa não pode abrir parece exatamente um que não existe.
  • Dory: os participantes entram em um evento no hostname, e o Quem pode entrar dele decide quem entra, como no endereço do próprio Taktoria. Um evento para Pessoas de certos domínios de e-mail pede na porta um endereço em um deles, e só mostra o título às pessoas que deixa entrar.

Um endereço comprovado vale por 30 dias naquele navegador. Veja Go Links e Dory para saber mais.

Mudar ou remover um hostname

Para mudar um app para outro hostname, salve o novo no lugar: o antigo deixa de servi-lo. Para parar de vez, selecione o botão abaixo do hostname que deixa de servi-lo, em Configurações → Domínios de apps.

O app volta então a ser acessado pelo endereço do próprio Taktoria, e os endereços do hostname antigo que foram distribuídos, como go links em cartazes e links de participação do Dory, param de funcionar. Remova o registro DNS quando não precisar mais dele.

Solução de problemas

  • Está esperando o DNS há muito tempo: confira o nome e o valor do registro com os mostrados, e se ele não está com proxy. Alguns provedores de DNS levam algumas horas.
  • Uma página abriu no endereço do próprio Taktoria: configurações, cobrança e os outros apps sempre abrem lá; as páginas do próprio app continuam no hostname.
  • Um visitante precisa fazer login, em vez de comprovar um endereço: o link é para Somente membros deste workspace, ou a lista do seu espaço de trabalho em Configurações → Domínios está vazia.