Automatisation de la documentation et mise en place d’un système de contrôle des workflows Okta




Contexte

Dans la continuité de mon travail sur Okta et sur les workflows IAM, j’ai également été amené à travailler sur un sujet plus orienté organisation et suivi interne. Avec le temps, le nombre de workflows présents dans l’environnement a augmenté, tout comme les demandes de modifications, les évolutions et les nouveaux besoins.

Dans ce contexte, il devenait important d’avoir une documentation claire et à jour des workflows existants. Une gestion uniquement manuelle pouvait vite devenir chronophage et entraîner certains oublis, notamment lorsqu’un workflow est modifié ou qu’un nouveau est créé.

J’ai donc participé à la mise en place d’un système automatisé permettant à la fois de documenter les workflows et de contrôler la cohérence entre l’environnement réel et les informations renseignées dans les fichiers de suivi.




Objectifs

L’objectif principal était de centraliser les informations importantes liées aux workflows dans un fichier de documentation simple à exploiter par l’équipe.

Il fallait également faciliter le suivi des modifications réalisées dans le temps, afin de garder un historique clair des changements apportés sur les workflows.

Enfin, le projet avait aussi pour but de mettre en place un système de contrôle capable de vérifier automatiquement certaines cohérences, par exemple s’assurer qu’un workflow modifié est bien renseigné dans la documentation.




Moyens mis en œuvre

Pour répondre à ce besoin, j’ai développé plusieurs scripts en Python permettant d’automatiser la récupération et l’organisation des informations liées aux workflows Okta.

Une première partie du script permettait d’alimenter automatiquement un fichier Excel servant de documentation. On y retrouvait notamment différentes informations utiles comme le nom du workflow, sa date de création, ou d’autres éléments nécessaires au suivi global.

Une deuxième page du fichier était dédiée au suivi des modifications. Lorsqu’un changement était réalisé sur un workflow, il pouvait être renseigné afin de conserver une trace des évolutions dans le temps.

J’ai ensuite développé un système de contrôle venant comparer les workflows présents dans Okta avec les informations présentes dans le fichier Excel. Cela permettait par exemple de vérifier qu’un workflow ayant été modifié correspond bien à un élément documenté, ou de repérer certaines incohérences.

Pour réaliser cela, j’ai utilisé Python ainsi que différentes bibliothèques comme pandas pour le traitement des données, openpyxl pour la gestion du fichier Excel, requests pour certaines interactions API et datetime pour la gestion des dates.




Résultats obtenus

Cette solution a permis d’améliorer le suivi global des workflows utilisés par l’équipe IAM.

La documentation est devenue plus simple à maintenir et plus fiable qu’un suivi entièrement manuel. Les informations importantes sont regroupées dans un seul fichier clair et facilement exploitable.

Le système de contrôle permet également d’identifier plus rapidement certains écarts entre la documentation et la réalité de l’environnement, ce qui réduit les oublis et facilite la maintenance.

Enfin, cette automatisation a permis de gagner du temps sur plusieurs tâches répétitives, tout en apportant un meilleur niveau de rigueur dans le suivi des workflows.




Compétences mobilisées

Compétences techniques :


Scripting et automatisation : développement d’un script Python permettant de détecter automatiquement les interruptions de flux de logs et d’envoyer des alertes sans intervention manuelle.
Gestion de la configuration : mise en place d’un suivi structuré des workflows et maintien d’une documentation exploitable dans le temps.
Algèbre, statistiques, théorie des nombres, logique mathématique : utilisation de logiques de comparaison, de vérification et de contrôle automatisé dans le développement du système.
Développement Full Stack : mise en place d’une logique complète de génération et de contrôle de documentation, incluant le traitement des données et leur structuration afin de produire une documentation exploitable.



Compétences humaines :


Travail en équipe : réalisation d’un outil répondant à un besoin concret de suivi pour l’équipe IAM.
Sens des responsabilités : travail sur des éléments utilisés au quotidien pour la gestion et la maintenance des workflows.
Empathie et à l’écoute : prise en compte des besoins des utilisateurs lors de la structuration de la documentation afin de la rendre claire, compréhensible et facilement exploitable.




Bilan personnel

Cette réalisation m’a permis de comprendre qu’au-delà de la technique pure, l’organisation et la qualité du suivi interne sont également très importantes dans un environnement professionnel.

J’ai apprécié travailler sur un sujet concret, utile au quotidien et directement exploitable par l’équipe. C’est le type de projet où l’on voit rapidement l’intérêt de ce que l’on développe.

Cela m’a aussi permis de continuer à progresser en Python sur des cas réels, notamment autour de l’automatisation, du traitement de données et de la fiabilisation de processus existants.

Enfin, ce projet m’a montré que des améliorations parfois simples en apparence peuvent avoir un réel impact lorsqu’elles répondent à un besoin précis.