DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques au WEB / 
  • Présentation
  • Applications
  • Applications utilisant le Groupware utilisateur
  • Utilisateurs et groupes
  • Serveur OAuth 2.0
  • Création d'un identifiant OAuth 2.0
  • Création des APIs pour Webservice
  • Gestion des scopes
  • Paramétrage SMTP
  • Options
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Présentation
Le site du Store Privé permet de gérer les différents services BaaS:
  • Store Privé.
  • Groupware utilisateur.
  • Serveur OAuth.
Le site du Store Privé est accessible depuis un navigateur avec l'adresse "http(s)://<serveur ou plateforme PCSCloud>/WDBaaS".
Depuis ce site, par défaut, les utilisateurs peuvent télécharger et installer les différentes applications disponibles dans le Store Privé:
  • Applications Windows,
  • Applications Mobiles,
Ils peuvent également lancer les sites Web accessibles depuis le Store Privé.
Les utilisateurs peuvent s'identifier dans le site du Store Privé: ils peuvent ainsi accéder aux différentes applications pour lesquelles ils possèdent des droits spécifiques d'utilisation.
La connexion d'un administrateur au Store Privé lui permet d'accéder à toutes les options d'administration via le bouton "Administration". Le site d'administration présente:
Applications
L'onglet "Applications" permet de gérer toutes les applications et sites accessibles depuis le Store Privé. Ces applications peuvent utiliser le groupware utilisateur via les services BaaS.
1. Proposer des applications dans le Store Privé
  • Les applications WINDEV peuvent être installées dans le Store Privé via le programme d'installation.
    Pour plus de détails, consultez Store Privé des applications WINDEV.
  • Les sites Web peuvent être ajoutés au portail via le bouton placé à côté de "Applications": . Sélectionnez l'option "Nouveau lien vers un site Web".
  • Les applications mobiles peuvent être ajoutées au Store Privé via le bouton placé à côté de "Applications" . Sélectionnez l'option "Nouvelle application mobile".
2. Caractéristiques d'une application présente dans le Store Privé
Pour une application disponible dans le Store Privé, l'onglet "Store Privé" permet de:
  • Définir le ou les propriétaires.
  • Définir le ou les mots-clés permettant de retrouver l'application dans le Store Privé.
  • Connaître le numéro de la version de référence de l'application et le numéro de version minimal nécessaire pour utiliser l'application.
    Pour forcer la mise à jour d'une application chez tous les utilisateurs, il suffit de cliquer sur le triangle devant le numéro de la version. Le triangle devient entièrement noir et indique qu'il s'agit de la version minimale obligatoire.
    Il est également possible de savoir si l'application a été téléchargée.
  • Transformer une application publique en application privée. Il est alors possible de définir des droits au téléchargement:
    • Téléchargement par tout le monde.
    • Téléchargement uniquement par les utilisateurs connectés.
    • Téléchargement uniquement par certains utilisateurs ou groupes.
  • Voir la liste des versions disponibles, ainsi que celle proposée en téléchargement.
3. Caractéristiques d'un site présent dans le Store Privé
Pour un site référencé dans le Store Privé, l'onglet "Store Privé" permet de:
  • Définir le ou les propriétaires.
  • Définir le ou les mots-clés permettant de retrouver le site dans le Store Privé.
  • Transformer un site public en site privé. Il est alors possible de définir la visibilité du site:
    • Tout le monde peut voir le site.
    • Seuls les utilisateurs connectés peuvent voir le site.
    • Site visible uniquement pour certains utilisateurs ou groupes.

Applications utilisant le Groupware utilisateur

Si l'application utilise le Groupware utilisateur via les services BaaS, de nouveaux onglets sont disponibles:
  • Gestion des droits: Permet de définir les droits des utilisateurs et des groupes d'utilisateurs sur les différents éléments de l'application.
  • Statistiques: Permet de visualiser l'historique des connexion à l'application pour un utilisateur, un groupe sur une période donnée.
  • Importation: Permet d'importer les tables du Groupware utilisateur classique dans les services BaaS de gestion du Groupware utilisateur.
  • OAuth / OpenID: Permet d'effectuer le paramétrage nécessaire pour une connexion automatique via Google, Salesforce, Microsoft, etc. Pour chaque mode de connexion choisi, il est nécessaire de saisir les identifiants nécessaires fournis lors de l'enregistrement de l'application sur la plateforme choisie.
Utilisateurs et groupes
L'onglet "Utilisateurs et groupes" permet de définir les différents utilisateurs du Store Privé et des applications disponibles.
Nouveauté Abonnement
Il est également possible de gérer les utilisateurs par programmation via les fonctions d'administration du WLangage. Le lien "Activer les fonctions d'administration WLangage" affiche la page de mise en place des fonctions WLangage.
  1. Saisissez un identifiant de connexion. Cet identifiant de connexion permet d'obtenir un Client ID et un Client Secret.
  2. Indiquez les permissions à accorder:
    • Autoriser la création d'utilisateurs uniquement.
    • Autoriser la lecture des informations des utilisateurs.
    • Tout autoriser (lecture, création, modification, suppression).
Le code de connexion avec l'identifiant créé permettant d'utiliser les fonctions WLangage est automatiquement généré. Il peut ainsi être copié dans l'application manipulant les fonctions WLangage de gestion des utilisateurs.
Remarque: Cette manipulation permet de créer rapidement un identifiant OAuth 2.0. Une gestion des autorisations peut également être effectuée via l'onglet "Serveur OAuth 2.0".
Attention : Cette fonctionnalité est disponible uniquement dans la version Abonnement à partir de WINDEV Suite 2025 Update 4.
Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite 2025 spécifiques à l'abonnement.
Serveur OAuth 2.0
L'onglet "Serveur OAuth 2.0" permet de créer un identifiant OAuth 2.0 et / ou des API pour webservices.

Création d'un identifiant OAuth 2.0

Pour créer un identifiant OAuth 2.0:
  1. Cliquez sur le lien "Créer votre premier identifiant OAuth 2.0" (ou sur le bouton "Ajouter un identifiant" présent dans l'onglet "Identifiants OAuth 2.0" si des identifiants ont déjà été créés).
  2. La page de configuration du nouvel identifiant OAuth 2.0 s'affiche. Cette page comporte 2 onglets:
    • Options générales: Permet de définir les paramètres de l'identifiant à créer.
    • Page de connexion: Permet de définir la page de connexion appelée lors de l'identification (dans le cas d'un token "Utilisateur").
    Par défaut, le token créé est un "Token utilisateur". Il est possible de le transformer en "Token d'application".
  3. Dans l'onglet "Options générales", les caractéristiques de l'identifiant sont automatiquement générées: Client ID, Client Secret et date de création.
  4. Complétez les informations concernant l'identifiant:
    • Nom de l'identifiant. Ce nom simplifiera sa recherche dans la liste des identifiants.
    • Autorisation de connexion. Si l'identifiant est actif, il sera utilisable en test et en production
    • Une ou plusieurs URL de redirection. Par défaut: http://localhost:9874
    • Durée de vie du token (10 jours par défaut).
    • Description littérale (optionnelle).
    • Indiquez si le token créé est un token utilisateur ou un token d'application.
      Dans le cas d'un token utilisateur, il est possible de définir la page de connexion.
    • Indiquez si le SSO est disponible pour cet identifiant.
  5. Copiez les informations Client ID et Client Secret car elles seront demandées dans l'application cliente lors de la demande d'un token.
  6. Cliquez sur "Enregistrer" pour valider la création de l'identifiant. Une page récapitulative apparaît avec les différentes URL nécessaires pour demander un token depuis l'application cliente.

Création des APIs pour Webservice

Il est possible d'associer un identifiant OAuth à une API REST. L'accès à une API REST sera autorisé en indiquant un token. Seul un token valide permettra d'accéder à l'API.
Pour définir des API pour Webservice:
  1. Cliquez sur le lien "Créer votre première API pour Webservices" (ou sur le bouton "Ajouter une API" présent dans l'onglet "APIs pour Webservices" si des APIs ont déjà été créés).
  2. Saisissez les différentes informations correspondant au point d'entrée de l'API:
    • Nom
    • URL de l'API,
    • Description (optionnelle).
  3. Ajoutez les permissions (scope) nécessaires.
    Remarque: Les" scopes" sont décrits dans les APIs. Ils permettent notamment de filtrer les fonctionnalités en fonction de l'identifiant.
  4. Cliquez sur "Enregistrer" pour valider la création de l'API.
  5. Cliquez sur l'onglet "Identifiants OAuth 2.0".
  6. Editez l'identifiant OAuth 2.0 à associer à l'API.
  7. Cliquez sur l'onglet "APIs".
  8. Cochez les APIs auxquelles l'application cliente aura le droit d'accéder.
  9. Cliquez sur "Enregistrer".

Gestion des scopes

Les "scopes" (également appelés "Permission" ou "Champ d'application") correspondent à un mécanisme d'OAuth 2.0 permettant de limiter l'accès d'une application au compte d'un utilisateur. Une application peut demander un ou plusieurs "scopes". Ces informations sont présentées à l'utilisateur dans un écran de consentement et le jeton d'accès délivré à l'application sera limité aux permissions accordées.
Par défaut, lors d'une connexion via OpenID, les scopes supportés sont:
  • "openid": permet de vérifier l'identité de l'utilisateur.
  • "profile": permet d'obtenir le nom de l'utilisateur.
  • "email": permettant de connaître l'adresse email de l'utilisateur.
Ces scopes sont connus via la fonction OpenIDLitIdentité.
Il est possible d'ajouter des scopes.
Il est possible de spécifier les scopes à utiliser via la propriété Scope des variables de type OpenIDParamètres et OAuth2Paramètres. La valeur de ces scopes peut être connue via la propriété "Source" de la variable de type OpenIDIdentité: il suffit de rechercher la valeur dans le JSON correspondant.
Nouveauté Abonnement
WDBaaS intègre désormais une nouvelle API (webservice sécurisé par token OAuth) dédiée à la gestion des utilisateurs enregistrés sur le serveur.
La configuration de l’API (permissions/scopes pour l’ajout, la modification, la suppression, etc. des utilisateurs) s’effectue simplement depuis l’interface d’administration de WDBaaS.
Pour configurer cette API:
  1. Sélectionnez l'onglet "Serveur OAuth 2.0".
  2. Sélectionnez l'identifiant OAuth 2.0 voulu.
  3. Dans la description de l'identifiant, cliquez sur l'onglet "APIs".
  4. Editez l'élément "Gestion des utilisateurs (administration)".
  5. Indiquez les permissions de l'utilisateur:
    • wdbaas:users:create: permission de créer un utilisateur.
    • wdbaas:users:delete: permission de supprimer un utilisateur.
    • wdbaas:users:read: permission de lire les informations d'un utilisateur.
    • wdbaas:users:readwrite: permission de lire et de modifier un utilisateur.
    • wdbaas:users:update: permission de modifier un utilisateur.
  6. Validez.
Il suffit de fournir à l’application cliente les identifiants (ClientID et Client Secret) pour accéder à l’API via la fonction WLangage AuthIdentifie.
Attention : Cette fonctionnalité est disponible uniquement dans la version Abonnement à partir de WINDEV Suite 2025 Update 4.
Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite 2025 spécifiques à l'abonnement.
Paramétrage SMTP
L'onglet "Paramétrage SMTP" permet de définir les options SMTP permettant de définir les options du serveur SMTP utilisé pour envoyer des emails aux utilisateurs, par exemple lors de la réinitialisation du mot de passe.
Options
L'onglet "Options" regroupe toutes les options de personnalisation et de configuration du Store Privé:
  • Personnalisation de la page du Store Privé: Il est possible de modifier le libellé du Store Privé, apparaissant dans le bandeau du site (par défaut, "Catalogue d'applications"). Il est également possible d'afficher une section "Applications à la une".
  • Ajout d'applications Windows: Permet d'indiquer si tous les utilisateurs peuvent ajouter ou non des applications dans le Store Privé (ce paramétrage est réglable également au niveau de chaque utilisateur).
  • Suppression automatique des anciennes versions des applications: Permet d'indiquer le nombre maximum de versions à conserver.
  • Utilisation d'un proxy (optionnel): Permet de spécifier une URL spécifique pour générer les QRCode de téléchargement.
  • Gestion des comptes utilisateurs: Permet de spécifier les droits pour la création de comptes: tous les utilisateurs, aucun ou uniquement quelques utilisateurs. Les utilisateurs peuvent également être dans un annuaire LDAP (via une connexion sécurisée si nécessaire).
  • Règles d'activation des nouveaux utilisateurs: L'activation peut être automatique ou par email.
  • Double authentification: La double authentification peut être obligatoire ou activée uniquement par l'utilisateur. Il est possible d'afficher un message à l'utilisateur afin qu'il contacte un administrateur en cas d'impossibilité d'obtenir le code.
  • Clé du reCAPTCHA: Permet de saisir les informations de reCAPTCHA version 3 (informations disponibles dans la console Google de l'application).
  • Réinitialisation du Token: A l'installation du Serveur d'application, un token de connexion a été fourni. En cas de perte, ce token peut être regénéré.
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 24/09/2025

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