Decrypt
Category: Security
Node id: decrypt
Standards: HIPAA, SOC2
Decrypts AES-256-GCM encrypted data, supporting field-level and full-payload decryption
What it does
- AES-256-GCM authenticated decryption
- Auto-detection of encryption mode from upstream metadata
- Field-level and full-payload decryption
- Metadata-driven field list from encrypt node output
Use cases
- Decrypt PHI fields for authorized clinical data access
- Restore encrypted payloads for downstream processing
- Paired with encrypt node for end-to-end data protection
Runtime
- Performance tier:
fast
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
result | json | No | Encrypted output from an encrypt node (full or field mode) |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
result | json | No | Decrypted output: full-mode returns decrypted_data string; field-mode returns the data object with named fields decrypted in place plus _decrypted_fields metadata |
success | boolean | No | Whether decryption succeeded |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Decryption Mode | mode | enum | No | "" | field, full | Decryption mode (auto-detected from input if not set) |
Auth
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Encryption Key | encryption_key | secret | Yes | AES-256 key (32 bytes, base64-encoded or raw) |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Fields to Decrypt | fields | array | No | List of field names to decrypt (overrides metadata) |
Errors
| Code | Description |
|---|---|
INVALID_KEY | Decryption key is not 32 bytes (256 bits) |
DECRYPTION_FAILED | AES-256-GCM decryption failed (wrong key or corrupted data) |
MISSING_ENCRYPTED_DATA | No encrypted data provided for decryption |
Runtime notes
- Auto-detects encryption mode from input metadata (_encryption_mode) or falls back to config
- Field-mode removes _encrypted_fields and _encryption_mode metadata, adds _decrypted_fields list
- Full-mode returns decrypted_data as a string — parse it as JSON downstream if the original was an object
- Must use the same AES-256 key that was used for encryption
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
Something unclear? Send documentation feedback by email.