Conditions nécessaires pour l'intégration de répertoire CSV

Les conditions nécessaires pour les intégrations de répertoires CSV sont les suivantes :

  • L'Okta Provisioning Agent est léger et s'exécute sur un serveur Linux (CentOS ou RHEL) ou Microsoft Windows Server (x86/x64) et se trouve derrière un pare-feu. Pour trouver le lien de téléchargement, connectez-vous à Okta, sélectionnez ParamètresTéléchargements, puis accédez à la section Okta Provisioning Agent.
  • La version d'Okta Provisioning Agent doit être 1.03.00 ou ultérieure. Les versions précédentes ne prennent pas en charge cette fonctionnalité. Consultez Installer l'Okta Provisioning Agent.
  • Votre fichier CSV doit avoir une extension .csv et être enregistré dans un répertoire local.
  • Votre fichier CSV doit être au format UTF-8. Attention : Sélectionner l'option UTF-8 (délimitation par virgule) pour le format CSV dans certaines versions de Microsoft Excel peut entraîner des échecs d'importation. Cela se produit lorsque l'encodage de caractères UTF-8 utilisé dans ces fichiers n'est pas reconnu.
  • L'Okta Provisioning Agent doit disposer de permissions de lecture pour le fichier CSV.
  • Vous devez activer l'option Autoriser le répertoire CSV pour les utilisateurs sources Okta. Accédez à l'onglet Approvisionnement de votre répertoire CSV et cliquez sur Dans Okta. Modifiez la section Sourcing de profil et de cycle de vie et sélectionnez Autoriser le répertoire CSV pour les utilisateurs sources Okta. Cliquez sur Enregistrer.
  • Tous les utilisateurs actifs doivent être présents pour chaque importation CSV. Votre fichier CSV est une représentation de l'ensemble des utilisateurs actifs de votre système source. Tous les utilisateurs actifs doivent être présents dans chaque importation CSV, ou bien l'utilisateur sera considéré comme inactif. Okta utilise l'identifiant unique que vous avez désigné comme identifiant principal pour chaque utilisateur. L'importation se déroule comme suit :
    • Si un utilisateur n'est pas présent durant la dernière importation, Okta considèrera que l'utilisateur n'est plus actif et désactivera l'utilisateur dans Okta.
    • Si un nouvel utilisateur n'existait pas sur Okta durant une importation précédente sous son identifiant unique, alors Okta créera l'utilisateur.
    • Si un utilisateur existe sur Okta et était également présent à la précédente importation, Okta traitera les données du fichier CSV comme source principale. Okta utilise les données du fichier CSV et exécute toutes les mises à jour nécessaires des attributs de cet utilisateur.
  • Tous les attributs obligatoires doivent être présents pour chaque importation CSV. L'identifiant unique et tous les attributs portant la mention Attribut requis dans Profile Editor d'Okta doivent être présents dans le fichier CSV. Les conséquences de l'absence d'un ou plusieurs attributs pour un utilisateur sont les suivantes :
    • Pour un utilisateur existant, l'utilisateur est désactivé sur Okta.
    • Pour un nouvel utilisateur, l'importation échoue.
  • Assurez-vous de formater correctement tous les attributs et en-têtes :
    • Les en-têtes d'attributs obligatoires sont sensibles à la casse.
    • Utilisez des noms de variable uniquement, pas des noms d'affichage comme les en-têtes CSV.
    • N'utilisez pas d'espaces vides autour des en-têtes au sein du CSV (elles ne sont pas ignorées).
    • Profile Editor ignore toute colonne du CSV dont l'attribut d'en-tête n'a pas été préalablement configuré.
  • Les attributs facultatifs doivent être présents pour être mis à jour. Si un attribut est facultatif et qu'il n'existe pas d'en-tête dans le fichier CSV pour cet attribut, Okta ne le mettra pas à jour. Okta mettra à jour tous les autres attributs.