{"canonical_url":"https://engineer.company/nb/glossary/onion/","content_markdown":"# Onion-tjeneste\n\n## Hva det er\n\nEn onion-tjeneste er en server leserne når inne i Tor-nettverket via et navn bygd av\nserverens egen offentlige nøkkel, i stedet for et DNS-navn som peker på en IP-adresse.\nMange forkorter det til en onion, én tor-daemon kan kjøre flere onion-tjenester side om\nside, og spesifikasjonen bruker fortsatt det eldre navnet hidden service, skjult\ntjeneste.\n\nNavnet er 56 tegn i base32 fulgt av `.onion`. Dekodet blir det 35 byte: tjenestens 32\nbyte store ed25519-identitetsnøkkel, en sjekksum på to byte hentet fra en SHA3-256-hash\nav den nøkkelen, og en versjonsbyte med verdien 3. Fordi den byten kommer sist, slutter\nalle gjeldende adresser på bokstaven d. Ingen velger navnet; det er nøkkelen skrevet ut.\nNavnene i versjon 2, som kom før, var 16 tegn kuttet fra en SHA-1-hash av en\nRSA-1024-nøkkel, og tor fjernet dem i utgave 0.4.6.1-alpha, i 2021.\n\nÅ nå tjenesten krever to møtesteder. Tjenesten velger noen reléer som\nintroduksjonspunkter, holder kretser åpne til dem og laster opp en signert beskrivelse\n(descriptor) som lister dem, til katalogreléer. Beskrivelsen arkiveres under en blindet\nnøkkel som skifter for hver periode, og innholdet er kryptert, så et relé som lagrer den\nuten å kjenne adressen, kan ikke lese listen. En klient som har adressen, henter\nbeskrivelsen, sjekker signaturen mot nøkkelen i navnet, velger et relé som møtepunkt\n(rendezvous) og ber tjenesten, via et introduksjonspunkt, om å møtes der. Tjenesten\nbygger sin egen krets til det reléet og fullfører håndtrykket, og reléet kobler de to\nkretsene sammen. Veien går gjennom seks reléer, tre valgt av hver side, og ingen av\nendene får vite den andres IP-adresse. En valgfri modus, som nå heter restricted\ndiscovery og tidligere het client authorization, krypterer i tillegg beskrivelsen for\nnøkkelen til hver autoriserte klient, så bare de klientene får vite hvor\nintroduksjonspunktene er.\n\n## Hvorfor det er viktig\n\nNavnet gjør jobben som DNS og en sertifikatutsteder deler på for et vanlig nettsted, og\ntrenger ingen av dem. Når klienten har verifisert beskrivelsen og fullført håndtrykket,\nvet den at den snakker med den som har den private nøkkelen bak adressen. RFC 7686, som\nreserverer `.onion` som et domenenavn til spesiell bruk, beskriver slike navn som en\nkombinasjon av sted og autentisering, og trekker konsekvensen: et onion-navn kan ikke\nregistreres, tildeles, overføres eller trekkes tilbake. Å eie et slikt navn betyr å\nkontrollere nøkkelparet, verken mer eller mindre.\n\nKrypteringen følger av den samme konstruksjonen. Trafikk til en onion-tjeneste forlater\naldri Tor-nettverket, så det finnes ikke noe utgangsrelé i den andre enden og ingen\nsiste strekning i klartekst. Vanlig `http://` mot en onion gir derfor en side som er\nkryptert hele veien, fra en vert som klienten har sjekket identiteten til mot navnet som\nble tastet inn.\n\nTjenesten ringer bare ut, til introduksjonspunktene og til hvert møtepunkt, så den\ntrenger ingen åpen innkommende nettverksport og virker bak NAT. Å legge til en onion\nendrer ikke listen over åpne nettverksporter på verten.\n\nLeserne må likevel få vite adressen. Et nettsted kan kunngjøre den med svarheaderen\n`Onion-Location`, og Tor Browser viser da en lilla pille i adressefeltet som fører til\nonion-kopien av siden. Tor-prosjektet stiller tre vilkår: verdien er en `http:`- eller\n`https:`-URL med en onion-vert, siden som sender den, kom over HTTPS, og den siden\nligger ikke selv på en onion. En meta-tagg kan bære den samme kunngjøringen der headere\nikke kan settes, men uten stien, så hver side peker på én fast URL.\n\n## Slik ser det ut i praksis\n\n[Hvordan selskapets onion-speil ble publisert på en lesbar adresse](/nb/portfolio/published-a-readable-tor-onion-mirror/)\ner beskrevet steg for steg. Daemonen kommer fra distribusjonens egen pakke, med\nnettverksporten for utgående proxy slått av. Den private nøkkelen bak adressen ble\ngenerert utenfor verten og har aldri havnet i repoet eller på en bærbar PC; rollen\nnekter å overskrive en identitet den ikke selv genererte, så en nøkkel som er plassert\nfor hånd, brukes som den er. Adressen er en deklarert verdi i inventaret, og hver\nconverge-kjøring kontrollerer at identitetsfilen på verten stemmer med den, så en byttet\nnøkkel med en utdatert deklarasjon stopper kjøringen. Begge hemmelighetsvaktene fanger\nnøkkelfilen, etter at en måling viste at det opplagte mønsteret for nøkkelfiler traff en\ndeploy-nøkkel og bommet på denne.\n\nEt lesbart prefiks kan finnes, men aldri velges. Hvert ekstra tegn ganger det forventede\nsøket med 32, så de åtte bokstavene i `engineer` krever i snitt ca. 1,1 billioner\nnøkkelpar, altså rundt 1 100 milliarder. Å pensjonere den tilfeldige adressen speilet\nførst ble levert med, var en trinnvis overgang, så den publiserte adressen svarte hele\ntiden. Ett steg så endelig ut uten å være det: nøkkelen kom på plass, converge-kjøringen\nmeldte ingen endring, og den nye adressen ble aldri publisert, fordi ingenting navnga\nkatalogen dens. Rollen feiler nå på enhver identitet på disk som ingen tjeneste navngir.\n\n[Kolofonen](/nb/credits/) skriver ut hele adressen,\n`engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion`, ved siden av adressene\nfor Gemini og Gopher. Onion-tjenesten leser de samme filene som de tre andre\ninngangsdørene, så onion-adressen holder takt med dem etter hver produksjonssetting. Det\nvanlige nettstedet sender `Onion-Location`, så Tor Browser tilbyr onion-adressen uten at\nleseren må be om den. Siden forklarer også hva leserens eget nettverk ser gjennom hver\ndør: over Gopher hvilken side som leses, over Gemini hvilken adresse det ble spurt\netter, over onion ingen av delene. Den kaller prefikset en bekvemmelighet og ikke et\nbevis, og ber leserne sammenligne hele adressen.\n\nAdressens oppbygning kan sjekkes uten nett. Disse linjene dekoder den og regner ut\nsjekksummen på nytt, og begge sammenligningene skriver ut `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\nEn gyldig sjekksum viser at adressen er riktig formet, ikke hvem den tilhører. Det får\ndu vite ved å lese den på selskapets egne HTTPS-sider.\n\n## Hvor det går galt\n\n**Nøkkelen er det eneste skjøtet.** Uten en registrar bak navnet betyr en tapt privat\nnøkkel en tapt adresse, og en kopiert nøkkel lar noen andre svare på den.\nTor-prosjektets oppsettsveiledning sier at nøkkelfilene skal holdes private, og at\nnøkkelen bør sikkerhetskopieres hvis tjenesten skal vare. Behandle den som en\nsigneringsnøkkel, ikke som konfigurasjon.\n\n**Bare de første bokstavene blir lest.** RFC 7686 advarer om at en angriper kan finne\nnøkler med navn som ligner det tiltenkte, og at risikoen er større fordi navnene ikke\nbetyr noe for et menneske. Den regner lesbare navn, kjøpt med betydelig regnekraft, som\nett mottiltak, men et prefiks på åtte tegn lar de andre 48 være like uleselige som før.\nSammenlign hele adressen, eller kom dit via et bokmerke eller en lenke på nettstedets\negne HTTPS-sider.\n\n**Serveren røper seg selv.** Tor skjuler hvor tjenesten kjører, men programvaren bak den\nkan fortsatt fortelle det. RFC 7686 regner en server som lekker identiteten sin i en\nmelding på applikasjonsnivå blant måtene vernet svikter på, og en feilside som skriver\nut maskinens virkelige vertsnavn, er et eksempel. Oppsettsveiledningen anbefaler også å\nsende trafikken til webserveren over en Unix-socket i stedet for TCP, så tjenesten ikke\nlekker ut på det lokale nettverket:\n\n```text\nHiddenServiceDir /var/lib/tor/my-website/\nHiddenServicePort 80 unix:/var/run/tor/my-website.sock\n```\n\nDet betyr mest der selve plasseringen er det som skal holdes skjult.\n\n**Navnet havner hos DNS.** Programvare som ikke snakker Tor, spør den vanlige resolveren\nom et onion-navn, og forteller dermed det lokale nettverket og DNS-leverandøren hvilken\nonion noen ville besøke. RFC 7686 sier at slik programvare skal feile uten å gjøre\noppslaget, og at DNS-servere skal svare at navnet ikke finnes. Gi navnet til\nTor-klienten i stedet.\n\n**En `Onion-Location`-pille som aldri dukker opp.** En header som bare settes på\nomdirigeringen over vanlig HTTP, bryter HTTPS-vilkåret, og en med feilskrevet adresse\nsender leserne ingen steder. Sjekk headeren på det endelige HTTPS-svaret.\n\n## Les mer\n\n- [Tor Rendezvous Specification, version 3](https://spec.torproject.org/rend-spec/) —\n  hele protokollen: identitetsnøkler og blindede nøkler, beskrivelser, introduksjon og\n  møtepunkt.\n- [Encoding onion addresses](https://spec.torproject.org/rend-spec/encoding-onion-addresses.html)\n  — formelen som gjør en offentlig nøkkel om til et navn på 56 tegn, med\n  eksempeladresser.\n- [How do Onion Services work?](https://community.torproject.org/onion-services/overview/)\n  — en gjennomgang steg for steg av introduksjonspunkter, beskrivelser og møtet mellom\n  klient og tjeneste.\n- [Set up Your Onion Service](https://community.torproject.org/onion-services/setup/) —\n  linjene i torrc, filene tor lager, og råd om nøkler og om lekkasjer av plassering.\n- [Onion-Location](https://community.torproject.org/onion-services/advanced/onion-location/)\n  — oppsett med header og meta-tagg for Apache, Nginx og Caddy, og vilkårene headeren må\n  oppfylle.\n- [RFC 7686](https://www.rfc-editor.org/rfc/rfc7686) — hvorfor `.onion` er reservert, og\n  hva resolvere, DNS-operatører og registrarer må gjøre med det.\n\n\u003chttps://engineer.company/nb/glossary/onion/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvordan onion-tjenester virker: adresse med kodet offentlig nøkkel, møtepunkt som skjuler begge ender, og hva operatøren må beskytte.","formats":{"gemtext":"https://engineer.company/nb/glossary/onion/index.gmi","gopher":"https://engineer.company/nb/glossary/onion/gophermap","html":"https://engineer.company/nb/glossary/onion/","json":"https://engineer.company/nb/glossary/onion/index.json","markdown":"https://engineer.company/nb/glossary/onion/index.md","pdf":"https://engineer.company/nb/glossary/onion/index.pdf"},"kind":"page","language":"nb","title":"Hva er en onion-tjeneste?","url":"https://engineer.company/nb/glossary/onion/","version":1}