End-to-end encryption is only as trustworthy as the public keys it uses. If someone could trick your app into using a fake key for a contact, they could read messages meant for that contact. Secbird protects against this in two ways: automatic verification through key transparency, and optional manual verification of key fingerprints. This article explains both.
Why verification matters
When you write to someone, your app encrypts the message with their public key. Imagine an attacker who manages to replace that key with one they control. Your app would encrypt the message to the attacker, who could read it and pass it on. This is called a man-in-the-middle attack. Verifying keys makes sure that the key you use really belongs to the person you are writing to.
Key transparency: automatic verification
Secbird publishes users' public keys in a key transparency log. The log has special properties:
- It is append-only: entries can be added but not silently changed or removed.
- It is publicly verifiable: apps can check that the key they receive is the same one recorded in the log for everyone else.
- Changes are visible: if a user's key changes, the change is recorded and can be detected.
When your app looks up a contact's key, it checks the key against the log. When your own app runs, it also checks that the log contains the correct keys for your address, so you would notice if someone tried to publish a fake key in your name.
What you will see
- Verified key: messages show a lock with a check mark. No action is needed.
- Key changed: if a contact's key changes, Secbird shows a notice the next time you write to them. Key changes are normal when someone resets their account, but you may want to confirm with them.
- Verification failed: Secbird shows a warning and asks before sending. Do not ignore this warning; contact the person through another channel.
Manual verification with fingerprints
For high-stakes conversations, such as with a lawyer, journalist or business partner, you can verify a contact's key yourself by comparing fingerprints. A fingerprint is a short code derived from the public key. If the fingerprint your app shows matches the one your contact sees for their own key, the key is genuine.
Step-by-step
- Open Contacts and select the contact.
- Go to Encryption and choose View fingerprint.
- Contact the person through a different trusted channel: in person, by phone or by video call.
- Ask them to open Settings → Encryption → Keys and read out their fingerprint.
- Compare it with the fingerprint on your screen, character by character, or scan their QR code if you are together.
- If they match, select Mark as verified.
From now on, your app will warn you if this contact's key ever changes.
Verifying your own key with others
Others may want to verify your key too. To find your fingerprint:
- Go to Settings → Encryption → Keys.
- Select your address.
- Read or share the fingerprint, or show the QR code.
Your fingerprint is not secret. You can include it on a business card or website so people can check it.
Keys from other OpenPGP users
When you import a public key for someone who does not use Secbird, it is not covered by Secbird's key transparency log. Always verify such keys manually before relying on them, especially if you received the key by email.
- Import the key under Contacts → select contact → Encryption → Import key.
- Compare the fingerprint with the contact through another channel.
- Mark it as verified.
When keys change
A contact's key may legitimately change if they:
- reset their account after losing their password;
- created a new address;
- updated to new key types.
If you have marked a contact as verified and their key changes, Secbird shows a prominent warning. Re-verify the new fingerprint before sending sensitive information.
Good habits
- Verify fingerprints in person or by voice for your most important contacts.
- Pay attention to warnings and never dismiss them automatically.
- Review your verified contacts occasionally under Contacts → Encryption.
- If you suspect your own account has been tampered with, review your sessions and devices and change your password.
To learn how encryption works more broadly, read how end-to-end encryption works, or see how to protect messages to people without encryption in sending encrypted email to anyone.