{"canonical_url":"https://engineer.company/es/glossary/onion/","content_markdown":"# Servicio onion\n\n## Qué es\n\nUn servicio onion es un servidor al que los lectores acceden dentro de la red\nTor mediante un nombre construido a partir de la propia clave pública del\nservidor, en lugar de un nombre DNS que apunte a una dirección IP. A menudo se\nhabla simplemente de un onion; un demonio tor puede ejecutar varios servicios onion en\nparalelo, y la especificación sigue usando el nombre anterior, servicio oculto.\n\nEl nombre consta de 56 caracteres base32 seguidos de `.onion`. Una vez decodificado,\nocupa 35 bytes: la clave de identidad ed25519 de 32 bytes del servicio, una suma\nde comprobación de dos bytes extraída de un hash SHA3-256 de esa clave y un byte\nde versión establecido en 3. Como ese byte va al final, todas las direcciones\nactuales terminan en la letra d. Nadie elige la etiqueta; es la clave expresada\npor escrito. Los nombres anteriores, de versión 2, tenían 16 caracteres\nextraídos de un hash SHA-1 de una clave RSA-1024, y tor dejó de admitirlos en la\nversión 0.4.6.1-alpha, en 2021.\n\nPara acceder al servicio hacen falta dos lugares de encuentro. El servicio elige\nalgunos nodos de retransmisión como puntos de introducción, mantiene circuitos\nabiertos hacia ellos y sube a nodos de directorio un descriptor firmado que los\nenumera. El descriptor se guarda bajo una clave cegada que cambia en cada\nperíodo, y su cuerpo está cifrado, por lo que un nodo que lo almacene sin\nconocer la dirección no puede leer la lista. Un cliente que tenga la dirección\nobtiene el descriptor, comprueba la firma con la clave del nombre, elige un nodo\ncomo punto de encuentro y pide al servicio, a través de un punto de\nintroducción, que se reúna allí. El servicio construye su propio circuito hasta\nese nodo y completa la negociación, y el nodo une ambos circuitos. El recorrido\ncruza seis nodos, tres elegidos por cada lado, y ninguno de los extremos conoce\nla dirección IP del otro. Un modo opcional, hoy llamado descubrimiento\nrestringido y antes autorización de clientes, también cifra el descriptor para\nla clave de cada cliente autorizado, de modo que solo esos clientes conocen dónde están los\npuntos de introducción.\n\n## Por qué importa\n\nEl nombre hace el trabajo que DNS y una autoridad de certificación comparten en\nun sitio normal, y no necesita ninguno de los dos. Verificar el descriptor y\ncompletar la negociación indica al cliente que está hablando con quien posee la\nclave privada que hay detrás de la dirección. El RFC 7686, que reserva `.onion` como\nnombre de dominio de uso especial, describe estos nombres como una combinación\nde localización y autenticación y extrae la consecuencia: un nombre onion no se\npuede registrar, asignar, transferir ni revocar. Poseer uno significa controlar\nel par de claves, nada más.\n\nEl cifrado procede del mismo diseño. El tráfico hacia un servicio onion nunca\nsale de la red Tor, así que no hay un nodo de salida en el otro extremo ni un\núltimo tramo en texto claro. Por tanto, una página con un simple `http://` en un onion\nviaja cifrada de extremo a extremo hasta un host cuya identidad el cliente\ncomprobó con el nombre que escribió.\n\nEl servicio solo establece conexiones salientes, hacia sus puntos de\nintroducción y cada punto de encuentro, por lo que no necesita ningún puerto\nentrante abierto y funciona detrás de NAT. Añadir un onion no cambia la lista de\npuertos abiertos del host.\n\nLos lectores siguen teniendo que conocer la dirección. Un sitio puede anunciarla\nmediante una cabecera de respuesta `Onion-Location`, y Tor Browser muestra entonces un botón\nmorado con forma de píldora en la barra de direcciones que lleva a la copia\nonion de la página. Tor Project impone tres condiciones: el valor debe ser una\nURL `http:` o `https:` con un host onion, la página que la envía debe haber llegado por\nHTTPS y esa página no debe estar ya en un onion. Una etiqueta meta puede\ntransmitir el mismo anuncio cuando no se pueden configurar cabeceras, pero sin\nla ruta, de modo que todas las páginas apuntan a una URL fija.\n\n## Cómo se aplica en la práctica\n\nLa [publicación del espejo onion de la empresa bajo una dirección legible](/es/portfolio/published-a-readable-tor-onion-mirror/) está descrita paso a paso. El demonio procede del propio paquete de la\ndistribución, con su puerto de proxy de salida desactivado. La clave privada asociada a la dirección se generó fuera del host y nunca ha llegado al repositorio\nni a un portátil; el rol se niega a sobrescribir una identidad que no generó,\npor lo que una clave colocada a mano se utiliza tal cual. La dirección es un\nvalor declarado en el inventario, y cada ejecución de convergencia comprueba que\nel archivo de identidad del host coincide con él, de modo que una clave\nsustituida con una declaración sin actualizar detiene la ejecución. Ambos\ncontroles de secretos detectan el archivo de clave, después de que una medición\nmostrara que el patrón evidente para archivos de claves coincidía con una clave\nde despliegue y pasaba por alto esta.\n\nUn prefijo legible se puede encontrar, pero nunca elegir. Cada carácter\nadicional multiplica por 32 el esfuerzo de búsqueda esperado, por lo que las ocho letras de\n`engineer` requieren, de media, unos 1,1 billones de pares de claves. Retirar la\ndirección aleatoria con la que se publicó inicialmente el espejo exigió una\ntransición por etapas, de modo que la dirección publicada siguió respondiendo\ndurante todo el proceso. Un paso parecía definitivo y no lo era: la clave ya estaba en su sitio,\nla convergencia no notificó cambios y la nueva dirección siguió sin publicarse\nporque nada indicaba su directorio. Ahora el rol falla si encuentra en disco una\nidentidad que ningún servicio menciona.\n\n[La página de créditos](/es/credits/) muestra la dirección completa, `engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion`, junto a las de Gemini y Gopher. Las\ncuatro puertas de entrada comparten una carpeta de archivos y un despliegue, de\nmodo que ninguna puede divergir de las demás, y el sitio normal envía `Onion-Location` para\nque Tor Browser ofrezca el onion sin que se solicite. Lo que ve la propia red\ndel lector depende de la puerta: por Gopher, qué página se lee; por Gemini, qué\ndirección se solicitó; por el onion, ninguna de las dos cosas. El prefijo\nlegible es una comodidad, no una prueba, así que lo que hay que comparar es la\ndirección completa.\n\nLa estructura de la dirección puede comprobarse sin conexión. Estas líneas la\ndecodifican y vuelven a calcular la suma de comprobación, y ambas comparaciones\nimprimen `True`:\n\n```python\nimport base64\nimport hashlib\n\nlabel = \"engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd\"\nraw = base64.b32decode(label.upper())\nkey, checksum, version = raw[:32], raw[32:34], raw[34:]\ndigest = hashlib.sha3_256(b\".onion checksum\" + key + version).digest()\nprint(version == b\"\\x03\", digest[:2] == checksum)\n```\n\nUna suma de comprobación válida muestra que la dirección está bien formada, no a\nquién pertenece. Esa parte procede de leerla en las propias páginas HTTPS de la\nempresa.\n\n## Dónde surgen los problemas\n\n**La clave es el único título de propiedad.** Sin un registrador detrás del\nnombre, perder la clave privada significa perder la dirección, y una copia\npermite a otra persona responder en ella. La guía de configuración de Tor\nProject indica que los archivos de clave deben mantenerse privados y que debe\nhacerse una copia de seguridad de la clave si se pretende que el servicio\nperdure. Trátela como una clave de firma, no como configuración.\n\n**Leer solo las primeras letras.** El RFC 7686 advierte de que un atacante puede\nencontrar claves cuyos nombres se parezcan al buscado y de que el riesgo aumenta\nporque los nombres no significan nada para una persona. Considera los nombres\nlegibles, obtenidos con un esfuerzo de cómputo considerable, como una medida,\npero un prefijo de ocho caracteres deja los otros 48 tan opacos como antes.\nCompare la dirección completa o acceda desde un marcador o un enlace en las\npropias páginas HTTPS del sitio.\n\n**El servidor revela su nombre.** Tor oculta dónde se ejecuta el servicio, pero\nel software que hay detrás aún puede revelarlo. El RFC 7686 incluye entre las\nformas en que falla la protección que un servidor filtre su identidad en un\nmensaje de nivel de aplicación, y una página de error que muestre el nombre de\nhost real de la máquina es un ejemplo. La guía de configuración también\nrecomienda pasar el tráfico al servidor web mediante un socket Unix en lugar de\nTCP, para que el servicio no quede expuesto en la red local:\n\n```text\nHiddenServiceDir /var/lib/tor/my-website/\nHiddenServicePort 80 unix:/var/run/tor/my-website.sock\n```\n\nEsto importa especialmente cuando la propia ubicación es el secreto.\n\n**El nombre llega a DNS.** El software que no entiende Tor pregunta al\nresolvedor normal por un nombre onion, lo que revela a la red local y al\nproveedor de DNS qué onion se quería visitar. El RFC 7686 indica a ese software\nque falle sin hacer la consulta y a los servidores DNS que respondan que el\nnombre no existe. Entregue el nombre al cliente Tor en su lugar.\n\n**Un botón `Onion-Location` que nunca aparece.** Una cabecera configurada solo en la\nredirección HTTP sin cifrar incumple la condición de HTTPS, y otra con una\ndirección mal escrita no lleva a los lectores a ningún sitio. Compruebe la\ncabecera de la respuesta HTTPS final.\n\n## Lecturas adicionales\n\n- [Especificación de encuentro de Tor, versión 3](https://spec.torproject.org/rend-spec/)\n  — protocolo completo: claves de identidad y cegadas, descriptores,\n  introducción y encuentro.\n- [Codificación de direcciones onion](https://spec.torproject.org/rend-spec/encoding-onion-addresses.html)\n  — fórmula que convierte una clave pública en un nombre de 56 caracteres, con\n  direcciones de ejemplo.\n- [¿Cómo funcionan los servicios onion?](https://community.torproject.org/onion-services/overview/)\n  — recorrido paso a paso por los puntos de introducción, los descriptores y el\n  encuentro.\n- [Configure su servicio onion](https://community.torproject.org/onion-services/setup/)\n  — líneas de torrc, archivos que crea tor y recomendaciones sobre claves y\n  filtraciones de ubicación.\n- [Onion-Location](https://community.torproject.org/onion-services/advanced/onion-location/)\n  — configuración de cabeceras y etiquetas meta para Apache, Nginx y Caddy, y\n  condiciones que debe cumplir la cabecera.\n- [RFC 7686](https://www.rfc-editor.org/rfc/rfc7686)\n  — por qué está reservado `.onion` y qué deben hacer con él los resolvedores, los\n  operadores DNS y los registradores.\n\n\u003chttps://engineer.company/es/glossary/onion/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Cómo funciona un servicio onion: un nombre basado en su clave pública, un encuentro que oculta ambos extremos y las precauciones al operarlo.","formats":{"gemtext":"https://engineer.company/es/glossary/onion/index.gmi","gopher":"https://engineer.company/es/glossary/onion/gophermap","html":"https://engineer.company/es/glossary/onion/","json":"https://engineer.company/es/glossary/onion/index.json","markdown":"https://engineer.company/es/glossary/onion/index.md","pdf":"https://engineer.company/es/glossary/onion/index.pdf"},"kind":"page","language":"es","title":"¿Qué es un servicio onion?","url":"https://engineer.company/es/glossary/onion/","version":1}