mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node operation retrieves a public key from the Marketplace resource, specifically for extensions. It allows users to fetch a public key by specifying its serial identifier or requesting the latest one. The public key can be used for purposes such as verifying webhooks or session tokens, which are common scenarios in secure integrations and API communications.

Practical examples include:

  • Verifying incoming webhook requests by fetching the current public key used for signature validation.
  • Obtaining the public key for session token verification to ensure secure authentication flows.

Properties

Name Meaning
Serial The serial ID of the specific public key to retrieve. Use latest to get the most recent key.
Purpose The intended use of the public key. Options: webhook (for webhook verification), session_token (for session token verification).
Format The format in which the public key is returned. Options: raw (base64 encoded raw key), spki (Subject Public Key Info format).

Output

The node outputs JSON data containing the requested public key in the specified format. The exact structure depends on the API response but generally includes the public key string corresponding to the given serial and purpose.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The base URL for API requests is https://api.mittwald.de.
  • The node uses standard HTTP headers accepting and sending JSON content.

Troubleshooting

  • Invalid Serial: If the provided serial does not exist, the API may return an error. Ensure the serial is correct or use latest to get the newest key.
  • Incorrect Purpose: Using an unsupported purpose value might cause the request to fail. Use only webhook or session_token.
  • Format Issues: Requesting an unsupported format could lead to errors. Use either raw or spki.
  • Authentication Errors: Missing or invalid API credentials will prevent successful requests. Verify that the API key credential is correctly configured.
  • Network Issues: Connectivity problems to the API endpoint will cause failures; check network access and proxy settings if applicable.

Links and References

  • mittwald mStudio API Documentation (general reference for API endpoints and usage)
  • Webhook security best practices (for understanding the use of public keys in webhook verification)

Discussion