Verificador de prefixo IPv6
O verificador de prefixo IPv6 responde a uma questão precisa de roteamento e controle de acesso: este endereço pertence àquele bloco CIDR?
Executar grátis
Informe um endereço IPv6 e um prefixo como 2001:db8:1234::/48. A ferramenta compara os bits de rede mais significativos, retorna um resultado claro, verdadeiro ou falso, e mostra a rede normalizada com o primeiro e o último endereço. Notações comprimida, expandida e IPv6 com IPv4 incorporado são tratadas com aritmética exata de 128 bits, sem arredondar limites nem comprimentos de prefixo incomuns.
O que significa pertencer a um prefixo IPv6
Um prefixo IPv6 divide um endereço de 128 bits entre bits de rede e bits de host. O número depois da barra informa quantos bits mais significativos identificam a rede. Por exemplo, um /48 fixa os primeiros 48 bits e deixa os 80 restantes disponíveis dentro do bloco. Um endereço pertence ao prefixo quando todos os bits fixos da rede coincidem; a forma textual não interfere. Isso importa porque o IPv6 permite omitir zeros à esquerda, comprimir sequências com :: e escrever o mesmo valor de maneiras visualmente diferentes. O verificador converte os dois valores em inteiros exatos, cria a máscara para o comprimento solicitado e compara somente os bits que definem a associação. Ele também normaliza o prefixo informado até o limite real da rede. Se você inserir um endereço de host como 2001:db8:1234:99::1/48, a rede comparada continuará sendo 2001:db8:1234::/48. Assim, o resultado segue a semântica CIDR, sem depender de comparações frágeis de texto ou de grupos separados por dois-pontos.
Como interpretar o resultado booleano e o intervalo
O resultado principal é in_prefix, um valor booleano que você pode usar diretamente em código, regras de validação, verificações de rota ou relatórios de auditoria. A resposta também retorna o endereço e o prefixo canônicos para mostrar exatamente o que foi comparado. Os campos first_address e last_address descrevem os limites inclusivos da rede, enquanto matched_network_range apresenta os mesmos extremos em um intervalo compacto e legível. Esses campos aparecem tanto para resultados verdadeiros quanto falsos: quando o resultado é falso, o intervalo identifica o bloco no qual o endereço não entrou. O comportamento nos limites é exato. O primeiro e o último endereço pertencem ao prefixo, pois o IPv6 não reserva um endereço de broadcast. Um /128 contém apenas um endereço, portanto os dois extremos são iguais. Um /0 abrange todos os endereços IPv6. Nenhum número de ponto flutuante é usado; máscaras e intervalos são calculados com inteiros exatos de 128 bits, inclusive muito além do limite inteiro seguro do JavaScript.
Entradas válidas e erros comuns
Forneça address como um endereço IPv6 isolado e prefix como uma rede IPv6 seguida de um comprimento entre 0 e 128. São aceitas a notação comprimida, como 2001:db8::1, a notação totalmente expandida e terminações IPv6 com IPv4 incorporado, como ::ffff:192.0.2.1. O verificador rejeita de propósito entradas ambíguas ou fora do escopo. O campo address não pode trazer seu próprio comprimento após uma barra, prefix precisa incluí-lo, valores somente IPv4 não são tratados como IPv6 e identificadores de zona como %eth0 são recusados, pois indicam um contexto de interface e não fazem parte dos 128 bits. Grupos hexadecimais inválidos, mais de uma compressão ::, grupos com mais de quatro dígitos e comprimentos fora do intervalo permitido geram erro de entrada, não uma resposta presumida. Esse rigor ajuda na automação: uma configuração malformada falha claramente antes de virar uma decisão incorreta de lista de permissão. Em autorizações sensíveis, lembre-se de que a associação é apenas um fato; aplique também suas verificações de identidade, confiança e política.
Casos de uso
Validar uma lista permitida de IPv6
Verifique se o endereço de um cliente ou serviço está em um bloco CIDR aprovado antes de aplicar uma política de rede.
Depurar a configuração de rotas
Confirme se um endereço está no prefixo de rota esperado e consulte os limites normalizados exatos quando não estiver.
Testar dados de gestão de endereços
Compare endereços importados com prefixos IPv6 atribuídos e sinalize registros colocados na rede errada.
Perguntas frequentes
Quanto custa uma verificação?
Cada solicitação API custa US$ 0,002. A mesma verificação determinística também pode ser feita gratuitamente no navegador.
O verificador aceita endereços IPv6 comprimidos?
Sim. A compressão padrão :: e a omissão de zeros à esquerda são aceitas; depois, o endereço volta no formato canônico em minúsculas.
O primeiro e o último endereço estão incluídos?
Sim. O intervalo informado é inclusivo, e o IPv6 não reserva um endereço de broadcast no final do prefixo.
O que acontece se o prefixo contiver bits de host?
Ele é normalizado até o limite real da rede antes da comparação, e o CIDR normalizado aparece no resultado.
Posso verificar um endereço IPv4?
Não. Esta capacidade é específica para IPv6, embora aceite uma notação IPv6 válida com IPv4 incorporado.
Um resultado falso também inclui o intervalo?
Sim. A resposta mostra o intervalo inclusivo testado para que você identifique por que o endereço ficou de fora.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/dev/ipv6-in-prefix \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"address":"2001:db8:1234::42","prefix":"2001:db8:1234::/48"}'const res = await fetch("https://api.kit.forhosting.com/dev/ipv6-in-prefix", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"address": "2001:db8:1234::42",
"prefix": "2001:db8:1234::/48"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/ipv6-in-prefix",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"address": "2001:db8:1234::42",
"prefix": "2001:db8:1234::/48"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/ipv6-in-prefix", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"address":"2001:db8:1234::42","prefix":"2001:db8:1234::/48"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"address":"2001:db8:1234::42","prefix":"2001:db8:1234::/48"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/ipv6-in-prefix", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"address": "2001:db8:1234::42",
"prefix": "2001:db8:1234::/48"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.ipv6_in_prefix",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |