skillhub/docs/skillhub
XiaoSeS 5800d4ddbb docs(auth): document the provider adapter contract and Feishu operator setup
AGENTS.md and CONTRIBUTING.md both require docs updates when auth flows or
deployment config change; this batch changed both and touched no docs.

03-authentication-design.md described adding a provider as "branch on
registrationId inside CustomOAuth2UserService", which the
ProviderOAuth2UserService strategy supersedes. Rewrites that recipe:
register an OAuthClaimsExtractor bean per provider, add a
ProviderOAuth2UserService only when the userinfo response is non-standard,
and note that the login page needs no code change. Also records the
provider-side obligations that are easy to get wrong -- stable subject with
no fallback, emailVerified only on proven ownership, bounded remote calls,
no subject in logs -- and un-comments the config example, which still
listed GitLab as a future possibility.

faq.md told operators to delete "the github and gitlab blocks" to hide SSO
buttons. That advice was already incomplete and gets worse per provider, so
it now explains the config-driven mechanism: an empty client id keeps the
entry off the login page, no file edit needed.

09-deployment.md listed only the GitHub credentials. Adds GitLab and Feishu,
and flags a deployment trap: Feishu emails are admin-imported so
emailVerified is always false, and skillhub.access-policy.mode=EMAIL_DOMAIN
denies every unverified email, which would reject all Feishu logins.

Squares the Feishu logo viewBox. It was 407.87x324.19 while login-button
renders it in a square w-5 h-5 box, so the mark was distorted.

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-09-21 10:18:37 +08:00
..
.vitepress feat(suite): publish suites from multi-skill bundles 2026-09-17 11:16:39 +08:00
en docs(auth): document the provider adapter contract and Feishu operator setup 2026-09-21 10:18:37 +08:00
guide feat(cli): add Pi agent profile 2026-09-17 14:23:30 +08:00
public docs: update skill publish concept diagram (#363) 2026-04-30 11:23:22 +08:00
.gitignore docs: add VitePress bilingual documentation site (#208) 2026-04-02 13:43:55 +08:00
faq.md docs(auth): document the provider adapter contract and Feishu operator setup 2026-09-21 10:18:37 +08:00
index.md docs: add VitePress bilingual documentation site (#208) 2026-04-02 13:43:55 +08:00
introduction.md docs: add VitePress bilingual documentation site (#208) 2026-04-02 13:43:55 +08:00
package-lock.json chore(deps): resolve dependabot npm alerts 2026-08-24 16:08:07 +08:00
package.json chore(deps): resolve dependabot npm alerts 2026-08-24 16:08:07 +08:00
quickstart.md fix(platform): harden sessions, scanner recovery, and CLI guidance (#801) 2026-09-02 20:15:42 +08:00