Practical Security Habits

Responsible Disclosure for Bugs You Find

How to report a flaw you find in someone else's product with care: what to record, who to contact, how long to wait and how to stay within the law.

On this page
  1. What responsible disclosure means
  2. Stay within what you are allowed to do
  3. Record what you found
  4. Find the right contact
  5. Writing the report
  6. After you send it
  7. Why it matters for makers

What responsible disclosure means

Sometimes a curious maker notices that a product does something it should not: a login that works without a password, a device that exposes private data, a website that returns another user’s records. Responsible disclosure, also called coordinated disclosure, is the practice of telling the people who can fix the problem first, privately, and giving them reasonable time to do so before the details become public.

The aim is to reduce harm. Publishing a flaw before a fix exists can give attackers a head start, while staying silent leaves everyone exposed to a problem someone else may find. Reporting quietly and constructively is usually the better path, though how it plays out is never guaranteed.

Stay within what you are allowed to do

This is the most important part. Examining a device you own, on your own network, is generally very different from probing a system that belongs to someone else. Accessing a server, account or data without permission can be unlawful in many places, even if your intentions are good and you did not intend to cause harm. Laws differ by country, and some also restrict reverse engineering or circumventing protections on products you own. This article is not legal advice. If you are unsure, get guidance from a qualified person before you test or report.

Some practical limits that keep you on safer ground:

  • Test only your own devices and accounts, or systems that explicitly invite testing.
  • Stop as soon as you confirm that a problem exists. Do not browse data, change settings or keep going to see how far it extends.
  • If you come across other people’s personal data, do not copy, keep or share it, and mention in your report that you saw it.
  • Never run anything that could disrupt a live service or other users, such as flooding it with requests.

Some organisations publish a policy that says what testing is allowed and promises not to take action against good-faith reporters. If one exists, read it and follow it carefully, since it defines your permissions.

Record what you found

Before you write to anyone, collect the facts calmly and keep them minimal:

  • The product, model and version, including the firmware or software version if you know it.
  • What you did, in clear numbered steps that someone else could follow.
  • What happened and why you think it is a security problem.
  • When you found it and what you used.
  • Your assessment of impact, written plainly and without exaggeration.

Screenshots or short logs can help. Remove any personal data from them first. Keep notes private, and avoid discussing the issue on forums or social media while it is being handled.

Find the right contact

Look for a security contact before using general support. Many vendors list a dedicated address, a reporting form or a “security.txt” file on their website, and some run a bug bounty or vulnerability disclosure programme. A bounty is a reward scheme, not a guarantee of payment, and each programme has its own rules about scope.

If the maker cannot be found or does not respond, there are national or coordinating bodies in some countries that act as intermediaries for vulnerability reports. Check what exists where you live. Open-source projects usually have a security policy file or a private reporting option on their code hosting page, which is better than opening a public issue.

Send your report over an encrypted channel if the contact offers one, and avoid including live passwords or secrets in the message.

Writing the report

Keep it short, polite and specific. Say who you are, what you found, how to reproduce it and what you would suggest as a fix, if you have a view. Do not make demands or threats. Avoid implying that you will go public unless paid, as that can look like extortion and may harm you legally.

State that you intend to keep the details private while the issue is addressed, and propose a reasonable timeline. Many reporters use a window of a few months, though practice varies and complex hardware fixes can take longer. Be willing to be flexible if the vendor is making real progress.

After you send it

Expect that the response may be slow, brief or absent. A short follow-up after a couple of weeks is reasonable. If the vendor engages, help by answering questions and testing a fix if asked. If they do not respond after repeated, patient attempts, you have options, such as asking a coordinating body for help. Think carefully before publishing details, and consider whether you could leave out specifics that make the problem easy to exploit. Some people seek advice from a lawyer or an advocacy organisation before going public.

Credit is something you can ask for but should not insist on. Fixes may be quiet, and a vendor may not wish to name you.

Why it matters for makers

Makers build and take apart connected things, so finding a flaw is not far-fetched, especially in cheap devices where default credentials or unencrypted traffic are common. Handling it well protects other users, and it also teaches you what a careful build looks like. Your own projects will have flaws too, so it helps to give your own users a clear way to reach you: a contact address in your repository, and a promise to take reports seriously. Doing so is a small step towards a safer ecosystem, and it spares users the harm that poorly handled reports can cause.

The complete guide to practical security habits

A Maker Guide to Securing Connected Projects
Read the guide

Keep exploring

Guides from other topics

All topics →