new ClientIdentity(This)
Returns a new instance of ClientIdentity
Parameters:
Name | Type | Description |
---|---|---|
This |
ChaincodeStub | is the stub object passed to Init() and Invoke() methods |
Example
const ClientIdentity = require('fabric-shim').ClientIdentity; let cid = new ClientIdentity(stub); // "stub" is the ChaincodeStub object passed to Init() and Invoke() methods if (cid.assertAttributeValue('hf.role', 'auditor')) { // proceed to carry out auditing }
Methods
-
assertAttributeValue(attrName, attrValue)
-
assertAttributeValue verifies that the invoking identity has the attribute named `attrName` with a value of `attrValue`.
Parameters:
Name Type Description attrName
string Name of the attribute to retrieve the value from the identity's credentials (such as X.509 certificate for PKI-based MSPs) attrValue
string Expected value of the attribute Returns:
True if the invoking identity possesses the attribute and the attribute value matches the expected value. Otherwise, returns false.- Type
- boolean
-
getAttributeValue(attrName)
-
getAttributeValue returns the value of the client's attribute named `attrName`. If the invoking identity possesses the attribute, returns the value of the attribute. If the invoking identity does not possess the attribute, returns null.
Parameters:
Name Type Description attrName
string Name of the attribute to retrieve the value from the identity's credentials (such as X.509 certificate for PKI-based MSPs). Returns:
Value of the attribute or null if the invoking identity does not possess the attribute.- Type
- string | null
-
getID()
-
getID returns the ID associated with the invoking identity. This ID is guaranteed to be unique within the MSP.
Returns:
A string in the format: "x509::{subject DN}::{issuer DN}"- Type
- string
-
getIDBytes()
-
getIDBytes returns the ID bytes associated with the invoking identity. If the MSP is implemented with X.509 certificates, then these ID bytes will be those of the X.509 certificate. If you wish to inspect the contents of the X.509 certificate, then you must use an X.509 parsing library (for example, jsrsasign or @fidm/x509) to decode these ID bytes.
Returns:
- Type
- Uint8Array
-
getMSPID()
-
Returns the MSP ID of the invoking identity.
Returns:
- Type
- string