Skip to content

Add auth and docker documentation #348

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Add auth and docker documentation #348

wants to merge 1 commit into from

Conversation

milindl
Copy link
Contributor

@milindl milindl commented Jul 16, 2025

Improve documentatoin around OIDC and dockerization

@Copilot Copilot AI review requested due to automatic review settings July 16, 2025 12:54
@milindl milindl added the documentation Improvements or additions to documentation label Jul 16, 2025
@milindl milindl requested review from a team as code owners July 16, 2025 12:54
Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR improves documentation around OIDC authentication and Docker containerization for the confluent-kafka-javascript library. The changes provide clearer guidance on authentication methods and Docker setup best practices.

  • Enhanced OIDC documentation to clarify support for both client_credentials and jwt_bearer grant types
  • Rewrote Docker Alpine documentation with updated Node.js version and clearer instructions for handling platform-specific binaries

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
INTRODUCTION.md Updated OIDC authentication section to clarify grant types and add jwt_bearer documentation reference
examples/node-rdkafka/docker-alpine.md Complete rewrite of Docker documentation with modern Node.js version and better binary handling instructions
Comments suppressed due to low confidence (1)

examples/node-rdkafka/docker-alpine.md:1

  • [nitpick] The filename suggests this is Alpine-specific documentation, but the title and content now cover general Docker usage. Consider renaming the file to 'docker.md' or updating the title to reflect Alpine-specific content.
# Dockerfile for confluent-kafka-javascript

@@ -1102,7 +1102,10 @@ const producer = new Kafka().producer({
});
```

For a special case of OAuthBearer token authentication, where the token is fetched from an OIDC provider using the `client_credentials` grant type, the library provides a built-in callback, which can be set through just the configuration without any custom function required:
For a special case of OAuthBearer token authentication where the token is fetched from an OIDC provider using the `client_credentials` or `jwt_bearer` grant type, the library provides a built-in mechanism for authentication.
Copy link
Preview

Copilot AI Jul 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing comma after 'authentication'. Should be: 'For a special case of OAuthBearer token authentication, where the token is fetched from an OIDC provider using the client_credentials or jwt_bearer grant type, the library provides a built-in mechanism for authentication.'

Suggested change
For a special case of OAuthBearer token authentication where the token is fetched from an OIDC provider using the `client_credentials` or `jwt_bearer` grant type, the library provides a built-in mechanism for authentication.
For a special case of OAuthBearer token authentication, where the token is fetched from an OIDC provider using the `client_credentials` or `jwt_bearer` grant type, the library provides a built-in mechanism for authentication.

Copilot uses AI. Check for mistakes.

@sonarqube-confluent
Copy link

Passed

Analysis Details

0 Issues

  • Bug 0 Bugs
  • Vulnerability 0 Vulnerabilities
  • Code Smell 0 Code Smells

Coverage and Duplications

  • Coverage No coverage information (47.90% Estimated after merge)
  • Duplications No duplication information (2.00% Estimated after merge)

Project ID: confluent-kafka-javascript

View in SonarQube

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy