Use the UnProtectData component

Decrypt an encrypted string that is saved in a file with the UnProtectData component in the RPA Desktop Design Studio.

Before you begin

Role required: none

About this task

You can configure the properties for the UnProtectData 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 UnProtectData component to the Design surface.
3. To configure the input fields, see Configure port properties.
4. Connect the data and control ports of the UnprotectData component to the corresponding ports of the other components as described in the following table.

   Port type	Purpose of connection	Mandatory?
   Data In (Filename)	Passes the name of the file that saves the encrypted string from a previously executed component.	Yes
   Data In (Optional Entropy)	If the string is protected by entropy, you need to enter the entropy details to enable the component to access the data. Passes the entropy details 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 decrypted 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 In	Passes the control from a from a previously executed component.	Yes
   Control Out	Passes the control to the next component.	No

5. Optional: To test the component, under the DESIGN tab, click Run.