Aller au contenu principal

Key Management

Category: Security
Node id: key-management

Standards: HIPAA, SOC2

Manages cryptographic key lifecycle including generation, rotation, retrieval, deletion, and export

What it does​

  • Six key lifecycle operations: generate, rotate, retrieve, delete, list, export
  • AES-128, AES-256, RSA-2048, RSA-4096 key types
  • Key rotation with version tracking and expiration
  • Export in JSON, PEM, and DER formats
  • Key status filtering and metadata management

Use cases​

  • Generate encryption keys for PHI data protection
  • Rotate keys on a scheduled basis for compliance
  • Export keys for cross-system integration
  • Manage key lifecycle for HIPAA encryption requirements

Runtime​

  • Performance tier: fast

Input ports​

NameTypeRequiredDescription
key_idtextNoKey identifier for operations that target an existing key
authorizedanyNoWhether the requester is authorized for the operation

Output ports​

NameTypeRequiredDescription
resultjsonNoKey operation result with operation, key_id, key_data/key_metadata (generate), keys/count (list), export_package (export), and message
successbooleanNoWhether the key operation succeeded

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
OperationoperationenumYesgenerategenerate, rotate, retrieve, delete, list, exportKey management operation to perform
Key Typekey_typeenumNoaes-256aes-256, aes-128, rsa-2048, rsa-4096Type of cryptographic key
Key IDkey_idstringNoIdentifier for the key (auto-generated if empty)
PurposepurposestringNoencryptionIntended use of the key

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Rotation Daysrotation_daysnumberNo90min 1; max 365Key rotation period in days
Immediate DeleteimmediatebooleanNofalseDelete key immediately instead of scheduling
Status FilterstatusstringNoallFilter keys by status (list operation)
Export FormatformatenumNojsonjson, pem, derKey export format
Key VersionversionnumberNo0Specific key version to retrieve

Errors​

CodeDescription
KEY_NOT_FOUNDThe specified key ID does not exist
INVALID_OPERATIONThe specified key management operation is not recognized
KEY_GENERATION_FAILEDFailed to generate cryptographic key material
UNAUTHORIZEDRequester is not authorized for this key operation

Runtime notes​

  • result shape varies by operation — generate includes key_data, list includes keys array, rotate includes old/new versions
  • Unauthorized requests return success=false with an error message in result, not a Go error
  • key_data for AES keys is base64-encoded; RSA keys return a placeholder pending vault integration
  • list operation supports status and purpose filters; defaults to returning all keys

See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.

Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.