Aller au contenu

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

SYSTOOLS.ADD_VALIDATION_LIST_ENTRY

Ajouter une entrée à une liste de validation

Fonction scalaire qui ajoute une entrée d'authentification (utilisateur, mot de passe, données) dans une liste de validation IBM i, sans commande CL.

À quoi ça sert

SYSTOOLS.ADD_VALIDATION_LIST_ENTRY ajoute une entrée dans une liste de validation (objet *VLDL). On indique la bibliothèque (VALIDATION_LIST_LIBRARY), le nom de la liste (VALIDATION_LIST_NAME), l'utilisateur (VALIDATION_USER), son mot de passe (PASSWORD) et, facultativement, des données associées (ENTRY_DATA).

Ces listes servent à authentifier des utilisateurs d'interfaces externes (par exemple un serveur web) sans créer de profil utilisateur IBM i. L'exemple d'IBM place le mot de passe dans une variable globale pour qu'il n'apparaisse pas dans l'appel de la fonction.

La liste doit déjà exister : on la crée avec la commande CL CRTVLDL.

Résultat réel sur un IBM i 7.5

Pas de démonstration : la fonction ajoute une entrée, avec son mot de passe, dans une liste de validation.

L'exemple d'IBM

Ajouter une entrée d'authentification pour un utilisateur d'une interface externe, en passant par une variable globale pour que le mot de passe n'apparaisse pas dans l'appel.

-- Description: Add an authentication entry for a user of an external interface. 
     --   Use a global variable so the password is not visible in the function invocation. 
     --   for all user profiles on the system. 
     CREATE VARIABLE MYLIB.VLDL_PW VARCHAR(100); 
 
SET MYLIB.VLDL_PW = 'password for my user access'; 
 
VALUES SYSTOOLS.ADD_VALIDATION_LIST_ENTRY( 
                             VALIDATION_LIST_LIBRARY => 'APPLIB',  
                             VALIDATION_LIST_NAME    => 'APPVLDL', 
                             VALIDATION_USER         => 'my application user name', 
                             PASSWORD                => MYLIB.VLDL_PW);

Bon à savoir

Utilisez une variable globale comme dans l'exemple : un mot de passe écrit en clair dans l'instruction se retrouve dans les journaux de travail et l'historique SQL.

Paramètres

ParamètreTypePar défautSignification
VALIDATION_LIST_LIBRARY VARCHAR(10) obligatoire Bibliothèque de la liste de validation
VALIDATION_LIST_NAME VARCHAR(10) obligatoire Nom de la liste de validation
VALIDATION_USER VARCHAR(100) obligatoire Utilisateur de la liste de validation
PASSWORD VARCHAR(600) obligatoire Mot de passe
ENTRY_DATA VARCHAR(1000) NULL Données de l'entrée