apache/pulsar · error · RuntimeException

Failed to create authentication: ${ex.message}

Error message

Failed to create authentication: ${ex.message}

What it means

ClientBuilderImpl.setAuthenticationFromPropsIfAvailable failed to construct the authentication plugin from the configured authPluginClassName/authParams — the plugin class could not be instantiated or configured, and the failure is wrapped with its message.

Source

Thrown at pulsar-client/src/main/java/org/apache/pulsar/client/impl/ClientBuilderImpl.java:214

        conf.setOriginalPrincipal(originalPrincipal);
        return this;
    }

    private void setAuthenticationFromPropsIfAvailable(ClientConfigurationData clientConfig) {
        String authPluginClass = clientConfig.getAuthPluginClassName();
        String authParams = clientConfig.getAuthParams();
        Map<String, String> authParamMap = clientConfig.getAuthParamMap();
        if (StringUtils.isBlank(authPluginClass) || (StringUtils.isBlank(authParams) && authParamMap == null)) {
            return;
        }
        try {
            if (StringUtils.isNotBlank(authParams)) {
                authentication(authPluginClass, authParams);
            } else if (authParamMap != null) {
                authentication(authPluginClass, authParamMap);
            }
        } catch (UnsupportedAuthenticationException ex) {
            throw new RuntimeException("Failed to create authentication: " + ex.getMessage(), ex);
        }
    }

    @Override
    public ClientBuilder operationTimeout(int operationTimeout, TimeUnit unit) {
        checkArgument(operationTimeout >= 0, "operationTimeout needs to be >= 0");
        conf.setOperationTimeoutMs(unit.toMillis(operationTimeout));
        return this;
    }

    @Override
    public ClientBuilder lookupTimeout(int lookupTimeout, TimeUnit unit) {
        conf.setLookupTimeoutMs(unit.toMillis(lookupTimeout));
        return this;
    }

    @Override
    public ClientBuilder ioThreads(int numIoThreads) {

View on GitHub (pinned to 820761864e)

Solutions

1. Verify the auth plugin class name and its parameters
2. Ensure the auth plugin jar is on the client classpath

When it happens

Trigger: Thrown at pulsar-client/src/main/java/org/apache/pulsar/client/impl/ClientBuilderImpl.java:214 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

• Authentication and authorization failures — expired tokens, bad credentials, and missing scopes.

AI-assisted analysis of apache/pulsar@820761864e (2026-09-06). Data as JSON: /api/errors/b1748e6031756435. Report an issue: GitHub.