Kong Ingress Controller: Deploying the KIC with no Enterprise license

Uses: Kong Gateway
TL;DR

Why do enterprise-only plugins like openid-connect fail to apply when deploying Kong Ingress Controller?

Enterprise-only plugins are rejected because no Enterprise license is loaded on the Gateway/data plane — this is different from an expired license, which does not block plugin creation. Redeploy the Enterprise license secret and restart the affected pods to resolve it.

Problem

While installing Kong Gateway with Kong Ingress Controller (KIC) and no Enterprise license present, we noticed that enterprise-only plugins (such as openid-connect) fail to apply.

When reviewing the logs, or the Kubernetes events for the affected resource, we can see a schema violation stating the plugin is enterprise-only, surfaced through one of two paths:

As an admission-webhook rejection when applying the resource:


Error from server: error when creating "plugin.yaml": admission webhook "validations.kong.konghq.com" denied the request: openid-connect is an enterprise only plugin

Or as a KongConfigurationApplyFailed Warning Event on the resource if the webhook path is bypassed:


Warning  KongConfigurationApplyFailed  ingress-controller  openid-connect is an enterprise only plugin

Note: this is specifically an absent-license symptom. An expired (but present) Enterprise license behaves differently — expired licenses do not block enterprise-only plugin creation the way an absent license does.

Cause

This occurs because no Enterprise license is loaded on the Gateway/data plane, so enterprise-only plugins are rejected.

Solution

We can first verify this by checking the startup logs for the proxy pod for licensing-related messages.

To resolve this, please redeploy the license and verify the steps.

Note: You will need to restart/delete/deploy the pods following the new license secret to see the effect.

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!