Skip to content

Commit 383e5df

Browse files
committed
[FAB-12269] FAQ Update
Include reference to Private data in the Security topic Change-Id: I24aee331c165599e5513c6a840a10ba067bc88a2 Signed-off-by: pama-ibm <pama@ibm.com>
1 parent 07f2e9b commit 383e5df

File tree

1 file changed

+17
-18
lines changed

1 file changed

+17
-18
lines changed

docs/source/Fabric-FAQ.rst

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -32,15 +32,19 @@ Security & Access Control
3232
that are authorized to see the data for the chaincodes that are deployed to
3333
that channel.
3434

35-
Second, within a channel you can restrict the input data to
36-
chaincode to the set of endorsers only, by using visibility settings. The
37-
visibility setting will determine whether input and output chaincode data is
38-
included in the submitted transaction, versus just output data.
39-
40-
Third, you can hash or encrypt the data before calling chaincode. If you hash
41-
the data then you will need to provide a means to share the source data. If
42-
you encrypt the data then you will need to provide a means to share the
43-
decryption keys.
35+
Second, you can use `private-data <private-data/private-data.html>`_ to keep ledger data private from
36+
other organizations on the channel. A private data collection allows a
37+
defined subset of organizations on a channel the ability to endorse, commit,
38+
or query private data without having to create a separate channel.
39+
Other participants on the channel receive only a hash of the data.
40+
For more information refer to the :doc:`private_data_tutorial` tutorial.
41+
Note that the key concepts topic also explains `when to use private data instead of a channel <private-data/private-data.html#when-to-use-a-collection-within-a-channel-vs-a-separate-channel>`_.
42+
43+
Third, as an alternative to Fabric hashing the data using private data,
44+
the client application can hash or encrypt the data before calling
45+
chaincode. If you hash the data then you will need to provide a means to
46+
share the source data. If you encrypt the data then you will need to provide
47+
a means to share the decryption keys.
4448

4549
Fourth, you can restrict data access to certain roles in your organization, by
4650
building access control into the chaincode logic.
@@ -53,15 +57,10 @@ Security & Access Control
5357

5458
:Answer:
5559
No, the orderers only order transactions, they do not open the transactions.
56-
If you do not want the data to go through the orderers at all, and you are
57-
only concerned about the input data, then you can use visibility settings. The
58-
visibility setting will determine whether input and output chaincode data is
59-
included in the submitted transaction, versus just output data. Therefore,
60-
the input data can be private to the endorsers only. If you do not want the
61-
orderers to see chaincode output, then you can hash or encrypt the data before
62-
calling chaincode. If you hash the data then you will need to provide a means
63-
to share the source data. If you encrypt the data then you will need to
64-
provide a means to share the decryption keys.
60+
If you do not want the data to go through the orderers at all, then utilize
61+
the private data feature of Fabric. Alternatively, you can hash or encrypt
62+
the data in the client application before calling chaincode. If you encrypt
63+
the data then you will need to provide a means to share the decryption keys.
6564

6665
Application-side Programming Model
6766
----------------------------------

0 commit comments

Comments
 (0)