bluewave-labs / bluewave-labs/Checkmate

Feature request: Add trusted proxy header authentication as an alternative to OIDC

Open
#3,442 1 comment 3 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
10.8k
Forks
1.2k
Avg merge
1d 4h
Merged PRs (30d)
68

Description

Feature request #1689 covers adding OIDC support for user authentication, which will be great when implemented.

As a step short of full OIDC support, it would also be useful for Checkmate to support optional trusted-header authentication for deployments behind an auth proxy such as [oauth2-proxy](https://github.com/oauth2-proxy/oauth2-proxy). This can be a simple and practical way to avoid setting up a direct OIDC integration in every deployment.

That would allow a trusted reverse proxy to handle OAuth/OIDC and pass user identity to Checkmate via headers such as `X-Forwarded-User`.

A good preexisting example of this kind of implementation is the `REMOTE_USER_HEADER` feature [supported by Healthchecks](https://github.com/healthchecks/healthchecks?tab=readme-ov-file#external-authentication).

Contributor guide

Open the contributing guide

Research direction

Start by locating Checkmate’s existing authentication entry point and reviewing the OIDC work referenced in issue #1689. Compare the requested trusted-header flow with oauth2-proxy and Healthchecks’ REMOTE_USER_HEADER example; done means an optional header-based authentication path with behavior covered by appropriate tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
authentication, backend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.