Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Use the ProtectData component

Encrypt and save string data to a file with the ProtectData component in the RPA Desktop Design Studio.

Before you begin

Role required: none

About this task

You can configure the properties for the ProtectData component. For more information about these properties, see Properties of the DPAPI components.

Procedure

  1. In the Toolbox pane, navigate to Security > DPAPI.

  2. Drag the ProtectData component to the Design surface.

  3. To configure the input fields, see Configure port properties.

  4. Connect the data and control ports of the ProtectData component to the corresponding ports of the other components as described in the following table.

Port typePurpose of connectionMandatory?
Data In \(Filename\)Passes the name of the file to which the encrypted string is saved from a previously executed component.Yes
Data In \(Data\)Passes the data to be encrypted from a previously executed component.Yes
Data In \(Optional Entropy\)The optional entropy provides additional security to the encrypted data from risks that make applications running under the same user vulnerable. Passes the entropy from a previously executed component.No. Connecting the port is optional.
Data In \(Scope\)Passes the scope of protection from a previously executed component.Yes
Data Out \(String\)Returns the encrypted string.

No. Connecting the port is optional.To execute the component, right-click the ProtectData component bar and click Run From Here.

To view the output, right-click the Return field and click Preview Data.

Control InPasses the control from a from a previously executed component.Yes
Control OutPasses the control to the next component.No
  1. To test the component, under the DESIGN tab, click Run.

Parent Topic:DPAPI