Lab 04 : Gestion des accès avec RBAC et des kubeconfigs dédiés
Objectifs
Section intitulée « Objectifs »À l’issue de ce lab, vous serez capable de :
- créer un Role et un RoleBinding qui donnent tous les droits sur un seul namespace ;
- créer un ClusterRole et un ClusterRoleBinding qui donnent un accès en lecture seule au cluster, sans accès aux Secrets ;
- générer avec octl des kubeconfigs dédiés à un utilisateur et à un groupe, avec une durée de validité limitée ;
- vérifier l’identité et les droits d’un kubeconfig avec
kubectl auth whoamietkubectl auth can-i; - protéger les fichiers kubeconfig sur votre poste.
Architecture du lab
Section intitulée « Architecture du lab »Dans ce lab, vous travaillez dans le cluster oks-lab01-cluster créé au Lab 01.
Le kubeconfig du Lab 01 vous donne un accès administrateur au cluster. Dans ce lab, vous l’utilisez pour créer des règles RBAC (Role-Based Access Control), puis vous générez deux nouveaux kubeconfigs avec des droits limités :
oks-lab04-dev-admin-kubeconfig.yaml, pour le groupenamespace-admin: tous les droits, mais uniquement dans le namespaceoks-lab04-dev;oks-lab04-readonly-kubeconfig.yaml, pour l’utilisateuruser1du groupereadonly-users: lecture seule sur les principales ressources du cluster, sans les Secrets.
Kubernetes ne gère pas de comptes utilisateurs : l’identité est portée par le certificat client du kubeconfig. Lors de la génération, OKS inscrit dans ce certificat le nom d’utilisateur (--user) et le groupe (--group). Les règles RBAC s’appliquent ensuite à ce nom et à ce groupe.
Prérequis
Section intitulée « Prérequis »Avant de commencer, vous devez disposer :
- du cluster
oks-lab01-clusterà l’étatready, avec ses NodePools, créé dans le Lab 01 ; - du fichier
oks-lab01-kubeconfig.yamlrécupéré dans le Lab 01 ; - de kubectl (version
1.28ou ultérieure) et octl installés et configurés (Lab 01).
Le lab utilise la région eu-west-2.
1. Préparer l’environnement
Section intitulée « 1. Préparer l’environnement »1.1 Accéder au cluster en administrateur
Section intitulée « 1.1 Accéder au cluster en administrateur »-
Placez-vous dans le répertoire qui contient le fichier
oks-lab01-kubeconfig.yaml, puis indiquez à kubectl de l’utiliser :Terminal window export KUBECONFIG=$PWD/oks-lab01-kubeconfig.yamlRemarque : si vous avez supprimé ce fichier, récupérez-le de nouveau :
Terminal window (umask 077; octl kube cluster kubeconfig oks-lab01-cluster --project oks-lab01-project > oks-lab01-kubeconfig.yaml) -
Affichez l’identité portée par ce kubeconfig :
Terminal window kubectl auth whoamiExemple de sortie :
ATTRIBUTE VALUEUsername cluster-adminGroups [system:authenticated]Le certificat porte l’utilisateur
cluster-admin. Il n’appartient à aucun groupe particulier (system:authenticatedregroupe tous les utilisateurs authentifiés) : ce sont les règles RBAC créées par OKS pour l’utilisateurcluster-adminqui lui donnent tous les droits sur le cluster.
1.2 Créer le namespace et une application de test
Section intitulée « 1.2 Créer le namespace et une application de test »-
Créez le namespace
oks-lab04-dev:Terminal window kubectl create namespace oks-lab04-dev -
Lancez un Pod de test dans ce namespace :
Terminal window kubectl run oks-lab04-nginx --image=nginx -n oks-lab04-dev
2. Créer les règles RBAC
Section intitulée « 2. Créer les règles RBAC »Les règles RBAC reposent sur deux types d’objets :
- un Role (limité à un namespace) ou un ClusterRole (valable dans tout le cluster) liste des droits : des verbes (
get,list,create, etc.) sur des ressources ; - un RoleBinding ou un ClusterRoleBinding attribue ce rôle à des sujets : utilisateurs, groupes ou ServiceAccounts.
2.1 Donner tous les droits sur un namespace
Section intitulée « 2.1 Donner tous les droits sur un namespace »-
Créez un fichier
oks-lab04-namespace-admin.yamlavec le contenu suivant :apiVersion: rbac.authorization.k8s.io/v1kind: Rolemetadata:name: oks-lab04-namespace-adminnamespace: oks-lab04-devrules:- apiGroups: ["*"]resources: ["*"]verbs: ["*"]---apiVersion: rbac.authorization.k8s.io/v1kind: RoleBindingmetadata:name: oks-lab04-namespace-adminnamespace: oks-lab04-devsubjects:- kind: Groupname: namespace-adminapiGroup: rbac.authorization.k8s.ioroleRef:kind: Rolename: oks-lab04-namespace-adminapiGroup: rbac.authorization.k8s.io- Le Role donne tous les verbes (
*) sur toutes les ressources (*), mais uniquement dans le namespaceoks-lab04-dev. - Le RoleBinding attribue ce Role au groupe
namespace-admin.
- Le Role donne tous les verbes (
-
Appliquez le manifeste :
Terminal window kubectl apply -f oks-lab04-namespace-admin.yaml -
Vérifiez les objets créés :
Terminal window kubectl get role,rolebinding -n oks-lab04-dev
Conseil : Kubernetes fournit aussi des ClusterRoles prêts à l’emploi :
admin,editetview. Un RoleBinding vers le ClusterRoleadmindonne des droits équivalents dans un seul namespace, sans écrire de Role.
2.2 Donner un accès en lecture seule au cluster
Section intitulée « 2.2 Donner un accès en lecture seule au cluster »-
Créez un fichier
oks-lab04-readonly.yamlavec le contenu suivant :apiVersion: rbac.authorization.k8s.io/v1kind: ClusterRolemetadata:name: oks-lab04-readonlyrules:- apiGroups: [""]resources: ["nodes", "namespaces", "pods", "pods/log", "services", "endpoints","configmaps", "events", "persistentvolumes", "persistentvolumeclaims"]verbs: ["get", "list", "watch"]- apiGroups: ["apps"]resources: ["deployments", "replicasets", "statefulsets", "daemonsets"]verbs: ["get", "list", "watch"]- apiGroups: ["networking.k8s.io"]resources: ["ingresses"]verbs: ["get", "list", "watch"]---apiVersion: rbac.authorization.k8s.io/v1kind: ClusterRoleBindingmetadata:name: oks-lab04-readonlysubjects:- kind: Groupname: readonly-usersapiGroup: rbac.authorization.k8s.ioroleRef:kind: ClusterRolename: oks-lab04-readonlyapiGroup: rbac.authorization.k8s.io- Le ClusterRole liste explicitement les ressources accessibles en lecture. Les Secrets n’en font pas partie.
- Le ClusterRoleBinding attribue ce ClusterRole au groupe
readonly-users, dans tous les namespaces.
Attention : une règle
resources: ["*"]avec les verbesgetetlistdonnerait aussi accès à tous les Secrets du cluster : mots de passe, tokens, clés privées. Un accès « en lecture seule » n’est pas forcément un accès sans risque. -
Appliquez le manifeste :
Terminal window kubectl apply -f oks-lab04-readonly.yaml
3. Générer les kubeconfigs dédiés
Section intitulée « 3. Générer les kubeconfigs dédiés »La commande octl kube cluster kubeconfig demande à OKS un nouveau certificat client, signé par l’autorité de certification du cluster :
--user: nom d’utilisateur inscrit dans le certificat ;--group: groupe inscrit dans le certificat ;--ttl: durée de validité du certificat (par exemple5h,1dou1w).
Chaque kubeconfig contient une clé privée : vous le créez directement avec les droits 600.
3.1 Générer le kubeconfig du groupe namespace-admin
Section intitulée « 3.1 Générer le kubeconfig du groupe namespace-admin »-
Générez le kubeconfig :
Terminal window (umask 077; octl kube cluster kubeconfig oks-lab01-cluster --project oks-lab01-project \--group namespace-admin --ttl 1d > oks-lab04-dev-admin-kubeconfig.yaml) -
Affichez l’identité portée par ce kubeconfig :
Terminal window kubectl auth whoami --kubeconfig oks-lab04-dev-admin-kubeconfig.yamlExemple de sortie :
ATTRIBUTE VALUEUsername kube-userGroups [namespace-admin system:authenticated]Le groupe
namespace-admins’affiche dans la liste des groupes. Comme vous n’avez pas indiqué--user, OKS a attribué le nom d’utilisateur par défautkube-user.
3.2 Générer le kubeconfig de l’utilisateur user1
Section intitulée « 3.2 Générer le kubeconfig de l’utilisateur user1 »-
Générez le kubeconfig :
Terminal window (umask 077; octl kube cluster kubeconfig oks-lab01-cluster --project oks-lab01-project \--user user1 --group readonly-users --ttl 1d > oks-lab04-readonly-kubeconfig.yaml) -
Affichez l’identité portée par ce kubeconfig :
Terminal window kubectl auth whoami --kubeconfig oks-lab04-readonly-kubeconfig.yamlExemple de sortie :
ATTRIBUTE VALUEUsername user1Groups [readonly-users system:authenticated] -
Vérifiez les droits des trois kubeconfigs :
Terminal window ls -l *kubeconfig.yamlChaque fichier a les droits
-rw-------: seul votre utilisateur peut le lire.
Remarque : dans la suite du lab, l’option
--kubeconfigchoisit le kubeconfig de chaque commande. La variableKUBECONFIGreste positionnée sur le kubeconfig administrateur du Lab 01.
4. Tester les droits
Section intitulée « 4. Tester les droits »4.1 Tester le kubeconfig namespace-admin
Section intitulée « 4.1 Tester le kubeconfig namespace-admin »-
Créez un Pod dans le namespace
oks-lab04-dev:Terminal window kubectl run oks-lab04-nginx2 --image=nginx -n oks-lab04-dev \--kubeconfig oks-lab04-dev-admin-kubeconfig.yaml -
Listez les Pods du namespace
oks-lab04-dev:Terminal window kubectl get pods -n oks-lab04-dev --kubeconfig oks-lab04-dev-admin-kubeconfig.yamlExemple de sortie :
NAME READY STATUS RESTARTS AGEoks-lab04-nginx 1/1 Running 0 10moks-lab04-nginx2 1/1 Running 0 20s -
Essayez de lister les Pods du namespace
default:Terminal window kubectl get pods -n default --kubeconfig oks-lab04-dev-admin-kubeconfig.yamlExemple de sortie :
Error from server (Forbidden): pods is forbidden: User "kube-user" cannot list resource "pods" in API group "" in the namespace "default"L’accès est refusé : le Role ne s’applique qu’au namespace
oks-lab04-dev.
4.2 Tester le kubeconfig readonly-users
Section intitulée « 4.2 Tester le kubeconfig readonly-users »-
Listez les nœuds du cluster :
Terminal window kubectl get nodes --kubeconfig oks-lab04-readonly-kubeconfig.yamlLes nœuds du cluster s’affichent.
-
Listez les Pods du namespace
kube-system:Terminal window kubectl get pods -n kube-system --kubeconfig oks-lab04-readonly-kubeconfig.yamlExemple de sortie (extrait) :
NAME READY STATUS RESTARTS AGEcilium-44vx7 1/1 Running 0 2dcilium-envoy-8dhfp 1/1 Running 0 2dcilium-operator-8547cb8548-xvk5q 1/1 Running 0 2dcoredns-59dc59c6b7-4vwtc 1/1 Running 0 2dimds-provider-ip-10-50-38-155 1/1 Running 0 2dkonnectivity-agent-jl9mb 1/1 Running 0 2dmetrics-server-6fd5b89477-bcz6z 1/1 Running 0 2dosc-csi-node-4hrvh 3/3 Running 0 2dCes Pods sont les composants système installés par OKS sur les nœuds : réseau (Cilium), DNS (CoreDNS), accès aux métadonnées des VMs (imds-provider), lien avec le control plane (Konnectivity), métriques (metrics-server) et stockage BSU (pilote CSI). Les autres composants, comme le contrôleur de snapshots, s’exécutent avec le control plane, géré par OKS.
-
Essayez de créer un Pod :
Terminal window kubectl run oks-lab04-test --image=nginx -n default --kubeconfig oks-lab04-readonly-kubeconfig.yamlExemple de sortie :
Error from server (Forbidden): pods is forbidden: User "user1" cannot create resource "pods" in API group "" in the namespace "default" -
Essayez de lister les Secrets :
Terminal window kubectl get secrets -A --kubeconfig oks-lab04-readonly-kubeconfig.yamlExemple de sortie :
Error from server (Forbidden): secrets is forbidden: User "user1" cannot list resource "secrets" in API group "" at the cluster scopeL’accès est refusé : les Secrets ne font pas partie du ClusterRole
oks-lab04-readonly.
4.3 Vérifier les droits sans exécuter d’action
Section intitulée « 4.3 Vérifier les droits sans exécuter d’action »La commande kubectl auth can-i demande à l’API Kubernetes si une action est autorisée, sans l’exécuter.
-
Vérifiez quelques droits du kubeconfig
readonly-users:Terminal window kubectl auth can-i list pods -A --kubeconfig oks-lab04-readonly-kubeconfig.yamlkubectl auth can-i get secrets -n kube-system --kubeconfig oks-lab04-readonly-kubeconfig.yamlkubectl auth can-i delete deployments -n oks-lab04-dev --kubeconfig oks-lab04-readonly-kubeconfig.yamlLes réponses sont
yes,noetno. -
Listez tous les droits du kubeconfig
namespace-admindans le namespaceoks-lab04-dev:Terminal window kubectl auth can-i --list -n oks-lab04-dev --kubeconfig oks-lab04-dev-admin-kubeconfig.yaml
5. Protéger les kubeconfigs
Section intitulée « 5. Protéger les kubeconfigs »Un kubeconfig généré par OKS contient un certificat client et sa clé privée, en clair. Toute personne qui obtient le fichier obtient les droits associés, jusqu’à l’expiration du certificat.
Appliquez les règles suivantes :
- créez toujours les kubeconfigs avec
umask 077, et corrigez les droits d’un fichier existant avecchmod 600 <FICHIER>; - limitez la durée de validité avec
--ttl: un certificat court limite l’impact d’une fuite ; - générez un kubeconfig par utilisateur, avec
--user, pour savoir qui a fait quoi dans les journaux d’audit ; - ne copiez jamais un kubeconfig dans un dépôt Git, un message ou un ticket.
Important : un certificat client ne peut pas être révoqué individuellement avant son expiration. Pour retirer immédiatement des droits, supprimez le RoleBinding ou le ClusterRoleBinding du groupe ou de l’utilisateur concerné.
Validation du lab
Section intitulée « Validation du lab »Pour valider votre lab, vérifiez les points suivants :
kubectl get role,rolebinding -n oks-lab04-devafficheoks-lab04-namespace-admin.kubectl get clusterrole,clusterrolebinding oks-lab04-readonlyaffiche les deux objets.kubectl auth whoami --kubeconfig oks-lab04-readonly-kubeconfig.yamlaffiche l’utilisateuruser1et le groupereadonly-users.- Le kubeconfig
namespace-adminpeut créer un Pod dansoks-lab04-dev, mais ne peut pas lister les Pods dedefault. - Le kubeconfig
readonly-userspeut lister les nœuds et les Pods, mais ne peut ni créer de Pod ni lister les Secrets. - Les fichiers
*kubeconfig.yamlont les droits-rw-------.
Challenge
Section intitulée « Challenge »- Retirez immédiatement les droits du groupe
readonly-users, sans attendre l’expiration de son kubeconfig, puis vérifiez le résultat. - Remplacez le Role
oks-lab04-namespace-adminpar le ClusterRole prédéfiniedit, dans le namespaceoks-lab04-devuniquement.
Question : Le groupe
namespace-admina tous les droits dans le namespaceoks-lab04-dev. Peut-il lire les Secrets de ce namespace ?
💡 Correction — Retrait des droits
kubectl delete clusterrolebinding oks-lab04-readonlykubectl get nodes --kubeconfig oks-lab04-readonly-kubeconfig.yamlLa deuxième commande renvoie Forbidden : le certificat est toujours valide, mais plus aucune règle RBAC ne donne de droits au groupe readonly-users. Recréez le ClusterRoleBinding avec kubectl apply -f oks-lab04-readonly.yaml.
💡 Correction — Utilisation du ClusterRole `edit`
Un RoleBinding peut référencer un ClusterRole : les droits du ClusterRole ne s’appliquent alors que dans le namespace du RoleBinding.
kubectl delete rolebinding oks-lab04-namespace-admin -n oks-lab04-devkubectl create rolebinding oks-lab04-namespace-edit -n oks-lab04-dev \ --clusterrole=edit --group=namespace-adminkubectl auth can-i create rolebindings -n oks-lab04-dev --kubeconfig oks-lab04-dev-admin-kubeconfig.yamlLa réponse est no : contrairement au Role oks-lab04-namespace-admin, le ClusterRole edit ne permet pas de modifier les règles RBAC du namespace.
💡 Correction — Question du challenge
Oui. Le Role oks-lab04-namespace-admin donne tous les verbes sur toutes les ressources du namespace, Secrets compris :
kubectl auth can-i get secrets -n oks-lab04-dev --kubeconfig oks-lab04-dev-admin-kubeconfig.yamlLe groupe peut aussi créer des Roles et des RoleBindings dans le namespace. Ces droits sont adaptés à un administrateur du namespace, mais pas à un simple développeur.
Nettoyage du lab
Section intitulée « Nettoyage du lab »Attention : avant de supprimer une ressource, vérifiez qu’elle n’est pas utilisée par d’autres labs.
Ressources à conserver pour les labs suivants
Section intitulée « Ressources à conserver pour les labs suivants »Si vous prévoyez de continuer avec le Lab 05, ne supprimez pas les ressources du Lab 01 :
- le cluster OKS
oks-lab01-clusteret ses NodePools ; - le fichier kubeconfig
oks-lab01-kubeconfig.yaml.
Ressources à supprimer
Section intitulée « Ressources à supprimer »Supprimez les ressources suivantes, qui ne seront pas réutilisées. Utilisez le kubeconfig administrateur du Lab 01 (variable KUBECONFIG).
-
Supprimer le namespace, avec ses Pods, son Role et son RoleBinding :
Terminal window kubectl delete namespace oks-lab04-dev -
Supprimer le ClusterRole et le ClusterRoleBinding :
Terminal window kubectl delete clusterrolebinding oks-lab04-readonlykubectl delete clusterrole oks-lab04-readonly -
Supprimer les kubeconfigs dédiés :
Terminal window rm oks-lab04-dev-admin-kubeconfig.yaml oks-lab04-readonly-kubeconfig.yaml