Aller au contenu

Lab 04 : Gestion des accès avec RBAC et des kubeconfigs dédiés

À 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 whoami et kubectl auth can-i ;
  • protéger les fichiers kubeconfig sur votre poste.

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 groupe namespace-admin : tous les droits, mais uniquement dans le namespace oks-lab04-dev ;
  • oks-lab04-readonly-kubeconfig.yaml, pour l’utilisateur user1 du groupe readonly-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.

Avant de commencer, vous devez disposer :

  • du cluster oks-lab01-cluster à l’état ready, avec ses NodePools, créé dans le Lab 01 ;
  • du fichier oks-lab01-kubeconfig.yaml récupéré dans le Lab 01 ;
  • de kubectl (version 1.28 ou ultérieure) et octl installés et configurés (Lab 01).

Le lab utilise la région eu-west-2.

  1. 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.yaml

    Remarque : 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)
  2. Affichez l’identité portée par ce kubeconfig :

    Terminal window
    kubectl auth whoami

    Exemple de sortie :

    ATTRIBUTE VALUE
    Username cluster-admin
    Groups [system:authenticated]

    Le certificat porte l’utilisateur cluster-admin. Il n’appartient à aucun groupe particulier (system:authenticated regroupe tous les utilisateurs authentifiés) : ce sont les règles RBAC créées par OKS pour l’utilisateur cluster-admin qui 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 »
  1. Créez le namespace oks-lab04-dev :

    Terminal window
    kubectl create namespace oks-lab04-dev
  2. Lancez un Pod de test dans ce namespace :

    Terminal window
    kubectl run oks-lab04-nginx --image=nginx -n oks-lab04-dev

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.
  1. Créez un fichier oks-lab04-namespace-admin.yaml avec le contenu suivant :

    apiVersion: rbac.authorization.k8s.io/v1
    kind: Role
    metadata:
    name: oks-lab04-namespace-admin
    namespace: oks-lab04-dev
    rules:
    - apiGroups: ["*"]
    resources: ["*"]
    verbs: ["*"]
    ---
    apiVersion: rbac.authorization.k8s.io/v1
    kind: RoleBinding
    metadata:
    name: oks-lab04-namespace-admin
    namespace: oks-lab04-dev
    subjects:
    - kind: Group
    name: namespace-admin
    apiGroup: rbac.authorization.k8s.io
    roleRef:
    kind: Role
    name: oks-lab04-namespace-admin
    apiGroup: rbac.authorization.k8s.io
    • Le Role donne tous les verbes (*) sur toutes les ressources (*), mais uniquement dans le namespace oks-lab04-dev.
    • Le RoleBinding attribue ce Role au groupe namespace-admin.
  2. Appliquez le manifeste :

    Terminal window
    kubectl apply -f oks-lab04-namespace-admin.yaml
  3. 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, edit et view. Un RoleBinding vers le ClusterRole admin donne des droits équivalents dans un seul namespace, sans écrire de Role.

  1. Créez un fichier oks-lab04-readonly.yaml avec le contenu suivant :

    apiVersion: rbac.authorization.k8s.io/v1
    kind: ClusterRole
    metadata:
    name: oks-lab04-readonly
    rules:
    - 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/v1
    kind: ClusterRoleBinding
    metadata:
    name: oks-lab04-readonly
    subjects:
    - kind: Group
    name: readonly-users
    apiGroup: rbac.authorization.k8s.io
    roleRef:
    kind: ClusterRole
    name: oks-lab04-readonly
    apiGroup: 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 verbes get et list donnerait 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.

  2. Appliquez le manifeste :

    Terminal window
    kubectl apply -f oks-lab04-readonly.yaml

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 exemple 5h, 1d ou 1w).

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 »
  1. 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)
  2. Affichez l’identité portée par ce kubeconfig :

    Terminal window
    kubectl auth whoami --kubeconfig oks-lab04-dev-admin-kubeconfig.yaml

    Exemple de sortie :

    ATTRIBUTE VALUE
    Username kube-user
    Groups [namespace-admin system:authenticated]

    Le groupe namespace-admin s’affiche dans la liste des groupes. Comme vous n’avez pas indiqué --user, OKS a attribué le nom d’utilisateur par défaut kube-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 »
  1. 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)
  2. Affichez l’identité portée par ce kubeconfig :

    Terminal window
    kubectl auth whoami --kubeconfig oks-lab04-readonly-kubeconfig.yaml

    Exemple de sortie :

    ATTRIBUTE VALUE
    Username user1
    Groups [readonly-users system:authenticated]
  3. Vérifiez les droits des trois kubeconfigs :

    Terminal window
    ls -l *kubeconfig.yaml

    Chaque fichier a les droits -rw------- : seul votre utilisateur peut le lire.

Remarque : dans la suite du lab, l’option --kubeconfig choisit le kubeconfig de chaque commande. La variable KUBECONFIG reste positionnée sur le kubeconfig administrateur du Lab 01.

  1. 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
  2. Listez les Pods du namespace oks-lab04-dev :

    Terminal window
    kubectl get pods -n oks-lab04-dev --kubeconfig oks-lab04-dev-admin-kubeconfig.yaml

    Exemple de sortie :

    NAME READY STATUS RESTARTS AGE
    oks-lab04-nginx 1/1 Running 0 10m
    oks-lab04-nginx2 1/1 Running 0 20s
  3. Essayez de lister les Pods du namespace default :

    Terminal window
    kubectl get pods -n default --kubeconfig oks-lab04-dev-admin-kubeconfig.yaml

    Exemple 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.

  1. Listez les nœuds du cluster :

    Terminal window
    kubectl get nodes --kubeconfig oks-lab04-readonly-kubeconfig.yaml

    Les nœuds du cluster s’affichent.

  2. Listez les Pods du namespace kube-system :

    Terminal window
    kubectl get pods -n kube-system --kubeconfig oks-lab04-readonly-kubeconfig.yaml

    Exemple de sortie (extrait) :

    NAME READY STATUS RESTARTS AGE
    cilium-44vx7 1/1 Running 0 2d
    cilium-envoy-8dhfp 1/1 Running 0 2d
    cilium-operator-8547cb8548-xvk5q 1/1 Running 0 2d
    coredns-59dc59c6b7-4vwtc 1/1 Running 0 2d
    imds-provider-ip-10-50-38-155 1/1 Running 0 2d
    konnectivity-agent-jl9mb 1/1 Running 0 2d
    metrics-server-6fd5b89477-bcz6z 1/1 Running 0 2d
    osc-csi-node-4hrvh 3/3 Running 0 2d

    Ces 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.

  3. Essayez de créer un Pod :

    Terminal window
    kubectl run oks-lab04-test --image=nginx -n default --kubeconfig oks-lab04-readonly-kubeconfig.yaml

    Exemple de sortie :

    Error from server (Forbidden): pods is forbidden: User "user1" cannot create resource "pods" in API group "" in the namespace "default"
  4. Essayez de lister les Secrets :

    Terminal window
    kubectl get secrets -A --kubeconfig oks-lab04-readonly-kubeconfig.yaml

    Exemple de sortie :

    Error from server (Forbidden): secrets is forbidden: User "user1" cannot list resource "secrets" in API group "" at the cluster scope

    L’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.

  1. Vérifiez quelques droits du kubeconfig readonly-users :

    Terminal window
    kubectl auth can-i list pods -A --kubeconfig oks-lab04-readonly-kubeconfig.yaml
    kubectl auth can-i get secrets -n kube-system --kubeconfig oks-lab04-readonly-kubeconfig.yaml
    kubectl auth can-i delete deployments -n oks-lab04-dev --kubeconfig oks-lab04-readonly-kubeconfig.yaml

    Les réponses sont yes, no et no.

  2. Listez tous les droits du kubeconfig namespace-admin dans le namespace oks-lab04-dev :

    Terminal window
    kubectl auth can-i --list -n oks-lab04-dev --kubeconfig oks-lab04-dev-admin-kubeconfig.yaml

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 avec chmod 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é.

Pour valider votre lab, vérifiez les points suivants :

  • kubectl get role,rolebinding -n oks-lab04-dev affiche oks-lab04-namespace-admin.
  • kubectl get clusterrole,clusterrolebinding oks-lab04-readonly affiche les deux objets.
  • kubectl auth whoami --kubeconfig oks-lab04-readonly-kubeconfig.yaml affiche l’utilisateur user1 et le groupe readonly-users.
  • Le kubeconfig namespace-admin peut créer un Pod dans oks-lab04-dev, mais ne peut pas lister les Pods de default.
  • Le kubeconfig readonly-users peut lister les nœuds et les Pods, mais ne peut ni créer de Pod ni lister les Secrets.
  • Les fichiers *kubeconfig.yaml ont les droits -rw-------.
  1. Retirez immédiatement les droits du groupe readonly-users, sans attendre l’expiration de son kubeconfig, puis vérifiez le résultat.
  2. Remplacez le Role oks-lab04-namespace-admin par le ClusterRole prédéfini edit, dans le namespace oks-lab04-dev uniquement.

Question : Le groupe namespace-admin a tous les droits dans le namespace oks-lab04-dev. Peut-il lire les Secrets de ce namespace ?

💡 Correction — Retrait des droits
Terminal window
kubectl delete clusterrolebinding oks-lab04-readonly
kubectl get nodes --kubeconfig oks-lab04-readonly-kubeconfig.yaml

La 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.

Terminal window
kubectl delete rolebinding oks-lab04-namespace-admin -n oks-lab04-dev
kubectl create rolebinding oks-lab04-namespace-edit -n oks-lab04-dev \
--clusterrole=edit --group=namespace-admin
kubectl auth can-i create rolebindings -n oks-lab04-dev --kubeconfig oks-lab04-dev-admin-kubeconfig.yaml

La 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 :

Terminal window
kubectl auth can-i get secrets -n oks-lab04-dev --kubeconfig oks-lab04-dev-admin-kubeconfig.yaml

Le 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.

Attention : avant de supprimer une ressource, vérifiez qu’elle n’est pas utilisée par d’autres labs.

Si vous prévoyez de continuer avec le Lab 05, ne supprimez pas les ressources du Lab 01 :

  • le cluster OKS oks-lab01-cluster et ses NodePools ;
  • le fichier kubeconfig oks-lab01-kubeconfig.yaml.

Supprimez les ressources suivantes, qui ne seront pas réutilisées. Utilisez le kubeconfig administrateur du Lab 01 (variable KUBECONFIG).

  1. Supprimer le namespace, avec ses Pods, son Role et son RoleBinding :

    Terminal window
    kubectl delete namespace oks-lab04-dev
  2. Supprimer le ClusterRole et le ClusterRoleBinding :

    Terminal window
    kubectl delete clusterrolebinding oks-lab04-readonly
    kubectl delete clusterrole oks-lab04-readonly
  3. Supprimer les kubeconfigs dédiés :

    Terminal window
    rm oks-lab04-dev-admin-kubeconfig.yaml oks-lab04-readonly-kubeconfig.yaml