Skip to content

docs: deepen access (RBAC + ABAC) guide#67

Merged
jlc488 merged 1 commit into
mainfrom
docs/deepen-access
Jun 3, 2026
Merged

docs: deepen access (RBAC + ABAC) guide#67
jlc488 merged 1 commit into
mainfrom
docs/deepen-access

Conversation

@jlc488
Copy link
Copy Markdown
Contributor

@jlc488 jlc488 commented Jun 3, 2026

EN

The flagship Access (RBAC + ABAC) guide was the one feature guide still at the old depth — it explained the code API but never showed how to set RBAC up. This brings it to the same beginner, step-by-step level as the rest of the overhaul.

  • plain-language RBAC vs ABAC intro + a mental-model diagram (user → direct/group roles → permissions; then the optional Policy layer)
  • NEW Step 1 "Set up roles & permissions" — console + REST tabs with the verified endpoints:
    • POST /permissions {code, description}
    • POST /roles {tenantId, code, name}
    • POST /roles/{id}/permissions/{permissionId} (grant)
    • POST /roles/{id}/users/{userId} (assign)
  • Step 2PermissionChecker.check + has* (with file path)
  • Step 3 — ABAC Policy bean + PolicyContext.builder + the check overload + evaluateDetailed + dry-run (kept, now framed as a step)
  • see-also cross-links

EN + KO. Restored the { #abac-policies } anchor on the renamed ABAC heading so the inbound links from tutorial.md and admin-console.md/.ko.md still resolve.

This completes the all-guides overhaul: tenancy, access, menus, audit, cache, bootstrap, config-sync, admin-console.

Verification: mkdocs build --strict — clean, no anchor/link warnings.

KO (한국어)

핵심 접근 제어(RBAC + ABAC) 가이드가 유일하게 옛 깊이로 남아 있었습니다 — 코드 API는 설명했지만 RBAC를 설정하는 법은 없었습니다. 전면 개편의 나머지와 같은 초보자용 step-by-step 수준으로 맞췄습니다.

  • 쉬운 말 RBAC vs ABAC 도입 + 개념 다이어그램(사용자 → 직접/그룹 역할 → 권한; 그다음 선택적 Policy 계층)
  • 신규 1단계 "역할·권한 설정" — 콘솔 + REST 탭, 검증된 엔드포인트:
    • POST /permissions {code, description}
    • POST /roles {tenantId, code, name}
    • POST /roles/{id}/permissions/{permissionId}(부여)
    • POST /roles/{id}/users/{userId}(배정)
  • 2단계PermissionChecker.check + has*(파일 경로 포함)
  • 3단계 — ABAC Policy 빈 + PolicyContext.builder + check 오버로드 + evaluateDetailed + dry-run(유지, 단계로 재구성)
  • 상호 링크

한/영. 이름이 바뀐 ABAC 헤딩에 { #abac-policies } 앵커를 복원해 tutorial.md·admin-console.md/.ko.md의 인바운드 링크가 계속 동작합니다.

이로써 전체 가이드 개편 완료: tenancy, access, menus, audit, cache, bootstrap, config-sync, admin-console.

검증: mkdocs build --strict — clean, 앵커/링크 경고 없음.

The flagship authorization guide was the one feature guide left at the old
depth — it explained the code API but never showed how to set RBAC up.
Bring it to the same beginner, step-by-step level as the rest.

- plain-language RBAC vs ABAC intro + a mental-model diagram
  (user -> direct/group roles -> permissions; then optional Policy)
- NEW Step 1 "Set up roles & permissions": console + REST tabs with the
  verified endpoints — POST /permissions {code,description},
  POST /roles {tenantId,code,name},
  POST /roles/{id}/permissions/{permissionId} (grant),
  POST /roles/{id}/users/{userId} (assign)
- Step 2 PermissionChecker.check + has* (file path)
- Step 3 ABAC Policy bean + PolicyContext.builder + the check overload +
  evaluateDetailed + dry-run (kept, framed as a step)
- see-also cross-links

EN + KO. Restored the { #abac-policies } anchor on the (renamed) ABAC
heading so the inbound links from tutorial.md and admin-console.md/.ko.md
still resolve.

Completes the all-guides overhaul: tenancy, access, menus, audit, cache,
bootstrap, config-sync, admin-console.

Verification: mkdocs build --strict clean, no anchor/link warnings.
@jlc488 jlc488 merged commit d24ee9f into main Jun 3, 2026
2 checks passed
@jlc488 jlc488 deleted the docs/deepen-access branch June 3, 2026 13:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant