Wren Linux

wren-linux / docs / opsec.md (as plain text)

Operations security (opsec): a practical guide

Operations security, "opsec", is the habit of thinking about what you want to keep private, who might want it, and how it could leak, and then closing the gaps that matter. Software helps, and Wren Linux does what it can, but most leaks come from habits: a reused password, a photo with a location in it, a laptop left open in a café, a name typed in the wrong window.

This guide is general. It applies whatever computer you use, and it points to the Wren Linux pieces that help where there are some. It doesn't make anyone safe on its own, and nothing here is legal advice. THREAT-MODEL.md says plainly what Wren Linux itself does and doesn't protect against.

Contents

  1. Start with a threat model
  2. Principles that apply everywhere
  3. Your laptop
  4. USB drives and other storage
  5. Networks: home, public Wi-Fi, VPNs and Tor
  6. Passwords and accounts
  7. Encryption, in plain words
  8. Private communication
  9. Web browsing
  10. Files, photos and metadata
  11. Identity and compartments
  12. Money
  13. Your phone
  14. Physical security
  15. People and social engineering
  16. Software you install
  17. Backups
  18. Travel and borders
  19. When something goes wrong
  20. Checklists

1. Start with a threat model

You can't protect everything from everyone, and trying makes life miserable and usually makes you careless somewhere. Instead, answer five questions, honestly, and write the answers down:

  1. What do I want to protect? Your money, your accounts, your messages, your location, who you talk to, a project, your identity behind a pseudonym, other people who trust you.
  2. Who might want it? A thief who takes laptops from cafés, a scammer, an abusive ex, an employer, a company that sells data, a stalker, a hacker group, a government. Each has very different abilities.
  3. How likely is it, and how bad would it be? A stolen laptop is likely and annoying; a leaked source could be dangerous to someone. Spend effort where likelihood times harm is highest.
  4. What can they actually do? A thief can take the hardware. A scammer can send convincing emails. A company can track you across websites. A government can demand records from your provider, or seize your devices.
  5. What am I willing to do about it? The best plan is one you will follow every day. A simpler plan you keep beats a perfect one you drop.

Review the answers when your life changes: a new job, a move, a relationship ending, travel, or something you start publishing.

Three rough levels, to place yourself:

2. Principles that apply everywhere

3. Your laptop

Encryption and power

Firmware and boot

bios.md goes through the settings one by one, with a checklist.

What runs on it

Radios, camera and microphone

Around you

Physical tampering

If someone could have the laptop alone for a while (a hotel room, a seized bag):

Getting rid of a laptop or disk

4. USB drives and other storage

5. Networks: home, public Wi-Fi, VPNs and Tor

What a network can see

Whoever runs the network you use (your home router, a café, your mobile provider, your internet provider) sees who you talk to, when and how much, even when the content is encrypted. Without extra steps they see:

Your home network

Public Wi-Fi

DNS

Every name you look up (example.org) is a small message, normally sent unencrypted to the network's own DNS server. Secure DNS (in the base) sends them encrypted to a resolver you choose and checks the answers. The resolver you choose then sees them instead, so choose one you trust.

VPNs: what they do and don't

A VPN sends all your traffic through an encrypted tunnel to the VPN company's server, which forwards it. Your local network and your internet provider see only "this person talks to a VPN"; websites see the VPN's address instead of yours.

Tor: what it does and doesn't

Tor sends your traffic through three volunteer relays, each knowing only the one before and after it. No single relay knows both who you are and where you go. Tor Browser (Wren Linux's extras/tor-browser.sh) is built so that all its users look alike.

Mobile networks

Your phone's mobile connection tells the provider where you are, all the time, with the phone's identity attached. See section 13.

6. Passwords and accounts

Good passwords, and how to keep them has this in more detail, with how strong random words are.

7. Encryption, in plain words

Encryption scrambles information so that only someone with the right key can read it. It comes in three main forms:

What encryption doesn't hide:

Keys and passphrases:

8. Private communication

9. Web browsing

Blending in

Hardening a browser and blending in pull in opposite directions. Sites can often recognise a browser from what makes it unusual: its settings, fonts, screen size and extensions. Wren Linux's Firefox is hardened, with its fingerprinting protection on, but its settings aren't common ones, so it doesn't make you look like everyone else. Tor Browser is built for that: everyone using it is meant to look alike. So to blend in, use Tor Browser, and leave it as it is: extensions, or a changed setting or window size, make you stand out. Check any browser at Cover Your Tracks.

10. Files, photos and metadata

Files carry information you didn't type:

What to do:

11. Identity and compartments

If you keep a pseudonym, a separate work identity, or an anonymous project apart from your name, most failures come from links between the two:

12. Money

13. Your phone

For many people the phone is the biggest risk: it is always on, always with you, full of apps that collect data, and it reports its location to the mobile network constantly.

14. Physical security

15. People and social engineering

Most break-ins start with a person being talked into something:

16. Software you install

17. Backups

18. Travel and borders

19. When something goes wrong

Decide some of this in advance; it's hard to think clearly in the moment.

A lost or stolen laptop or phone:

  1. If it was off and encrypted, the data is safe; if it was on or asleep, assume it may not be.
  2. Change the passwords of the accounts that were logged in on it, starting with email and the password manager.
  3. Sign it out remotely: most services list devices and sessions.
  4. Revoke keys that lived on it (ssh keys, a deploy key on GitHub, API tokens).
  5. Restore your data from backups onto a clean device.

An account broken into:

  1. Use recovery codes or the provider's recovery to get back in.
  2. Change the password, turn on (or reset) 2FA, sign out every session.
  3. Check the account's settings for things an attacker leaves behind: forwarding rules in email, added recovery addresses or phones, app passwords, connected apps.
  4. Warn your contacts if messages may have been sent in your name.
  5. Change the password anywhere else you used the same one (and stop doing that).

A device that may be compromised (it behaves strangely, it was out of your hands, you ran something suspicious):

  1. Stop typing passphrases into it.
  2. From a different, clean device, change the passwords that matter.
  3. Back up only your data (documents, not programs or settings), then reinstall the system from scratch. Wren Linux is built for that: reinstall Debian, run start.sh from your stick.

If you think you are being targeted by someone capable, get help from people who do this work. Organisations that support journalists and activists often run help lines.

20. Checklists

Set up once:

Every day:

Now and then:


Wren Linux pieces mentioned here, and what each does in detail: extras.md, the articles in extras/, install-base.md and THREAT-MODEL.md.