Skip to content
Explanation

Embargo Management Process Model

The specification governs

This page explains the design of the Vultron Protocol. It is informative: the normative text is the Vultron Protocol Specification. Where this page and the specification differ, the specification governs.

This section describes the Embargo Management (EM) process for Coordinated Vulnerability Disclosure (CVD).

For our purposes, an embargo is an informal agreement among peer CVD case Participants. The Participants agree not to publish information about a vulnerability until some future point in time relative to the report at hand. After an embargo expires, no restriction on publishing information about the vulnerability remains.

Reminder

Exploits are information about vulnerabilities too.

CVD case Participants must be able to propose, accept, and reject embargo timing proposals according to their individual needs. Participants may also want to agree that specific details about a vulnerability can be shared with other Participants or made public. Such content considerations are outside the scope of this documentation. We focus on the when of an embargo, not the what.

Embargo Definition

An embargo is an informal agreement among peer CVD case Participants to refrain from publishing information about a vulnerability until some future point in time.

In the Report Management (RM) model, each Participant has their own RM state. EM state is different: it is a property of the CVD case as a whole.

A CVD case SHALL NOT have more than one active embargo at a time.

Some multi-party CVD (MPCVD) cases have a vertical supply chain, as in the figure below. In a vertical supply chain, Vendors must wait for their upstream suppliers to produce fixes before they can act. Even then, the intent is that the embargo ends once as many Vendors as possible have had an adequate opportunity to produce a fix.

---
title: A Vertical Supply Chain
---
stateDiagram-v2
    direction LR
    v1: Originating<br/>Vendor
    v2: Vendor 2
    v3: Vendor 3
    v4: Vendor 4
    v5: Vendor 5
    v6: Vendor 6

    v1 --> v2
    v1 --> v3
    v2 --> v4
    v3 --> v5
    v2 --> v5
    v5 --> v6

CVD Embargoes Are Not NDAs

CVD embargoes are not Non-Disclosure Agreements (NDAs). An NDA (also known as a Confidentiality agreement) is a legally binding contract between parties. An NDA often includes a reward for compliance, a penalty for unauthorized disclosure, or both.

NDAs sometimes have a place in CVD processes. But most MPCVD embargoes move relatively quickly and at a large scale, and this makes per-case NDAs prohibitively difficult. As a result, we intentionally set aside NDA negotiation as beyond the scope of this proposal.

At first look, many bug bounty programs can appear to be outside our scope, because they are often structured as NDAs that reward compliance. For some bounty programs, the only penalty for non-compliance or early disclosure is the loss of the reward. For other programs, non-compliance can cause the loss of a promise of amnesty. That promise gives protection from civil or criminal charges that security or acceptable-use policy violations might otherwise bring.

Nevertheless, we are optimistic that the bulk of this protocol will be found compatible with the full variety of bounty-oriented CVD programs, now and in the future. This bulk consists of the parts of the protocol that do not interfere with the contractual provisions of bounty-associated NDAs.

EM states

An embargo moves through five states. The state belongs to the case as a whole, not to any one Participant.

State What it means
None No embargo is in force, and none has ever been agreed for this case.
Proposed At least one embargo has been proposed and not yet accepted or rejected, and none is in force.
Active An embargo is in force, and no change to it is open.
Revise An embargo is in force, and at least one change to it has been proposed but not yet accepted or rejected.
eXited The embargo has ended.

The EM formal model introduces the underlined-capital shorthand for these states (N, P, A, R, X).

State names

The Vultron Protocol Specification names two of the embargo states Revised and Exited (§7.1 States). The process-model pages call the same two states Revise and eXited, so that the capital letter in each name gives its one-letter shorthand, R and X. Both sets of names stay in use; they name the same states.

The embargo register

The EM state is not stored on its own. A case keeps an embargo register, with one entry for every embargo ever proposed on it. Each entry has a status: PROPOSED, ACTIVE, REJECTED, SUPERSEDED, CANCELLED or TERMINATED. The EM state is computed from the register.

The case is Proposed while proposals are open and no embargo is in force. The case is Active while one embargo is in force and no proposal is open. The case is Revise while one embargo is in force and at least one proposal is open. The case is eXited once the embargo in force is terminated. §7.1.1 The Embargo Register in the Vultron Protocol Specification gives the statuses, the rules every change to the register keeps, and the full derivation.

The register's statuses and the EM states share words, but not meanings. Register status ACTIVE means that one embargo is in force. EM Active means that the whole case has an embargo in force and no change to it is open.

Check which model a state name belongs to

An embargo can be Active while a report is Accepted. The EM and RM states are independent.

EM state transitions

Four actions move a case between EM states: propose, accept, reject and terminate. Each action changes the register. The change must move the EM state along one of the transitions drawn below. A change that would not move the EM state this way is refused.

---
title: Embargo Management State Diagram
---
stateDiagram-v2
    direction LR
    [*] --> None
    state Pre-Embargo {
        None --> Proposed : propose
        Proposed --> Proposed : propose
        Proposed --> Proposed : reject
        Proposed --> None : reject
    }
    state Active_Embargo {
        Active --> Revise : propose
        Revise --> Active : accept
        Revise --> Active : reject
        Revise --> Revise : propose
        Revise --> Revise : accept
        Revise --> Revise : reject
        Revise --> eXited : terminate
        Active --> eXited : terminate
    }
    state Post-Embargo {
        eXited
    }
    Proposed --> Active : accept
    Proposed --> Revise : accept
    eXited --> [*]

The diagram shows every move of the EM transition table. A self-loop on reject or accept is the move made while another proposal is still open, and accept from Proposed reaches Revise when the other open proposals become revisions of the embargo now in force.

  • Proposing an embargo when none exists moves the case to Proposed. A further proposal while one is outstanding is added beside it. Both proposals stay open.
  • Accepting a proposal makes the embargo Active. Any other open proposals stay open as changes to it, so the case moves to Revise instead. Rejecting a proposal returns the case to None once no other proposal is open.
  • Proposing a change to an active embargo moves the case to Revise. The existing embargo stays in force until a revision is accepted. Rejecting the revision returns the case to Active, with the old terms standing, not to None. The case stays at Revise while another revision is open.
  • An active embargo MUST eventually terminate, whether or not a revision is open. Termination moves the case to eXited and closes every open revision.

The normative transitions table is §7.2 Transitions and Guards in the Vultron Protocol Specification.

EM begins when the case is created

There is no EM phase before a case exists. A Reporter proposes terms by attaching them to the report they submit. Those terms are evaluated once the case is created. If nobody proposes anything, an embargo-eligible case still starts under a short protocol-default embargo. See Default Embargoes and ADR-0096: A Protocol Default Embargo Replaces the Pre-Case Phase.

The EM state says whether the case has an embargo. Whether each Participant has agreed to its current terms is a separate question. Participant Embargo Consent (PEC) tracks that question, with one consent row per Participant for each embargo in the register.

A Participant is bound when its row for the embargo in force says it agreed. A case can be Active while some Participants are not bound. A Participant who has been invited but not yet joined is not bound, and neither is a Participant who declined.

The two are linked at two points. When the Case Owner activates revised terms that end later than the ones in force, every Participant who had agreed to the old terms and not to the new ones has lapsed. Those Participants must agree again.

A revision that is only proposed changes nobody's consent. An activated revision that ends no later than the terms in force carries every Participant who agreed to the old terms over to the new ones.

When the case enters eXited, no embargo is in force, so nobody is bound. The termination writes no consent, and each Participant's rows stay as they were.

Embargo Lifecycle explains how the case and Participant scopes interact. The normative PEC states and transitions are §9 Participant Embargo Consent (PEC) State Machine in the Vultron Protocol Specification.

In this section

  • Embargo Principles — What an embargo is for, and the norms Participants follow while one is in force.
  • Default Embargoes — How published defaults and the protocol default start an embargo without a negotiation.
  • Negotiating Embargoes — When an embargo can be proposed, accepted or rejected, and how long it can reasonably last.
  • Adding Participants — Adding Participants to a case under embargo.
  • Early Termination — The events that end an embargo before its agreed time, how a termination records why it ended, and what happens when the end time passes.
  • Case Splits and Merges — What happens to embargoes when cases are split or merged.
  • EM Formal Model — The EM process as a formal state machine, with its grammar and every possible history.

Doing it on the wire