Skip to content

Commit 199769c

Browse files
committed
[FAB-12454] Document collection policy details
Document relation between private data collection policy and endorsement policy. Change-Id: Iefe560ea014d2c2838f7c1de365e2ac169fc3dbe Signed-off-by: David Enyeart <enyeart@us.ibm.com>
1 parent eaf62f5 commit 199769c

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

docs/source/private-data-arch.rst

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,16 @@ Collection definitions are composed of five properties:
2222

2323
* ``name``: Name of the collection.
2424

25-
* ``policy``: Defines the organization peers allowed to persist the collection
26-
data expressed using the ``Signature`` policy syntax, with each member being
27-
included in an ``OR`` signature policy list.
25+
* ``policy``: The private data collection distribution policy defines which
26+
organizations' peers are allowed to persist the collection data expressed using
27+
the ``Signature`` policy syntax, with each member being included in an ``OR``
28+
signature policy list. To support read/write transactions, the private data
29+
distribution policy must define a broader set of organizations than the chaincode
30+
endorsement policy, as peers must have the private data in order to endorse
31+
proposed transactions. For example, in a channel with ten organizations,
32+
five of the organizations might be included in a private data collection
33+
distribution policy, but the endorsement policy might call for any three
34+
of the organizations to endorse.
2835

2936
* ``requiredPeerCount``: Minimum number of peers that the endorsing peer must
3037
successfully disseminate private data to before the peer signs the

0 commit comments

Comments
 (0)