---
title: Use the UnProtectData component
description: Decrypt an encrypted string that is saved in a file with the UnProtectData component in the RPA Desktop Design Studio.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/integrate-applications/use-security-dpapi-unprotectdata.html
release: australia
topic_type: task
last_updated: "2026-03-12"
reading_time_minutes: 1
breadcrumb: [DPAPI, Security, Automation components, RPA Desktop Design Studio, Robotic Process Automation \(RPA\) Hub, Workflow Data Fabric]
---

# 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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/properties-of-dpapi-components.md).

## 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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/configure-input-port-properties.md).

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.

<table id="table_jnw_jn1_krb"><thead><tr><th>

Port type

</th><th>

Purpose of connection

</th><th>

Mandatory?

</th></tr></thead><tbody><tr><td>

Data In \(Filename\)

</td><td>

Passes the name of the file that saves the encrypted string from a previously executed component.

</td><td>

Yes

</td></tr><tr><td>

Data In \(Optional Entropy\)

</td><td>

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.

</td><td>

No. Connecting the port is optional.

</td></tr><tr><td>

Data In \(Scope\)

</td><td>

Passes the scope of protection from a previously executed component.

</td><td>

Yes

</td></tr><tr><td>

Data Out \(String\)

</td><td>

Returns the decrypted string.

</td><td>

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**.

</td></tr><tr><td>

Control In

</td><td>

Passes the control from a from a previously executed component.

</td><td>

Yes

</td></tr><tr><td>

Control Out

</td><td>

Passes the control to the next component.

</td><td>

No

</td></tr></tbody>
</table>5.  To test the component, under the **DESIGN** tab, click **Run**.


**Parent Topic:**[DPAPI](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/dpapi.md)