Digite para filtrar os verbetes do Glossário.

    Redes e segurança · Vibe Coding: Do Zero ao MVP

    O que é link mágico?

    O link mágico permite entrar numa aplicação por um endereço enviado ao email. O serviço valida a credencial do link e estabelece a sessão conforme o fluxo.

    Também chamado de: magic link

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Autenticação pelo endereço recebido

    Um link mágico é um endereço com uma credencial temporária que permite entrar numa aplicação ao abri-lo. No uso por email, você informa seu endereço na tela de entrada e recebe o link na caixa de entrada. O serviço verifica a credencial para concluir a autenticação, sem exigir que você digite uma senha da aplicação.

    Ao abrir o endereço, o navegador apresenta a credencial ao serviço de autenticação. A verificação confere sua validade e permite concluir o fluxo que estabelece a sessão na aplicação. Por isso, o recebimento do email ainda não significa que a entrada foi concluída.

    Um fluxo de entrada no Supabase

    No Supabase Auth, o método signInWithOtp envia um link mágico por padrão, apesar do nome mencionar código de uso único. Neste exemplo, um cliente Supabase já configurado inicia a entrada para o email informado:

    const { error } = await supabase.auth.signInWithOtp({
    email: 'ana@example.com',
    options: {
    shouldCreateUser: false,
    },
    })

    A opção shouldCreateUser: false evita o cadastro automático de um endereço novo. Você deve tratar um eventual error na aplicação. O sucesso dessa chamada inicia o envio do link, mas ainda exige sua abertura e verificação para concluir a entrada.

    Uso único, expiração e retorno à aplicação

    Os links mágicos do Supabase são de uso único e têm prazo de expiração configurável. Os destinos de retorno também precisam estar entre os endereços permitidos na configuração de URLs do projeto. Em um teste, confira o caminho completo até a sessão, incluindo o endereço aberto depois da verificação.

    Trate o link como uma credencial de acesso e evite compartilhá-lo. A entrada depende do acesso ao email que o recebe. A documentação do Supabase Auth apresenta os fluxos de verificação, inclusive as diferenças entre abrir um link e digitar um código.

    Dúvidas frequentes

    Perguntas frequentes sobre link mágico

    O envio do email já cria uma sessão autenticada?
    O envio inicia a autenticação. Você ainda precisa abrir o link e concluir sua verificação para que o fluxo estabeleça a sessão.
    Posso reutilizar um link mágico do Supabase?
    Os links mágicos do Supabase são de uso único. Eles também expiram conforme o prazo configurado no serviço.
    Qual é a diferença para um código enviado ao email?
    No link mágico, você abre o endereço recebido. No método por código, você digita o código na aplicação para que o serviço faça a verificação.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao desenvolver a autenticação, você precisa conferir o envio do link e a criação da sessão como etapas distintas.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano