[auth] Support refresh tokens for OAuth

Abierto

#3,145 abierto el 23/9/2026 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad: 4/5
Tiempo estimado: 3-5 días
Aptitud para principiantes: 45/100

Tipo de issue: Nueva funcionalidad
Claridad: Bastante claro
Estado de actividad: Activo
Stack tecnológico: java
Área: api, authentication, backend

Línea de trabajo

The issue describes adding OAuth refresh token support to the ClickHouse Java client. Start by examining the existing authentication and connection handling code, likely in packages related to client configuration and HTTP/API communication. Look for where JWT tokens are currently managed and where token expiration errors are thrown. The solution involves designing a callback interface, a default implementation, and integrating this with the JDBC driver. Check for existing tests around authentication to understand the current behavior and add tests for the new refresh flow.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

area:integration client-api-v2 jdbc-v2

Description

ClickHouse Cloud supports JWT for Authentication. This opens a way to support OAuth 2.0. This standard is used to authenticate users for accessing service (and more). There is a thing called "Refresh token" that helps to reduce life of access token and avoid frequent user interactions. It is all needed because JWT is signed "key" to access something and by designed it cannot be invalidated in real time until it expires. So short TTL would solve problem of invalidating tokens faster but it creates problem of requesting new access token too frequently. Thus another "refresh" token comes into play - it is used to request next pair of access token / refresh token from authentication provider without user interaction. If user has no more access to resources / service it tries to reach then refresh fails.

There is a mostly standard procedure of getting tokens described here

Client should handled expired token error from ClickHouse Cloud and call the procedure.
Documentation should state that if operation has some timeout this refresh will make request to fail but anyway.

Design

there should be callback for token expiration errors. Just a callback that can be implemented by user
there should be a default callback implementation with own config that can do "standard" refresh. config should be prefixed with "ouath_refresh_".
when callback is not set exception is thrown to application
token refresh code should be usable to run in timer when application want to avoid expiration of a previous JWT (useful when need to have strict timeout on operation and handle auto-refresh)
there should be a solution for JDBC

Lenguaje dominante: Java
Estrellas: 1.6k
Forks: 637
Merge medio: 2 d 17 h
PR fusionados (30 d): 29