Conversor Punycode

Nomes de domínio internacionalizados precisam de uma codificação compatível com ASCII para que DNS, certificados e resolvedores legados transportem rótulos com trema, acentos, cirílico, árabe ou caracteres CJK. Punycode (RFC 3492) é o algoritmo Bootstring por trás do prefixo xn-- familiar nas A-labels IDNA. Esta capacidade codifica um único rótulo de domínio Unicode nessa forma ACE, ou decodifica um corpo ACE ou Punycode bruto de volta ao U-label Unicode original, com um campo mode simples e aritmética inteira determinística. Caracteres de alfabeto inválidos, corpos xn-- vazios, surrogates isolados e strings multi-rótulo com pontos são rejeitados com erro de entrada inválida claro em vez de corrupção silenciosa.

Codifique um rótulo de domínio Unicode para Punycode ACE (xn--)

O motor coloca o rótulo em minúsculas de forma independente de locale, rejeita strings vazias, espaços em branco, caracteres de controle e quaisquer pontos embutidos para você nunca tratar acidentalmente um hostname multi-rótulo inteiro como um único rótulo DNS. Rótulos ASCII puros passam inalterados sem prefixo xn--, alinhados à prática IDNA para nomes LDH.

Quando o rótulo contém qualquer ponto de código não ASCII, o motor executa o codificador Punycode RFC 3492 e prefixa o resultado com xn-- para produzir o A-label usado em arquivos de zona DNS, SANs de certificado e exibições WHOIS. A resposta inclui result (o rótulo ACE ou ASCII), unicode (o U-label normalizado), punycode (o corpo sem o prefixo xn--), ace verdadeiro ou falso, mode encode e method rfc3492 para que testes fixem cada campo.

Entradas idênticas sempre produzem saídas idênticas porque o caminho é aritmética pura sem rede, sem sal aleatório e sem relógio de parede. Use este caminho quando precisar de um A-label seguro para colar em uma lista de migração, uma linha de zona ou um ticket de suporte que deva sobreviver a sistemas que só aceitam hostnames ASCII.

Decodifique ACE ou Punycode de volta a Unicode e trate entrada inválida

Defina mode como decode e coloque um rótulo ACE como xn--mnchen-3ya ou um corpo Punycode bruto como mnchen-3ya em text. O motor remove um prefixo xn-- inicial quando presente, valida que o corpo use apenas o alfabeto básico de letras, dígitos e hífens internos, e executa o decodificador RFC 3492 para recuperar pontos de código Unicode—incluindo caracteres do plano suplementar representados com pares surrogates em strings JavaScript.

Decode bem-sucedido devolve result e unicode como o U-label, punycode como o corpo, ace verdadeiro quando a entrada trouxe o prefixo xn--, mode decode e method rfc3492. Prefira esta capacidade quando a intenção de busca for um conversor punycode para rótulos de domínio legíveis; divisão de hostname completo, busca de sufixo público e resolução DNS ao vivo pertencem a outras ferramentas.

Como usar com domínios e seus limites

Chame o conversor punycode gratuito no navegador para playbooks de suporte, demos de sala e checagens pontuais de rótulo sem instalar OpenSSL ou runtimes de linguagem. Um fluxo típico codifica um rótulo de marca Unicode antes de gravar um A-label em um template de zona, depois decodifica nomes ACE copiados de cabeçalhos de e-mail ou logs de certificado para operadores lerem o U-label pretendido. Outro fluxo verifica se amostras de documentação ainda fazem ida e volta antes de um release.

Rótulos DNS são limitados a sessenta e três octetos na forma ACE, e este motor aplica esse limite no encode para rótulos internacionais oversized falharem cedo em vez de produzir strings não implantáveis.