Référence surl'intégration OpenLDAP

Cette section fournit des informations de référence spécifiques aux intégrations OpenLDAP Lightweight Directory Access Protocol (LDAP). Lorsque vous installerez l'agent LDAP d'Okta, vous aurez besoin de ces informations afin d'intégrer votre répertoire OpenLDAP dans Okta. Consultez Installer l'agent LDAP Okta

Version recommandée

OpenLDAP 2.4.44-22.amzn2

Problèmes connus

  • Les utilisateurs utilisant un mot de passe temporaire ne sont pas invités à créer un nouveau mot de passe.
  • Les utilisateurs tentant de se connecter dans Okta End-User Dashboard avec un mot de passe expiré recevront le message d'erreur Connexion impossible, et pas Mot de passe expiré.

  • Les utilisateurs qui sollicitent une réinitialisation de leur mot de passe et qui doivent le modifier une fois la réinitialisation effectuée par un administrateur, devront indiquer deux fois leur nouveau mot de passe afin d'accéder au Okta End-User Dashboard.

  • Lorsque les paramètres d'approvisionnement indiquent Ne rien faire alors que les utilisateurs sont désactivés, les utilisateurs restent actifs dans Okta. Lorsqu'une seule source fournit des attributs de profil utilisateur, les utilisateurs désactivés sont déconnectés de la source et Okta devient la source des attributs de profil utilisateur.

Configuration de l'intégration

Durant l'installation et la configuration initiales de l'agent détaillées dans la section Installer l'agent LDAP Okta, voici les attributs utilisés pour les intégrations OpenLDAP :

  • Attribut d'identificateur unique : entryuuid
  • Attribut DN : entrydn
  • Classe d'objets utilisateur : inetorgperson
  • Filtre d'objets utilisateur : (objectclass=inetorgperson)
  • * Attribut de compte désactivé - pwdlockout
  • * Valeur du compte désactivé : True
  • *Valeur du compte activé : False
  • Attribut du mot de passe : userpassword
  • Classe d'objets de groupe : groupofuniquenames
  • Filtre d'objets de groupe : (objectclass=groupofuniquenames)
  • Attribut de membre : uniquemember

Lecture de schéma

Il n'existe pas de spécificité particulière pour les intégrations OpenLDAP.

Pour ajouter des attributs des classes AUX, ajoutez la classe auxiliaire comme classe d'objets auxiliaires à la configuration d'approvisionnement de répertoire.

Modification de mot de passe

Les utilisateurs peuvent déclencher une modification de mot de passe en sélectionnant Paramètres dans Okta End-User Dashboard.

Pour autoriser les utilisateurs à modifier ou de réinitialiser leur mot de passe, cliquez sur SécuritéAuthentification déléguée, sélectionnez l'onglet LDAP, puis sélectionnez Les utilisateurs peuvent modifier leurs mots de passe LDAP dansOkta.

Réinitialisation du mot de passe

La réinitialisation du mot de passe est déclenchée par un administrateur ou le flux utilisateur Mot de passe oublié.

La réinitialisation de mot de passe peut échouer si le nouveau mot de passe ne répond pas aux critères de la politique de mots de passe.

Les utilisateurs ne peuvent pas mettre à jour les mots de passe expirés. Les administrateurs réinitialisent souvent les mots de passe.

Validation du mot de passe

Utilisez la classe d'objets pwdPolicy et l'attribut pwdPolicySubentry pour mettre en œuvre des politiques OpenLDAP spécifiques en matière de mots de passe.

Importer

Il n'existe pas de spécificité particulière pour les intégrations OpenLDAP.

Approvisionnement JIT

Il n'existe pas de spécificité liée à l'approvisionnement JIT OpenLDAP. Pour l'identification de l'utilisateur (UID), utilisez un format d'e-mail correspondant au paramètre par défaut pour un nom d'utilisateur Okta. N'utilisez pas de fournisseur d'identité (IdP) externe pour déclencher la connexion.

Pour vous assurer que l'approvisionnement JIT a bien été effectué dès la première tentative, vérifiez les conditions suivantes :

  • La valeur de l'attribut de nom configuré (tel que l'UID) ne doit pas exister dans Okta.
  • La valeur de l'attribut de nom configuré (tel que l'UID) doit être unique dans l'ensemble des répertoires utilisant JIT.
  • Les attributs obligatoires doivent être présents. Dans Okta, les attributs par défaut sont email, givenName, sn et uid.
  • Le mot de passe doit être correct.
  • L'attribut de compte désactivé doit avoir la valeur False sur le serveur LDAP.

Lorsque l'approvisionnement JIT est effectué, l'ensemble des attributs utilisateur spécifiés sur la page des paramètres LDAP et dans Profile Editor est importé. Pour sélectionner d'autres attributs obligatoires, utilisez Profile Editor.

Importation d'appartenances

Les profils utilisateur utilisant des paramètres OpenLDAP sont ajoutés aux groupes avec la classe d'objets groupofuniquenames et se voient affecter l'attribut de groupe uniquemember.

Lors de l'importation, si l'attribut d'appartenance est défini sur seeAlso, les utilisateurs seront affectés aux groupes ajoutés à l'attribut utilisateur seeAlso.

Approvisionnement

Pour autoriser la configuration de mots de passe lors de la création ou l'affectation d'utilisateurs, désactivez DelAuth, activez LDAP_PUSH_PASSWORD_UPDATES, puis activez la synchronisation de mots de passe sur votre instance LDAP. Avec cette configuration, l'agent LDAP envoie l'action PASSWORD_UPDATE lors de la première connexion ou affectation de l'utilisateur. Sans cette configuration, le mot de passe ne sera pas transféré vers votre instance LDAP.

Pour créer et affecter des mots de passe lors de la création de profils utilisateur, procédez selon les étapes suivantes :

  1. Contactez l'assistance client d'Okta afin d'activer les mises à jour push de mots de passe LDAP.
  2. Désactivez l'authentification déléguée :
    1. Dans Admin Console, accédez à SécuritéAuthentification déléguéeLDAP.
    2. Cliquez sur Modifier dans le volet Authentification déléguée.
    3. Décochez la case à cocher Activer l'authentification déléguée sur LDAP
    4. Cliquez sur Enregistrer.
    5. Acceptez les paramètres par défaut pour réinitialiser l'ensemble des mots de passe utilisateur LDAP, puis cliquez sur Désactiver l'Authentification LDAP.
  3. Dans votre Admin Console, accédez à RépertoireIntégrations de répertoiresLDAPApprovisionnementDans l'application.
  4. Cliquez sur Modifier, sélectionnez Activer en regard de Synchroniser un mot de passe, puis sur Enregistrer.

    Lorsque l'option Synchroniser un mot de passe est activée, l'agent LDAP envoie l'action PASSWORD_UPDATE lors de la première connexion de l'utilisateur.

Pour affecter des utilisateurs Okta existants à LDAP, procédez selon les étapes suivantes :

  1. Dans votre Admin Console, accédez à RépertoireIntégrations de répertoiresLDAPApprovisionnementDans l'application.
  2. Cliquez sur Modifier, sélectionnez Activer en regard de Créer des utilisateurs, puis sur Enregistrer.
  3. Cliquez sur RépertoireGroupes.
  4. Sélectionnez le groupe Okta auquel vous souhaitez affecter des utilisateurs.
  5. Cliquez sur Gérer les répertoires.
  6. Sélectionnez une instance LDAP dans le volet gauche, puis cliquez sur Suivant.
  7. Saisissez le nom unique entier (DN) pour le conteneur LDAP du nouvel utilisateur dans le champ Nom unique de destination pour l'approvisionnement.
  8. Cliquez sur Confirmer les modifications.

Dépannage

Si l'authentification de répertoire LDAP échoue, les journaux de l'agent affichent des messages similaires à ceux présentés ci-après afin de fournir une assistance au diagnostic et à la résolution :

Agent: Réussite

Les résultats du scan scanResults sont envoyés avec les informations de l'utilisateur et du groupe.

POST initiated with result status=SUCCESS, actionType=USER_AUTH_AND_UPDATE, actionId=ADStflgt5KS4Gy17k0g3, diagnostic message=, error code=, matched dn=, message=SUCCESS, result code=, vendor=OPEN_LDAP

Agent : DelAuth failure

POST initiated with result status=FAILURE, actionType=USER_AUTH_AND_UPDATE, actionId=ADStftCWoSunnemFU0g3, diagnostic message=, error code=49, matched dn=cn=PasswordPolicyUser,ou=LynxyUsers,dc=okta-openldap, dc=com, message=LDAPException(resultCode=49 (invalid credentials), errorMessage='invalid credentials'), result code=invalid credentials, vendor=OPEN_LDAP

Agent: Aucun utilisateur

POST initiated with result status=FAILURE, actionType=USER_AUTH_AND_UPDATE, actionId=ADStfjpuawUSY1Gge0g3, diagnostic message=, error code=, matched dn=, message=User not found while executing query: (&(objectclass=inetorgperson)(uid=PasswordPolicyer@openldap.com)), result code=, vendor=OPEN_LDAP

Agent: Mot de passe expiré

POST initiated with result status=FAILURE, actionType=USER_AUTH_AND_UPDATE, actionId=ADStfhvei0D6IaFJO0g3, diagnostic message=, error code=49, matched dn=cn=PasswordPolicyUser, ou=LynxyUsers,dc=okta-openldap,dc=com, message=LDAPException(resultCode=49 (invalid credentials), errorMessage='invalid credentials'), result code=invalid credentials, vendor=OPEN_LDAP

Agent: Verrouillé/Désactivé

pwdLockout set as True for user pwdPolicy

POST initiated with result status=FAILURE, actionType=USER_AUTH_AND_UPDATE, actionId=ADSticrFpY0IyooMU0g3, diagnostic message=, error code=49, matched dn=cn=PasswordPolicyUser,ou=LynxyUsers,dc=okta-openldap,dc=com, message=LDAPException(resultCode=49 (invalid credentials), errorMessage='invalid credentials'), result code=invalid credentials, vendor=OPEN_LDAP