Skip to content

doc: ajouter la fiche RBAC GitLab et consolider la correspondance - #114

Merged
shikanime merged 1 commit into
mainfrom
docs/rbac-gitlab
Oct 14, 2026
Merged

shikanime merged 1 commit into
mainfrom
docs/rbac-gitlab

Conversation

@shikanime

@shikanime shikanime commented Oct 8, 2026 •

Copy link
Copy Markdown
Member

What

  • Ajoute docs/guide/rbac/gitlab.md : correspondance groupes Keycloak → niveaux d'accès GitLab, entrée associée dans la sidebar (section Droits fins RBAC outils)
  • Consolide la correspondance GitLab : les sections GitLab de docs/administration/roles.md et docs/guide/roles.md sont supprimées au profit d'un renvoi vers la fiche
  • La fiche absorbe le tableau des clés de configuration du plugin GitLab (avec les valeurs par défaut) et la capture des membres du groupe

Why

Le répertoire docs/guide/rbac/ couvrait tous les outils sauf GitLab. Les sections GitLab des pages roles répétait un mapping périmé (devops → Developer, avertissement 9.16.x « évoluera vers Invité ») contraire au code : apps/server-nestjs (gitlab.constants.ts, generateAccessLevelMapping) donne admin/devops → Maintainer, developer → Developer, readonly/security → Reporter, défaut sans groupe OIDC → Guest, flags admin/auditor GitLab pour les groupes plateforme. Une seule source de vérité : la fiche.

La purge est précisée conformément à purgeOrphanMembers : l'alignement des niveaux d'accès est systématique, la suppression des membres non tracés seulement si purge = enabled (sinon signalement dans les journaux).

References

Validation

  • pnpm build (vitepress v1.6.3) : build complete — le contrôle des liens morts couvre les renvois /guide/rbac/gitlab depuis les deux pages roles.
  • Mapping vérifié contre apps/server-nestjs/src/modules/gitlab/ : suffixes par défaut (gitlab.constants.ts L26-28), réduction au niveau le plus élevé et fallback Guest (generateAccessLevelMapping), Owner (addMissingOwnerMember), flags admin/auditor (generateAdminRoleMapping), purge conditionnelle (purgeOrphanMembers + helper n() de @cpn-console/hooks).
  • sidebar.json : JSON.parse OK, entrée GitLab présente.

@shikanime shikanime added the documentation Improvements or additions to documentation label Oct 8, 2026
@shikanime shikanime self-assigned this Oct 8, 2026
@shikanime shikanime linked an issue Oct 13, 2026 that may be closed by this pull request
3 tasks
@shikanime
shikanime marked this pull request as ready for review October 14, 2026 08:52
@shikanime
shikanime force-pushed the docs/rbac-gitlab branch 2 times, most recently from 8286afb to 5cd02dd Compare October 14, 2026 09:20
@shikanime shikanime changed the title docs: ajouter la fiche RBAC GitLab docs: ajouter la fiche RBAC GitLab et consolider la correspondance Oct 14, 2026
Comment thread docs/administration/roles.md Outdated
Comment thread docs/guide/rbac/gitlab.md Outdated
@shikanime shikanime changed the title docs: ajouter la fiche RBAC GitLab et consolider la correspondance doc: ajouter la fiche RBAC GitLab et consolider la correspondance Oct 14, 2026
Fiche guide/rbac/gitlab : mapping des niveaux selon apps/server-nestjs (gitlab.constants.ts, gitlab.utils.ts generateAccessLevelMapping) : admin/devops -> Maintainer, developer -> Developer, readonly/security -> Reporter, defaut sans groupe OIDC -> Guest, flags admin/auditor GitLab pour les groupes plateforme, tableau des cles de configuration avec les valeurs par defaut.

Consolidation : les sections GitLab des pages roles (administration + guide) repetaient un mapping perime (devops -> Developer) et l'avertissement 9.16.x obsolete ; suppression au profit d'un renvoi vers la fiche. La purge est precisee : suppression seulement si purge = enabled, sinon signalement dans les journaux.

Co-authored-by: Automata <automata@shikanime.studio>
Signed-off-by: William Phetsinorath <william.phetsinorath-open@interieur.gouv.fr>
Change-Id: I2efa5c8a54b0b54d13767fe4eb2ba15d6a6a6964
@shikanime
shikanime requested a review from a team October 14, 2026 12:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

🐛 [BUG] - Ajout section gitlab droits fins

2 participants