Actions20
- Configuration Actions
- System Actions
- Image Actions
- Generate Actions
- Config File Actions
Overview
This node interacts with a VyOS router via its HTTP API, specifically focusing on generating cryptographic keys and certificates. The "Generate" resource with the "Certificate Authority" operation allows users to create a certificate authority (CA) certificate. This is useful in scenarios where you need to establish your own CA for issuing and managing SSL/TLS certificates within a private network or infrastructure.
Practical examples include:
- Setting up an internal CA to issue certificates for internal services.
- Automating the creation of CA certificates as part of infrastructure-as-code workflows.
- Generating CA certificates for testing environments without relying on external CAs.
Properties
| Name | Meaning |
|---|---|
| CA Name | Name assigned to the certificate authority being generated. |
| Additional Fields | Collection of optional parameters: |
| - Key Size | Size of the key in bits. Options: 1024, 2048, 4096. |
| - Subject | Certificate subject distinguished name (e.g., CN=example.com,O=My Organization,C=US). |
| - Validity Days | Number of days the certificate will be valid. |
| - Format Output | Boolean flag indicating whether to format the output for better readability. |
Output
The node outputs JSON data representing the generated certificate authority details. This typically includes the CA certificate itself and associated metadata such as the key and validity information. If the output is formatted, it will be easier to read and interpret.
If binary data is involved (e.g., raw certificate files), it would be included in the output but this specific operation focuses on JSON-formatted certificate data.
Dependencies
- Requires access to a VyOS router configured to accept HTTP API requests.
- Needs an API authentication token or API key credential configured in n8n to authenticate with the VyOS API.
- The node expects the VyOS API base URL and SSL validation preferences to be set in the credentials.
Troubleshooting
Common Issues:
- Authentication failures due to incorrect or missing API credentials.
- Network connectivity issues preventing communication with the VyOS router.
- Invalid certificate subject format causing generation errors.
- Unsupported key sizes or types if options are misconfigured.
Error Messages:
- Errors related to HTTP request failures usually indicate connectivity or credential problems.
- Validation errors on input fields suggest incorrect property values (e.g., invalid subject DN).
Resolutions:
- Verify API credentials and permissions.
- Ensure the VyOS router is reachable from the n8n instance.
- Double-check the formatting of the subject string.
- Use supported key sizes and types as per the node's options.