GuideReference
TrainingSupportCommunity
Reference

dcp_​auth_​hmac_​transformation

  • Property Manager name: Variable Hash Transformation
  • Behavior version: The v2023-01-05 rule format supports the dcp_​auth_​hmac_​transformation behavior v1.0.
  • Rule format status: GA, stable
  • Access: Read/Write
  • Allowed in includes: No (temporarily)

The Internet of Things: Edge Connect product allows connected users and devices to communicate on a publish-subscribe basis within reserved namespaces. In conjunction with dcp​_auth​_variable​_extractor, this behavior affects how clients can authenticate themselves to edge servers, and which groups within namespaces are authorized to access topics. It transforms a source string value extracted from the client certificate and stored as a variable, then generates a hash value based on the selected algorithm, for use in authenticating the client request.

Note that you can apply this hash transformation, or either of the dcp​_auth​_regex​_transformation or dcp​_auth​_substring​_transformation behaviors.

OptionTypeDescriptionRequires
hash_​conversion_​algorithmenum

Specifies the hash algorithm.

{"displayType":"enum","options":["SHA256","MD5","SHA384"],"tag":"select"}
SHA256

Use SHA-256.

MD5

Use MD5.

SHA384

Use SHA-384.

hash_​conversion_​keystring

Specifies the key to generate the hash, ideally a long random string to ensure adequate security.

{"displayType":"string","tag":"input","type":"text"}