---
sourceDocument: Yokohama Data and Automation
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Data and Automation

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Use the UnProtectData component

# Use the UnProtectData component {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

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](https://www.servicenow.com/docs/lNekB8HDfgMuLlGwofi6iw "Learn about the properties of the DPAPI components in RPA Desktop Design Studio.").

## Procedure

1. In the Toolbox pane, navigate to SecurityDPAPI.
2. Drag the UnProtectData component to the Design surface.
3. To configure the input fields, see [Configure port properties](https://www.servicenow.com/docs/d92L75lHSFmmidzeOPPgTw "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio.").
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.  
   {#use-security-dpapi-unprotectdata__table_jnw_jn1_krb__entry__3}

   | 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 |
   [ ]

   {#use-security-dpapi-unprotectdata__table_jnw_jn1_krb}
5. **Optional:** To test the component, under the DESIGN tab, click Run.

*[\>]: and then