Reveal URLs — Användarhandbok

Reveal URLs är ett litet webbläsartillägg (och Thunderbird-tillägg) som visar dig vart en länk i din e-post egentligen leder, så att du kan upptäcka en nätfiskelänk innan du klickar på den.

Den här handboken förklarar hur du installerar Reveal URLs och hur du använder det. För hur dina uppgifter hanteras, se sekretesspolicyn; för en teknisk översikt över hur tillägget är byggt, se arkitekturöversikten.

Har du hittat ett fel, en länk som flaggades felaktigt (eller missades), eller en webbmailvärd som borde stödjas? Rapportera det på Codeberg-ärendehanteringen.

Innehåll

Vad det gör och varför

Ett nätfiske-e-postmeddelande döljer en fientlig destination bakom förtroendeingivande länktext. Texten kan lyda paypal.com, medan länken i själva verket pekar mot paypa1.com eller någon annan snarlik värd. Den synliga texten kan ljuga; den verkliga destinationen kan inte göra det.

Reveal URLs läser varje länk i meddelandet du läser och visar dig dess verkliga destination. När värden som anges i länktexten inte stämmer överens med värden som länken faktiskt pekar mot, flaggar Reveal URLs det, så att avvikelsen är uppenbar innan du klickar.

Ett Gmail-meddelande med Reveal URLs aktivt: en vilseledande länk är rödmarkerad med sin verkliga spårningsdestination avslöjad ovanför länktexten, medan en ärlig länk visas i grönt.

Allt sker på din egen enhet. Reveal URLs skickar ingenting till oss eller till någon tredje part — det finns ingen server, ingen analys och ingen spårning. Se sekretesspolicyn för alla detaljer.

Webbläsare och e-postklient som stöds

Reveal URLs körs på:

En Safari-build levereras ännu inte; den är planerad för en senare fas.

På webbläsarmålen annoterar Reveal URLs länkar i din webbmail. I Thunderbird annoterar det länkarna i e-postmeddelandet du läser direkt i e-postklienten.

Installera

Från din webbläsares eller e-postklients butik (rekommenderas)

När det väl är publicerat installerar du Reveal URLs från butiken för din webbläsare eller e-postklient. Publiceringen är fortfarande på gång, så dessa listningar är den avsedda distributionsvägen snarare än fungerande länkar i dag:

Ladda en build själv (utvecklare och tidig testning)

Om du har byggt Reveal URLs från källkoden kan du ladda den uppackade builden direkt. Varje mål byggs med ett make-kommando och produceras under dist/<target>/:

make build-chrome        # produces dist/chrome
make build-edge          # produces dist/edge
make build-opera         # produces dist/opera
make build-firefox       # produces dist/firefox
make build-thunderbird   # produces dist/thunderbird

Ladda sedan den resulterande mappen:

Inställningssidan öppnas automatiskt första gången tillägget installeras.

Använda det

Direkt ur lådan annoterar Reveal URLs länkarna i meddelanden hos de inbyggda leverantörerna — ingen konfiguration krävs:

Annoteringen är avgränsad till meddelandetexten, så appens egen chrome — dess sidofält, skrivfönster och verktygsfält — lämnas orörd. I Thunderbird täcks hela det renderade e-postmeddelandet.

Reveal URLs annoterar ett Gmail-meddelande: varje länks verkliga destination visas på en egen rad ovanför länktexten, med en avvikande spårningslänk rödmarkerad och en ärlig länk i grönt.

De två avslöjningslägena

Du väljer hur den verkliga URL:en visas, under Avslöja URL:en på inställningssidan:

Markering av avvikelser

När värden som anges i en länks synliga text inte stämmer överens med värden som länken faktiskt pekar mot, flaggar Reveal URLs det som en avvikelse. Jämförelsen görs på det registrerbara domännamnet, så ett ärligt underdomän som mail.example.com för example.com flaggas inte, medan en snarlik som paypa1.com för paypal.com gör det.

Två relaterade inställningar styr detta:

Inställningssidan: lägesväljaren 'Avslöja URL:en', växeln 'Markera avvikande länkar', och fälten för avvikelse- och matchfärg.

Verktygsfältsknappen

I Chrome, Edge, Opera och Firefox är Reveal URLs-verktygsfältsikonen en snabb på/av-knapp — klicka på den för att växla annotering. När tillägget är avstängt visas en OFF-bricka på ikonen, och dess verktygstips talar om för dig om ett klick slår på eller av det. Ändringen träder i kraft i varje öppen flik samtidigt.

(Thunderbird har inte den här verktygsfältsknappen; använd istället växeln Aktivera på inställningssidan.)

Inställningssidan

Inställningssidan innehåller alla alternativ. Öppna den från din webbläsares tilläggssida (till exempel Detaljer → Tilläggsalternativ), eller så öppnas den automatiskt vid första installationen.

Förutom huvudbrytaren Aktivera och kontrollerna för Aktiva webbplatser (som tillämpas omedelbart) sparas ändringar med knappen Spara inställningar.

De nedre inställningarna: listan 'Ignorera dessa värdar', den maximala visade URL-längden, och de valfria fälten för teckenstorlek och -vikt för avslöjad URL och varningsbricka, ovanför knappen 'Spara inställningar'.

Aktiva webbplatser — lägga till din egen webbmail

Avsnittet Aktiva webbplatser, överst på inställningssidan, listar sidorna som Reveal URLs körs på och behållaren som rymmer varje meddelandetext.

Överst på inställningssidan: huvudbrytaren 'Aktivera Reveal URLs' och listan 'Aktiva webbplatser', där varje inbyggd leverantör visar sitt matchningsmönster, en växel 'Aktiverad', en växel 'Underramar' och sin meddelandetext-väljare.

Varje rad visar:

De inbyggda leverantörerna (Gmail, Outlook och Proton) kan stängas av och rikta om, men de kan inte tas bort.

För att lägga till din egen webbmailsida:

  1. Under Lägg till webbplats, ange en Matchnings-URL — ett matchningsmönster som https://mail.example.com/*.
  2. Ange en Meddelandetext-väljare — en CSS-väljare för behållaren som rymmer meddelandetexten, till exempel .message-body.
  3. Om meddelandetexten renderas inuti en underram, kryssa i Kör även inuti underramar.
  4. Klicka på Lägg till webbplats. Din webbläsare kommer att be om tillstånd att få åtkomst till den webbplatsen; bevilja det. Webbplatsen läggs till först när du beviljar tillståndet.

Ändringar här tillämpas omedelbart. Att ta bort en webbplats du har lagt till återkallar också dess tillstånd, så att Reveal URLs slutar få åtkomst till den.

Sekretess

Reveal URLs arbetar helt och hållet på din egen enhet. För att avslöja och kontrollera länkar läser det — endast inom sidan du tittar på — den synliga texten och destinationen för länkarna i meddelandet du läser, plus sidans färger (så att den avslöjade URL:en förblir läsbar). Detta läses medan sidan renderas; det lagras aldrig och överförs aldrig.

Det enda det lagrar är dina egna inställningar (såsom på/av, avslöjningsläge, färger, teckenstorlekar, din ignoreringslista och eventuella webbplatser du har lagt till). Dessa sparas i din webbläsares tilläggslagring. Om din webbläsares synkronisering är på kan dina inställningar synkroniseras mellan dina inloggade enheter, hanterat av din webbläsarleverantör — aldrig skickade till oss. Reveal URLs överför ingenting.

Se sekretesspolicyn för alla detaljer.

Felsökning

En länk avslöjas inte.

En inbyggd leverantör slutade fungera efter en omdesign.

Webbmailleverantörer ändrar sin sidkod då och då. Om en inbyggd leverantörs väljare inte längre stämmer efter en sådan ändring kan du korrigera det själv: redigera i Aktiva webbplatser den leverantörens meddelandetext-väljare till den nya behållaren.

Verktygstips-URL:en visas inte.

I läget verktygstips (titel) placeras den verkliga URL:en i länkens verktygstips, så att den endast visas när du för pekaren över länken. Om du hellre vill se URL:en utan att föra pekaren, växla Avslöja URL:en till läget inline.

Licens och källkod

Reveal URLs är fri programvara, licensierad under GNU Affero General Public License v3.0 (AGPL-3.0-only).