Schema Validation Consume

Validate messages for a topic

Ensure that all messages consumed from a topic are validated against a schema, and skip messages that don’t conform.

Prerequisites

A schema registry configured in the Event Gateway control plane.

Set up the policy

curl -X POST https://{region}.api.konghq.com/v1/event-gateways/{eventGatewayId}/virtual-clusters/{virtualClusterId}/consume-policies \
    --header "accept: application/json" \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer $KONNECT_TOKEN" \
    --data '
    {
      "name": "validate-all-messages",
      "type": "schema_validation",
      "condition": "context.topic.name == \"my_topic\"",
      "config": {
        "type": "confluent_schema_registry",
        "schema_registry": {
          "name": "my-schema-registry"
        },
        "value_validation_action": "skip"
      }
    }
    '

Copied!

Make sure to replace the following placeholders with your own values:

region: Geographic region where your Kong Konnect is hosted and operates.
KONNECT_TOKEN: Your Personal Access Token (PAT) associated with your Konnect account.
virtualClusterId: The id of the Virtual Cluster.
eventGatewayId: The id of the Event Gateway.
eventGatewayListenerId: The id of the Event Gateway Listener.

See the Konnect Event Gateway API reference to learn about region-specific URLs and personal access tokens.

Prerequisite: Configure your Personal Access Token

terraform {
  required_providers {
    konnect-beta = {
      source  = "kong/konnect-beta"
    }
  }
}

provider "konnect-beta" {
  personal_access_token = "$KONNECT_TOKEN"
  server_url            = "https://us.api.konghq.com/"
}

Copied!

resource "konnect_event_gateway_consume_policy_schema_validation" "my_virtual_cluster_policy_schema_validation" {
  provider = konnect-beta
  type = "schema_validation"
  condition = "context.topic.name == \"my_topic\""
  config = {
    type = "confluent_schema_registry"

    schema_registry = {
      name = "my-schema-registry"
    }
    value_validation_action = "skip"
  }


  virtual_cluster_id = konnect_event_gateway_virtual_cluster.my_virtual_cluster.id

  gateway_id = konnect_event_gateway.my_event_gateway.id
}

Copied!

Schema Validation Consume

Validate messages for a topic

Prerequisites

Set up the policy

Help us make these docs great!

Still need help