github.com/franono/tendermint@v0.32.2-0.20200527150959-749313264ce9/SECURITY.md (about)

     1  # Security
     2  
     3  ## Reporting a Bug
     4  As part of our [Coordinated Vulnerability Disclosure
     5  Policy](https://tendermint.com/security), we operate a [bug
     6  bounty](https://hackerone.com/tendermint).
     7  See the policy for more details on submissions and rewards, and see "Example Vulnerabilities" (below) for examples of the kinds of bugs we're most interested in.
     8  
     9  ### Guidelines 
    10  
    11  We require that all researchers:
    12  
    13  * Use the bug bounty to disclose all vulnerabilities, and avoid posting vulnerability information in public places, including Github Issues, Discord channels, and Telegram groups
    14  * Make every effort to avoid privacy violations, degradation of user experience, disruption to production systems (including but not limited to the Cosmos Hub), and destruction of data
    15  * Keep any information about vulnerabilities that you’ve discovered confidential between yourself and the Tendermint Core engineering team until the issue has been resolved and disclosed 
    16  * Avoid posting personally identifiable information, privately or publicly
    17  
    18  If you follow these guidelines when reporting an issue to us, we commit to:
    19  
    20  * Not pursue or support any legal action related to your research on this vulnerability
    21  * Work with you to understand, resolve and ultimately disclose the issue in a timely fashion 
    22  
    23  ## Disclosure Process 
    24  Tendermint Core uses the following disclosure process:
    25  
    26  1. Once a security report is received, the Tendermint Core team works to verify the issue and confirm its severity level using CVSS. 
    27  2. The Tendermint Core team collaborates with the Gaia team to determine the vulnerability’s potential impact on the Cosmos Hub. 
    28  3. Patches are prepared for eligible releases of Tendermint in private repositories. See “Supported Releases” below for more information on which releases are considered eligible. 
    29  4. If it is determined that a CVE-ID is required, we request a CVE through a CVE Numbering Authority. 
    30  5. We notify the community that a security release is coming, to give users time to prepare their systems for the update. Notifications can include forum posts, tweets, and emails to partners and validators, including emails sent to the [Tendermint Security Mailing List](https://berlin.us4.list-manage.com/subscribe?u=431b35421ff7edcc77df5df10&id=3fe93307bc).
    31  6. 24 hours following this notification, the fixes are applied publicly and new releases are issued. 
    32  7. Cosmos SDK and Gaia update their Tendermint Core dependencies to use these releases, and then themselves issue new releases. 
    33  8. Once releases are available for Tendermint Core, Cosmos SDK and Gaia, we notify the community, again, through the same channels as above. We also publish a Security Advisory on Github and publish the CVE, as long as neither the Security Advisory nor the CVE include any information on how to exploit these vulnerabilities beyond what information is already available in the patch itself. 
    34  9. Once the community is notified, we will pay out any relevant bug bounties to submitters. 
    35  10. One week after the releases go out, we will publish a post with further details on the vulnerability as well as our response to it. 
    36  
    37  This process can take some time. Every effort will be made to handle the bug in as timely a manner as possible, however it's important that we follow the process described above to ensure that disclosures are handled consistently and to keep Tendermint Core and its downstream dependent projects--including but not limited to Gaia and the Cosmos Hub--as secure as possible. 
    38  
    39  ### Example Timeline 
    40  The following is an example timeline for the triage and response. The required roles and team members are described in parentheses after each task; however, multiple people can play each role and each person may play multiple roles. 
    41  
    42  #### > 24 Hours Before Release Time
    43  
    44  1. Request CVE number (ADMIN) 
    45  2. Gather emails and other contact info for validators (COMMS LEAD) 
    46  3. Test fixes on a testnet  (TENDERMINT ENG, COSMOS ENG) 
    47  4. Write “Security Advisory” for forum (TENDERMINT LEAD) 
    48  
    49  #### 24 Hours Before Release Time
    50  
    51  1. Post “Security Advisory” pre-notification on forum (TENDERMINT LEAD) 
    52  2. Post Tweet linking to forum post (COMMS LEAD) 
    53  3. Announce security advisory/link to post in various other social channels (Telegram, Discord) (COMMS LEAD) 
    54  4. Send emails to validators or other users (PARTNERSHIPS LEAD) 
    55  
    56  #### Release Time
    57  1. Cut Tendermint releases for eligible versions (TENDERMINT ENG, TENDERMINT LEAD)
    58  2. Cut Cosmos SDK release for eligible versions (COSMOS ENG)
    59  3. Cut Gaia release for eligible versions (GAIA ENG)
    60  4. Post “Security releases” on forum (TENDERMINT LEAD)
    61  5. Post new Tweet linking to forum post (COMMS LEAD)
    62  6. Remind everyone via social channels (Telegram, Discord)  that the release is out (COMMS LEAD)
    63  7. Send emails to validators or other users (COMMS LEAD) 
    64  8. Publish Security Advisory and CVE, if CVE has no sensitive information (ADMIN) 
    65  
    66  #### After Release Time
    67  1. Write forum post with exploit details (TENDERMINT LEAD)
    68  2. Approve pay-out on HackerOne for submitter (ADMIN) 
    69  
    70  #### 7 Days After Release Time
    71  1. Publish CVE if it has not yet been published (ADMIN) 
    72  2. Publish forum post with exploit details (TENDERMINT ENG, TENDERMINT LEAD)
    73  
    74  ## Supported Releases
    75  The Tendermint Core team commits to releasing security patch releases for both the latest minor release as well for the major/minor release that the Cosmos Hub is running. 
    76  
    77  If you are running older versions of Tendermint Core, we encourage you to upgrade at your earliest opportunity so that you can receive security patches directly from the Tendermint repo. While you are welcome to backport security patches to older versions for your own use, we will not publish or promote these backports. 
    78  
    79  ## Scope
    80  The full scope of our bug bounty program is outlined on our [Hacker One program page](https://hackerone.com/tendermint). Please also note that, in the interest of the safety of our users and staff, a few things are explicitly excluded from scope:
    81  
    82  * Any third-party services 
    83  * Findings from physical testing, such as office access 
    84  * Findings derived from social engineering (e.g., phishing)
    85  
    86  ## Example Vulnerabilities 
    87  The following is a list of examples of the kinds of vulnerabilities that we’re most interested in. It is not exhaustive: there are other kinds of issues we may also be interested in! 
    88  
    89  ### Specification
    90  
    91  * Conceptual flaws
    92  * Ambiguities, inconsistencies, or incorrect statements
    93  * Mis-match between specification and implementation of any component
    94  
    95  ### Consensus
    96  
    97  Assuming less than 1/3 of the voting power is Byzantine (malicious):
    98  
    99  * Validation of blockchain data structures, including blocks, block parts, votes, and so on
   100  * Execution of blocks
   101  * Validator set changes
   102  * Proposer round robin
   103  * Two nodes committing conflicting blocks for the same height (safety failure)
   104  * A correct node signing conflicting votes
   105  * A node halting (liveness failure)
   106  * Syncing new and old nodes
   107  
   108  
   109  ### Networking
   110  
   111  * Authenticated encryption (MITM, information leakage)
   112  * Eclipse attacks
   113  * Sybil attacks
   114  * Long-range attacks
   115  * Denial-of-Service
   116  
   117  ### RPC
   118  
   119  * Write-access to anything besides sending transactions
   120  * Denial-of-Service
   121  * Leakage of secrets
   122  
   123  ### Denial-of-Service
   124  
   125  Attacks may come through the P2P network or the RPC layer:
   126  
   127  * Amplification attacks
   128  * Resource abuse
   129  * Deadlocks and race conditions
   130  
   131  ### Libraries
   132  
   133  * Serialization (Amino)
   134  * Reading/Writing files and databases
   135  
   136  ### Cryptography
   137  
   138  * Elliptic curves for validator signatures
   139  * Hash algorithms and Merkle trees for block validation
   140  * Authenticated encryption for P2P connections
   141  
   142  ### Light Client
   143  
   144  * Core verification 
   145  * Bisection/sequential algorithms
   146  
   147  
   148