GuideReference
TrainingSupportCommunity
Reference

dcp_​auth_​substring_​transformation

  • Property Manager name: Variable Substring Transformation
  • Behavior version: The v2023-01-05 rule format supports the dcp_​auth_​substring_​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 extracts a substring, for use in authenticating the client request.

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

OptionTypeDescriptionRequires
substring_​startstring

The zero-based index offset of the first character to extract. If the index is out of bound from the string's length, authentication may fail.

{"displayType":"string","tag":"input","type":"text"}
substring_​endstring

The zero-based index offset of the last character to extract, where -1 selects the remainder of the string. If the index is out of bound from the string's length, authentication may fail.

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