Download Plugin Schemas and Metadata for 3.15 (#7681)

Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com>

Author: kong-apiops

app/_data/plugins/referenceable_fields/3.15.json

@@ -503,6 +503,8 @@
     "config.redis.username"
   ],
   "http-log": [
+    "config.headers",
+    "config.headers.additionalProperties",
     "config.http_endpoint"
   ],
   "jwt-signer": [
@@ -714,6 +716,8 @@
   ],
   "opentelemetry": [
     "config.access_logs.endpoint",
+    "config.headers",
+    "config.headers.additionalProperties",
     "config.logs_endpoint",
     "config.metrics.endpoint",
     "config.traces_endpoint"

app/_schemas/gateway/plugins/3.15/Confluent.json

@@ -279,6 +279,14 @@
                       ],
                       "type": "object"
                     },
+                    "identity_pool_id": {
+                      "description": "The Confluent Cloud OAuth identity pool ID, sent as the `Confluent-Identity-Pool-Id` request header. Optional: if omitted, Confluent Cloud automatically maps an identity pool based on the token's claims.",
+                      "type": "string"
+                    },
+                    "logical_cluster_id": {
+                      "description": "The Confluent Cloud Schema Registry cluster ID, sent as the `target-sr-cluster` request header. Confluent Cloud requires this when `mode` is 'oauth2'.",
+                      "type": "string"
+                    },
                     "mode": {
                       "default": "none",
                       "description": "Authentication mode to use with the schema registry.",

app/_schemas/gateway/plugins/3.15/ConfluentConsume.json

@@ -218,6 +218,14 @@
                       ],
                       "type": "object"
                     },
+                    "identity_pool_id": {
+                      "description": "The Confluent Cloud OAuth identity pool ID, sent as the `Confluent-Identity-Pool-Id` request header. Optional: if omitted, Confluent Cloud automatically maps an identity pool based on the token's claims.",
+                      "type": "string"
+                    },
+                    "logical_cluster_id": {
+                      "description": "The Confluent Cloud Schema Registry cluster ID, sent as the `target-sr-cluster` request header. Confluent Cloud requires this when `mode` is 'oauth2'.",
+                      "type": "string"
+                    },
                     "mode": {
                       "default": "none",
                       "description": "Authentication mode to use with the schema registry.",
@@ -450,6 +458,14 @@
                             ],
                             "type": "object"
                           },
+                          "identity_pool_id": {
+                            "description": "The Confluent Cloud OAuth identity pool ID, sent as the `Confluent-Identity-Pool-Id` request header. Optional: if omitted, Confluent Cloud automatically maps an identity pool based on the token's claims.",
+                            "type": "string"
+                          },
+                          "logical_cluster_id": {
+                            "description": "The Confluent Cloud Schema Registry cluster ID, sent as the `target-sr-cluster` request header. Confluent Cloud requires this when `mode` is 'oauth2'.",
+                            "type": "string"
+                          },
                           "mode": {
                             "default": "none",
                             "description": "Authentication mode to use with the schema registry.",

app/_schemas/gateway/plugins/3.15/HttpLog.json

@@ -34,9 +34,11 @@
         },
         "headers": {
           "additionalProperties": {
-            "type": "string"
+            "description": "\nThis field is [referenceable](/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).",
+            "type": "string",
+            "x-referenceable": true
           },
-          "description": "An optional table of headers included in the HTTP message to the upstream server. Values are indexed by header name, and each header name accepts a single string.",
+          "description": "An optional table of headers included in the HTTP message to the upstream server. Values are indexed by header name, and each header name accepts a single string. \nThis field is [referenceable](/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).",
           "type": "object"
         },
         "http_endpoint": {

app/_schemas/gateway/plugins/3.15/KafkaConsume.json

@@ -223,6 +223,14 @@
                       ],
                       "type": "object"
                     },
+                    "identity_pool_id": {
+                      "description": "The Confluent Cloud OAuth identity pool ID, sent as the `Confluent-Identity-Pool-Id` request header. Optional: if omitted, Confluent Cloud automatically maps an identity pool based on the token's claims.",
+                      "type": "string"
+                    },
+                    "logical_cluster_id": {
+                      "description": "The Confluent Cloud Schema Registry cluster ID, sent as the `target-sr-cluster` request header. Confluent Cloud requires this when `mode` is 'oauth2'.",
+                      "type": "string"
+                    },
                     "mode": {
                       "default": "none",
                       "description": "Authentication mode to use with the schema registry.",
@@ -458,6 +466,14 @@
                             ],
                             "type": "object"
                           },
+                          "identity_pool_id": {
+                            "description": "The Confluent Cloud OAuth identity pool ID, sent as the `Confluent-Identity-Pool-Id` request header. Optional: if omitted, Confluent Cloud automatically maps an identity pool based on the token's claims.",
+                            "type": "string"
+                          },
+                          "logical_cluster_id": {
+                            "description": "The Confluent Cloud Schema Registry cluster ID, sent as the `target-sr-cluster` request header. Confluent Cloud requires this when `mode` is 'oauth2'.",
+                            "type": "string"
+                          },
                           "mode": {
                             "default": "none",
                             "description": "Authentication mode to use with the schema registry.",

app/_schemas/gateway/plugins/3.15/KafkaLog.json

@@ -205,6 +205,14 @@
                       ],
                       "type": "object"
                     },
+                    "identity_pool_id": {
+                      "description": "The Confluent Cloud OAuth identity pool ID, sent as the `Confluent-Identity-Pool-Id` request header. Optional: if omitted, Confluent Cloud automatically maps an identity pool based on the token's claims.",
+                      "type": "string"
+                    },
+                    "logical_cluster_id": {
+                      "description": "The Confluent Cloud Schema Registry cluster ID, sent as the `target-sr-cluster` request header. Confluent Cloud requires this when `mode` is 'oauth2'.",
+                      "type": "string"
+                    },
                     "mode": {
                       "default": "none",
                       "description": "Authentication mode to use with the schema registry.",

app/_schemas/gateway/plugins/3.15/KafkaUpstream.json

@@ -293,6 +293,14 @@
                       ],
                       "type": "object"
                     },
+                    "identity_pool_id": {
+                      "description": "The Confluent Cloud OAuth identity pool ID, sent as the `Confluent-Identity-Pool-Id` request header. Optional: if omitted, Confluent Cloud automatically maps an identity pool based on the token's claims.",
+                      "type": "string"
+                    },
+                    "logical_cluster_id": {
+                      "description": "The Confluent Cloud Schema Registry cluster ID, sent as the `target-sr-cluster` request header. Confluent Cloud requires this when `mode` is 'oauth2'.",
+                      "type": "string"
+                    },
                     "mode": {
                       "default": "none",
                       "description": "Authentication mode to use with the schema registry.",

app/_schemas/gateway/plugins/3.15/KonnectApplicationAuth.json

@@ -1052,7 +1052,7 @@
                       },
                       "ignore_signature": {
                         "default": [],
-                        "description": "Skip the token signature verification on certain grants: - `password`: OAuth password grant - `client_credentials`: OAuth client credentials grant - `authorization_code`: authorization code flow - `refresh_token`: OAuth refresh token grant - `session`: session cookie authentication - `introspection`: OAuth introspection - `userinfo`: OpenID Connect user info endpoint authentication.",
+                        "description": "Skip the token signature verification on certain grants. This is insecure and logs a warning; use it only for providers that publish no verification key. Grants: - `password`: OAuth password grant - `client_credentials`: OAuth client credentials grant - `authorization_code`: authorization code flow - `refresh_token`: OAuth refresh token grant - `session`: session cookie authentication - `introspection`: OAuth introspection - `userinfo`: OpenID Connect user info endpoint authentication.",
                         "items": {
                           "enum": [
                             "authorization_code",
@@ -2265,7 +2265,7 @@
                                 },
                                 "verify_signature": {
                                   "default": false,
-                                  "description": "When true, Kong cryptographically verifies the signature of the incoming subject token before exchanging it. This field should be left empty or set to `false` when this issuer is the same as the target issuer. Defaults to `false` for backward compatibility.",
+                                  "description": "When true, Kong cryptographically verifies the signature of the incoming subject token before exchanging it. Defaults to `false` for backward compatibility, which skips this local check; the token exchange request to the issuer still validates the subject token itself, so this is defense in depth, not the only safeguard. This field should be left empty or set to `false` when this issuer is the same as the target issuer.",
                                   "type": "boolean"
                                 }
                               },
@@ -2536,7 +2536,7 @@
                       },
                       "verify_signature": {
                         "default": true,
-                        "description": "Verify signature of tokens.",
+                        "description": "Verify the cryptographic signature of tokens. Disabling this skips verification for every token source, including tokens presented directly by clients (bearer); this is insecure for that path. To trust only tokens fetched from the identity provider for specific grants, use `ignore_signature` instead, which never affects bearer tokens.",
                         "type": "boolean"
                       }
                     },

app/_schemas/gateway/plugins/3.15/OpenidConnect.json

@@ -974,7 +974,7 @@
         },
         "ignore_signature": {
           "default": [],
-          "description": "Skip the token signature verification on certain grants: - `password`: OAuth password grant - `client_credentials`: OAuth client credentials grant - `authorization_code`: authorization code flow - `refresh_token`: OAuth refresh token grant - `session`: session cookie authentication - `introspection`: OAuth introspection - `userinfo`: OpenID Connect user info endpoint authentication.",
+          "description": "Skip the token signature verification on certain grants. This is insecure and logs a warning; use it only for providers that publish no verification key. Grants: - `password`: OAuth password grant - `client_credentials`: OAuth client credentials grant - `authorization_code`: authorization code flow - `refresh_token`: OAuth refresh token grant - `session`: session cookie authentication - `introspection`: OAuth introspection - `userinfo`: OpenID Connect user info endpoint authentication.",
           "items": {
             "enum": [
               "authorization_code",
@@ -2187,7 +2187,7 @@
                   },
                   "verify_signature": {
                     "default": false,
-                    "description": "When true, Kong cryptographically verifies the signature of the incoming subject token before exchanging it. This field should be left empty or set to `false` when this issuer is the same as the target issuer. Defaults to `false` for backward compatibility.",
+                    "description": "When true, Kong cryptographically verifies the signature of the incoming subject token before exchanging it. Defaults to `false` for backward compatibility, which skips this local check; the token exchange request to the issuer still validates the subject token itself, so this is defense in depth, not the only safeguard. This field should be left empty or set to `false` when this issuer is the same as the target issuer.",
                     "type": "boolean"
                   }
                 },
@@ -2458,7 +2458,7 @@
         },
         "verify_signature": {
           "default": true,
-          "description": "Verify signature of tokens.",
+          "description": "Verify the cryptographic signature of tokens. Disabling this skips verification for every token source, including tokens presented directly by clients (bearer); this is insecure for that path. To trust only tokens fetched from the identity provider for specific grants, use `ignore_signature` instead, which never affects bearer tokens.",
           "type": "boolean"
         }
       },

app/_schemas/gateway/plugins/3.15/Opentelemetry.json

@@ -55,9 +55,11 @@
         },
         "headers": {
           "additionalProperties": {
-            "type": "string"
+            "description": "\nThis field is [referenceable](/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).",
+            "type": "string",
+            "x-referenceable": true
           },
-          "description": "The custom headers to be added in the HTTP request sent to the OTLP server. This setting is useful for adding the authentication headers (token) for the APM backend.",
+          "description": "The custom headers to be added in the HTTP request sent to the OTLP server. This setting is useful for adding the authentication headers (token) for the APM backend. \nThis field is [referenceable](/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).",
           "type": "object"
         },
         "http_response_header_for_traceid": {