Link Cloaking na CodeQR: Como mascarar URLs
Aprenda a usar o link cloaking na CodeQR para mascarar URLs de destino com links curtos.


Este recurso está disponível apenas para planos Pro e superiores.
Com a CodeQR, você pode mascarar sua URL de destino com seu link curto.
Para habilitar o link cloakinclique para ativar Adicionar Link Cloaking no construtor de links.
Isso é útil quando você quer mostrar sua marca ou domínio personalizado em vez da URL de destino real.
Quando isso está habilitado, seu link curto será mostrado na barra de endereços do navegador dos seus usuários quando eles visitarem seu link, em vez da URL de destino.
Como funciona o Link Cloaking
O link cloaking funciona incorporando a página de destino em um iframe dentro de uma página hospedada no seu domínio curto. Isso significa que:
Vantagens do Link Cloaking
- Branding consistente: Os usuários veem sempre seu domínio na barra de endereços
- Proteção da URL real: A URL de destino fica oculta dos usuários
- Experiência unificada: Mantém a identidade visual da sua marca
- Analytics aprimorado: Melhor rastreamento do comportamento do usuário
Quando usar Link Cloaking
- Campanhas de marketing: Para manter a consistência da marca
- Links de afiliados: Para ocultar URLs de afiliação longas
- Proteção de URLs: Para prevenir acesso direto a recursos
- Branding profissional: Para apresentar uma imagem mais profissional
Limitações do Link Cloaking
Algumas limitações importantes do recurso de link cloaking:
1. Requisito HTTPS
Para que o link cloaking funcione, certifique-se de usar https para sua URL de destino. Se sua URL de destino for http, o navegador mostrará um aviso "Não Seguro", e o link cloaking não funcionará.
2. Restrições de segurança
O link cloaking pode não funcionar para determinados sites que têm medidas de segurança implementadas para prevenir isso:
- Cabeçalho X-Frame-Options definido como DENY
- Cabeçalho content-security-policy definido como frame-ancestors 'none'
- Políticas de referrer restritivas
- JavaScript que detecta iframes e redireciona
3. Limitações de funcionalidade
- Popups: Podem não funcionar corretamente
- Downloads: Alguns downloads podem ser bloqueados
- Autenticação: Logins podem apresentar problemas
- Cookies de terceiros: Podem ser bloqueados pelo navegador
Link Cloaking com Cabeçalhos de Segurança
Se você tem controle sobre a URL de destino que está mascarando, pode aproveitar os cabeçalhos de segurança para habilitar o link cloaking na CodeQR enquanto também desabilita a incorporação em iframe em outros lugares.
Adicionando cabeçalhos de segurança à sua URL de destino
Para fazer isso, você precisa incluir seu domínio curto da CodeQR como uma origem permitida no seu site, adicionando os seguintes cabeçalhos de resposta ao seu site:
Content-Security-Policy: frame-ancestors 'self' [seudominio.com]
Por exemplo, se seu domínio curto da CodeQR é meulink.com, você precisaria adicionar os seguintes cabeçalhos à sua URL de destino:
Content-Security-Policy: frame-ancestors 'self' meulink.com
Incluindo múltiplos domínios na whitelist
Você também pode incluir múltiplos domínios separando-os com um espaço:
Content-Security-Policy: frame-ancestors 'self' meulink.com outrodominio.com
Isso garantirá que seu site não possa ser incorporado em sites de terceiros, mas ainda possa ser mascarado pelo seu domínio curto da CodeQR.
Exemplo prático de implementação
Para sites WordPress
Adicione ao seu arquivo .htaccess:
<IfModule mod_headers.c> Header always set Content-Security-Policy "frame-ancestors 'self' seudominio.com" </IfModule>
Para aplicações Node.js/Express
app.use((req, res, next) => { res.setHeader('Content-Security-Policy', "frame-ancestors 'self' seudominio.com") next() })
Para sites Nginx
add_header Content-Security-Policy "frame-ancestors 'self' seudominio.com" always;
Configurações avançadas
Configuração condicional
Você pode configurar o link cloaking para funcionar apenas em determinadas condições:
// Exemplo para habilitar cloaking apenas para referrers específicos if (document.referrer.includes('seudominio.com')) { // Permitir iframe res.setHeader('X-Frame-Options', 'SAMEORIGIN') } else { // Bloquear iframe res.setHeader('X-Frame-Options', 'DENY') }
Detecção de iframe
Para sites que precisam detectar quando estão sendo exibidos em iframe:
// Verificar se a página está em um iframe if (window !== window.top) { // Página está em iframe (provavelmente via link cloaking) console.log('Página exibida via link cloaking') } else { // Página acessada diretamente console.log('Acesso direto à página') }
Melhores práticas
1. Teste sempre
- Diferentes navegadores: Chrome, Firefox, Safari, Edge
- Dispositivos móveis: iOS e Android
- Funcionalidades específicas: Formulários, downloads, autenticação
2. Monitore a performance
- Tempo de carregamento: Iframes podem ser mais lentos
- Taxa de rejeição: Monitore se há impacto negativo
- Conversões: Verifique se o cloaking afeta as conversões
3. Comunique aos usuários
- Transparência: Informe sobre o redirecionamento quando apropriado
- Suporte: Forneça links diretos como alternativa
- Documentação: Mantenha instruções claras para sua equipe
4. Segurança
- HTTPS obrigatório: Sempre use conexões seguras
- Validação de domínios: Mantenha lista atualizada de domínios permitidos
- Monitoramento: Acompanhe tentativas de acesso não autorizadas
Casos de uso comuns
Marketing e campanhas
- E-mail marketing: Manter consistência visual
- Redes sociais: Apresentar marca profissional
- Publicidade paga: Ocultar parâmetros de rastreamento
E-commerce
- Links de produtos: Manter usuários no domínio da marca
- Campanhas promocionais: Ocultar estruturas de URL complexas
- Programas de afiliados: Mascarar links de parceiros
Conteúdo educacional
- Cursos online: Manter experiência unificada
- Recursos externos: Integrar conteúdo de terceiros
- Bibliotecas digitais: Apresentar interface consistente
Solução de problemas
Problemas comuns e soluções
1. Página não carrega no iframe
Problema: A página de destino não aparece Soluções:
- Verificar se a URL usa HTTPS
- Conferir cabeçalhos X-Frame-Options
- Testar URL diretamente no navegador
2. Funcionalidades não funcionam
Problema: Formulários ou JavaScript não respondem Soluções:
- Verificar políticas de cookies
- Testar sem link cloaking
- Contatar o proprietário do site de destino
3. Avisos de segurança
Problema: Navegador mostra avisos Soluções:
- Garantir HTTPS em ambos os domínios
- Verificar certificados SSL
- Atualizar cabeçalhos de segurança
Impacto no SEO
Considerações importantes
- Indexação: Links com cloaking podem afetar a indexação
- Link juice: Pode não passar autoridade de domínio
- Rastreamento: Crawlers podem ter dificuldade
Recomendações
- Use noindex quando apropriado
- Monitore impacto nos rankings
- Considere canonical URLs
- Mantenha sitemap atualizado
Artigos relacionados
- Como criar um link curto na CodeQR
- Como configurar visualizações personalizadas para seus links
- Como criar links protegidos por senha na CodeQR
- Como definir data de expiração para seus links
- Como usar segmentação por dispositivo na CodeQR
- Como usar segmentação geográfica na CodeQR
- Como funciona a indexação por mecanismos de busca na CodeQR