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 :
- 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.
- 2Ajoutez un bloc import qui désigne la ressource et porte cet identifiant.
- 3Lancez terraform plan -generate-config-out= suivi d'un nouveau nom de fichier : Terraform refuse un fichier existant.
- 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.
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 :
- Okta Developer: Terraform overview
- Okta Developer: Import existing Okta objects into Terraform
- Okta: Information Security Addendum (January 22, 2026)
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.