DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques au WEB / Fonctions diverses WEBDEV
  • Mode d'authentification
  • Sessions prélancées
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
CertificatClientInfo (Fonction)
En anglais : CertificateClientInfo
Renvoie des informations sur le certificat utilisé par le poste client lors d'une connexion Web avec authentification par certificat.
Exemple
// Vérifie si le certificat est présent et valide
SI DoitEtreAuthentifié = Vrai ALORS
	SI CertificatClientInfo(certificatClientPrésent) = Faux 
		OU CertificatClientInfo(certificatClientValide) = Faux ALORS
		// Erreur
		...
		RETOUR
	FIN
	// Vérification des droits de l'utilisateur
	...
FIN
// Affiche dans un champ de saisie 
// le numéro de série du certificat client utilisé 
SAI_NumSérie = CertificatClientInfo(certificatClientNuméroSérie)

// Récupère le pays du certificat client utilisé 
SAI_CertificatClientPays_Objet = CertificatClientInfo(certificatClientObjet, certificatClientPays)
Syntaxe
<Résultat> = CertificatClientInfo(<Information> [, <Sous information>])
<Résultat> : Variant
Information demandée.
<Information> : Constante de type Entier
Information demandée sur le certificat client :
certificatClientEmetteurIdentification de l'émetteur du certificat. Il est possible d'extraire uniquement une partie des informations en utilisant le paramètre <Sous information>.
Exemple de chaîne renvoyée : CERT_ISSUER=C=FR,S=NA,L=MONTPELLIER, O=PCSOFTQUAL,CN=caqual,E=qual@pcsoft1.fr
certificatClientNuméroSérieNuméro de série du certificat (sous forme d'une chaîne hexadécimale). Exemple : "00E48E2E3503C8317A"
certificatClientObjetIdentification du certificat. Il est possible d'extraire uniquement une partie des informations en utilisant le paramètre <Sous information>.
Exemple de chaîne renvoyée : CERT_SUBJECT=C=FR,S=NA,L=MONTPELLIER, O=PCSOFTQUAL,CN=twr4m.pcsoft.com,E=qual@pcsoft1.fr
certificatClientPrésentIndique si un certificat a été transmis par le poste client (Vrai) ou non (Faux).
certificatClientValideIndique si un certificat client est validé par le serveur (Vrai) ou non (Faux).
<Sous information> : Constante de type Entier optionnelle
Permet d'extraire une information précise (paramètre utilisé uniquement avec les constantes certificatClientEmetteur et certificatClientObjet). Toutes les informations ne sont pas toujours disponibles.
Les constantes acceptées sont les suivantes :
certificatClientDistinguishedName
(Valeur par défaut)
Liste complète des caractéristiques du certificat. La valeur retournée est une chaîne dont les différentes composantes sont séparées par une virgule. Par exemple SSL_CLIENT_I_DN=,C=FR,ST=NA,L=MONTPELLIER, O=PCSOFTQUAL,CN=caqual,emailAddress=qual@pcsoft1.fr
Les constantes suivantes permettent d'obtenir une seule information.
certificatClientEmailAdresse email.
certificatClientEtatEtat où le certificat a été créé.
certificatClientIdentifiantUtilisateurIdentifiant utilisateur.
certificatClientLocalitéLocalité associée au certificat.
certificatClientNomUsuelNom usuel.
certificatClientPaysPays associé au certificat.
certificatClientServiceNom du service.
certificatClientSociétéSociété.
Remarques

Mode d'authentification

Deux modes d'authentification des clients auprès du serveur Web sont disponibles :
  • authentification par le serveur Web. Ce type d'authentification repose généralement sur l'authentification en tant que utilisateur du domaine ou utilisateur du serveur.
  • authentification par certificat. Dans ce cas, les vérifications suivantes sont effectuées :
    • Vérification de la présence d'un certificat.
    • Vérification de la validité du certificat.
    • Vérification des autorisations de l'utilisateur.

Sessions prélancées

Si votre projet utilise les sessions prélancées, cette fonction ne doit pas être utilisée dans l'événement "Initialisation" du projet. Cette fonction doit être utilisée dans l'événement "Initialisation lors d'une connexion à une session prélancée".
Composante : wd300page.dll
Version minimum requise
  • Version 16
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 27/08/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale