Aller au contenu

Service SQL IBM i (AS/400) · Fonction table

QSYS2.CHECK_PASSWORD

Vérifier un mot de passe selon les règles

Teste si un mot de passe respecte les règles de mot de passe du système et renvoie, en cas d'échec, l'identifiant et le texte du message.

À quoi ça sert

Cette fonction de table vérifie un mot de passe candidat (PASSWORD) par rapport aux règles de mot de passe définies par les valeurs système. Elle renvoie une ligne avec l'indicateur PASSWORD_VALID, l'identifiant du message, son texte et son texte de second niveau, qui explique précisément quelle règle n'est pas respectée.

Le paramètre facultatif AUTHORIZATION_NAME (défaut '*NONE') permet de tenir compte d'un profil, par exemple pour les règles qui comparent avec le nom du profil. On l'emploie pour valider un mot de passe avant de le changer, sans passer par CHGPWD ni créer d'échec dans le journal.

Résultat réel sur un IBM i 7.5

Pas de résultat publié : la fonction reçoit un mot de passe en paramètre.

L'exemple d'IBM

Vérifier si un nouveau mot de passe respecte les règles de mot de passe du système.

-- Description: Check a potential new password to see if it meets the system password rules. 
 SELECT * FROM TABLE(QSYS2.CHECK_PASSWORD('amIvalid?'));

Bon à savoir

Le mot de passe testé est transmis dans la requête : n'utilisez pas un mot de passe réel dans un script conservé ou dans une session journalisée.

Paramètres

ParamètreTypePar défautSignification
PASSWORD VARCHAR(512) obligatoire Mot de passe
AUTHORIZATION_NAME VARCHAR(10) '*NONE' Profil utilisateur

Colonnes renvoyées (4)

Afficher les 4 colonnes
ColonneTypeSignification
PASSWORD_VALID VARCHAR(3) Mot de passe valide
MESSAGE_ID CHAR(7) Identifiant du message
MESSAGE_TEXT GRAPHIC VARYING Texte du message
MESSAGE_SECOND_LEVEL_TEXT GRAPHIC VARYING Texte de second niveau du message