Secret - Unwrap
Type identifier:
secret:unwrapCategory: Secret Operations
Note: Unwrapped secrets are plain text and can pose security risks if mishandled.
Description
The Secret - Unwrap node extracts the plain text value from a wrapped secret. While most nodes that need secrets can accept wrapped values directly, this node is useful when you need the actual string value for custom processing.
Input Handles
Handle | Type | Description |
|---|---|---|
| secret (wrapped) | The wrapped secret to unwrap. |
Output Handles
Handle | Type | Description |
|---|---|---|
|
| The unwrapped plain text secret value. |
Configuration Options
This node has no additional configuration options.
Behaviour
- Receives the wrapped secret on the
secretinput - Outputs the plain text value on
unwrappedValue
Security Considerations
Warning: Unwrapped secrets are plain text strings.
Execution history does not include the plain-text value.
In Flows v2, unwrappedValue has the Sensitive trait. Its handle badge opens a source-declaration overlay on hover or keyboard focus. Run inspection shows the observed trait, not the secret, including in raw-output mode. Flow Result allows sensitive values in inline child results, but rejects them as the top-level Flow run result.
When to Use
Most nodes handle wrapped secrets automatically:
- Integration - HTTP: Accepts wrapped secrets for auth headers
- Integration - SMTP: Accepts wrapped secrets for passwords
- Integration - SQL Connect: Accepts wrapped secrets for connection strings
Use Secret - Unwrap only when:
- Building custom request bodies
- Performing string operations on credentials
- Interfacing with nodes that don't support wrapped secrets
Examples
Process a Value
- Secret - Get: Retrieve secret
- Secret - Unwrap: Get value
- Pass the value to a node that needs plain text; the secret remains unavailable in v2 run inspection
Token Validation
Flow:
- Secret - Get: Retrieve token (wrapped)
- Secret - Unwrap: Get plain value
- Data - Expression: Validate token format/expiry