CYBBACK

    Exporter la configuration Okta : API, Terraform et configuration as code

    Okta n'a pas de bouton « exporter toute la configuration ». La documentation développeur propose une autre voie : décrire l'organisation en code avec Terraform et y importer les objets existants. Voici comment faire, et ce que cette approche ne couvre pas.

    Par Product Marketing CYBBACK2 min de lectureVérifié le 14/11/2026

    Le principe

    Avec le fournisseur Terraform pour Okta, vous écrivez le code qui décrit l'état voulu de l'organisation : groupes, politiques, applications, et plus. Terraform passe par l'API d'Okta pour appliquer ce code.

    • Terraform garde l'état courant de l'organisation dans un fichier JSON (terraform.tfstate par défaut), qu'Okta recommande de stocker à distance pour le versionner, le chiffrer et le partager.
    • Okta recommande une configuration par organisation.
    • Okta recommande de gérer chaque type d'objet soit par Terraform, soit par la console d'administration, pas les deux.

    Importer les objets existants pas à pas

    Les objets créés dans la console doivent être importés, sinon Terraform risque de les modifier de façon inattendue. La documentation décrit deux méthodes : un import minimal, ou un import qui génère la configuration complète de l'objet. La seconde :

    1. 1Relevez l'identifiant Okta de l'objet : Terraform en a besoin pour l'importer. Pour les règles de politique et les zones réseau, lisez-le par l'API plutôt que dans l'URL.
    2. 2Ajoutez un bloc import qui désigne la ressource et porte cet identifiant.
    3. 3Lancez terraform plan -generate-config-out= suivi d'un nouveau nom de fichier : Terraform refuse un fichier existant.
    4. 4Relisez la configuration générée, qui contient tous les champs de l'objet, puis copiez-la dans votre configuration principale.

    Les objets sans identifiant (singletons) s'importent avec singleton, un point ou un tiret bas comme identifiant.

    Les limites

    • Les réglages de fonctionnalités d'Okta (feature settings) ne peuvent pas être importés dans Terraform.
    • Okta conseille, dans la plupart des cas, de ne pas importer les utilisateurs : Terraform décrit la configuration, pas l'annuaire.
    • L'import se fait objet par objet, à partir de leurs identifiants.
    • Le code décrit l'état voulu, pas l'historique : une modification faite dans la console n'y figure pas tant qu'elle n'a pas été reportée.
    Pendant le contrat, le client peut extraire ses données du service selon la documentation d'Okta ; à la fin du contrat, Okta met un fichier à disposition sur demande écrite, pendant 30 jours. Voir le modèle de responsabilité partagée.

    Le rôle d'une sauvegarde externe

    Une sauvegarde externe complète Terraform : elle capture aussi les utilisateurs et tout ce qui a été modifié dans la console, à chaque date. CYBBACK sauvegarde de façon incrémentale plus de 35 catégories d'objets Okta et les exporte en JSON, CSV et HTML. Voir la solution Okta.

    Questions fréquentes

    Okta permet-il d'exporter toute sa configuration ?

    La documentation consultée ne décrit pas d'export global. Elle propose de gérer la configuration avec Terraform et d'importer les objets existants un par un.

    Faut-il importer les utilisateurs Okta dans Terraform ?

    Selon la documentation Okta, dans la plupart des cas, la bonne pratique est de ne pas importer les utilisateurs.

    Aller plus loin

    Les outils natifs couvrent les erreurs récentes. Pour garder des versions datées au-delà, restaurables et stockées en Europe ou chez vous, découvrez la sauvegarde CYBBACK.

    Sources officielles

    Faits vérifiés le 14/11/2026 dans la documentation officielle de l'éditeur :

    Guide indépendant, non affilié à l'éditeur de Okta. Les noms cités sont des marques de leurs propriétaires. Les interfaces évoluent : en cas de doute, la documentation officielle fait foi.

    À lire aussi