[Gap]: Configure platform identity doesn't list the redirect URIs to register on the IdP

未关闭 适合新手
#1,321 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
1/5
预计耗时
1-3 小时
新手友好度
85/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
javascript
领域
documentation

调研方向

更新 Okta 操作指南的第 5 步,列出控制台和 Stacklok CLI 的重定向 URI。从 Configure platform identity 页面开始,并查看部署页面上对 betterAuth.url 的说明;issue 还指出了 Console Helm values 页面以及 toolhive 的 pkg/auth/remote/config.go,以了解 CLI 端口。管理员能够识别这两个 URI,并理解控制台 URL 如何决定其重定向 URI,即为完成。

由索引模型根据 Issue 内容生成。

描述

documentation enhancement needs-triage
What needs documentation?

Configure platform identity has the reader create the console (web) and Stacklok CLI (native) OAuth clients, but never says which sign-in redirect URIs to register on them:

Client Redirect URI
Console <betterAuth.url>/api/auth/oauth2/callback/oidc
Stacklok CLI http://localhost:8666/callback, the CLI's default loopback port, adjustable with the console chart's CLI callback port value

Step 5 of the Okta walkthrough should list them, and the deployment page's betterAuth.url description could note that it determines the console's redirect URI.

Context and references
  • Console path: comes from the console's OIDC provider id (oidc) and the auth library's /api/auth/oauth2/callback/:providerId route.
  • CLI port: the default is DefaultCallbackPort = 8666 in toolhive pkg/auth/remote/config.go. The Console Helm values page mentions 8666 only in passing.
  • What we run ourselves: Stacklok's own Okta configuration registers exactly these URIs for production, staging and dev.
Use case

An admin setting up the IdP for a new install has to guess these values. A wrong or missing console redirect URI makes sign-in fail; one customer hit oAuth_code_missing while debugging their PoC login.

主要语言
JavaScript
星标
4
派生
4
平均合并
15 小时 37 分钟
30 天内合并 PR
79

环境准备

在 Codespaces 中打开

在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

stacklok/docs-website 的其他 Issue

查看 stacklok/docs-website 的全部 Issue

相似的 Issue

更多 JavaScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。