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ètre | Type | Par défaut | Signification |
|---|---|---|---|
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 |