• Authentification sécurisée,
• Gestion des autorisations,
• Emission des jetons d'accès et de leur rafraîchissement,
• Gestion des droits associés au jeton ("scope").

1. Installer un serveur HFSQL sur le serveur Web.
2. Installer le Serveur d'application WEBDEV en choisissant les services BaaS.
3. Lancer le site d'administration Baas et créer les identifiants OAuth.

Pré-requis: installation d'un serveur HFSQL

Installation du Serveur d'application WEBDEV

1. Sélectionnez la langue d'installation du Serveur d'application WEBDEV et validez.
2. Sélectionnez "Installer une version complète" et saisissez la clé d'activation. Passez à l'étape suivante de l'assistant.
3. Acceptez la licence. Passez à l'étape suivante de l'assistant.
4. Sélectionnez le répertoire d'installation ("C:\WEBDEV" par défaut).
5. Sélectionnez le mode de fonctionnement du Serveur d'application WEBDEV:
   • L'option "Serveur autonome" permet de réaliser l'installation classique du Serveur d'application WEBDEV.
   • L'option "Cluster" permet installer un cluster de serveurs WEBDEV.
   Sélectionnez "Serveur autonome" et passez à l'étape suivante de l'assistant.
6. Cette étape permet de spécifier le répertoire racine pour le déploiement des sites et des Webservices. Conservez le chemin indiqué par défaut et passez à l'étape suivante.
7. Si le Serveur d'Application WEBDEV n'a jamais été installé sur le poste, indiquez les paramètres d'un compte Windows qui sera utilisé comme administrateur WEBDEV. Ce compte sera également appelé "Compte d'hébergement".
   Il est possible de créer un nouveau compte Windows ou d'utiliser un compte Windows existant.
   
   
   Sélectionnez l'option de votre choix et passez à l'étape suivante.
8. Si une version précédente du Serveur d'Application WEBDEV a été installée sur le poste, l'assistant permet:
   • de définir la gestion des sites et webservices des versions antérieures. Conservez l'option "Conserver les sites dans leurs versions actuelles" et passez à l'étape suivante.
   • d'importer les comptes WEBDEV. Conservez l'option "Ne pas importer de comptes existants" et passez à l'étape suivante. Indiquez le login et le mot de passe d'un compte Windows qui sera utilisé comme administrateur WEBDEV. Ce compte sera également appelé "Compte d'hébergement".
     Il est possible de créer un nouveau compte Windows ou d'utiliser un compte Windows existant.
     Sélectionnez l'option de votre choix et passez à l'étape suivante.
9. Cette étape permet d'activer ou non les sites d'administration à distance:
   • Site d'administration du serveur d'application WEBDEV.
   • Site d'administration HFSQL.
10. L'étape suivante permet de gérer l'hébergement de sites SaaS. L'activation du SaaS installe automatiquement un site et un Webservice pour administrer vos sites SaaS. Pour plus de détails, consultez SaaS. Validez cette étape.
11. Les étapes suivantes permettent d'activer certaines fonctionnalités du Serveur d'application WEBDEV: Réplication et télémétrie. Cette activation peut être effectuée a posteriori via l'administrateur du Serveur d'application WEBDEV.
    Dans notre cas, ce serveur n'est pas nécessaire. Conservez l'option par défaut.
12. L'étape suivante permet d'activer les services BaaS: gestion des utilisateurs, authentification et Store Privé.
    Dans notre cas, sélectionnez l'option "Activer BaaS". Passez à l'étape suivante.
13. Spécifiez les caractéristiques du serveur HFSQL utilisé pour le service BaaS.
    Remarque: Ce serveur HFSQL a été installé précédemment.
    
    Ces caractéristiques sont les suivantes:
    • Nom du serveur HFSQL,
    • Port.
    • Nom et mot de passe de l'administrateur du Serveur HFSQL. Ces informations sont nécessaires pour configurer automatiquement la base de données WDBaaS et l'utilisateur associé.
14. Testez la connexion pour vérifier vos paramètres (bouton "Tester la connexion").
15. Indiquez les paramètres spécifiques à la base de données WDBaaS utilisée par le groupware utilisateur/Store Privé/Authentification OAuth:
    • le nom de la base de données dédiée: WDBAAS par défaut.
    • le nom de l'utilisateur de cette base et son mot de passe.
16. Indiquez le mot de passe des tables WDBaaS utilisées (existantes ou à créer).
17. Indiquez le mot de passe de l'administrateur du site WDBaaS (l'utilisateur est "Admin").
18. Cette base de données et son utilisateur vont être automatiquement créés.
19. Passez à l'étape suivante.
20. Cette étape permet d'activer l'accès aux bases tierces.
    Dans notre cas, cet accès n'est pas nécessaire. Conservez l'option par défaut.
21. Spécifiez si une connexion SSL doit être utilisée pour les sites d'administration à distance.
22. Dans l'étape suivante, indiquez si le pilote ODBC doit être installé.
23. L'étape suivante permet d'activer ou non des paramètres avancés.
24. Passez à l'étape suivante.
25. Le résumé des informations d'installation est affiché.
26. Passez à l'étape suivante.
27. L'assistant vérifie si un serveur Web est présent sur le poste d'installation.
    • Si aucun serveur Web n'est installé sur le poste d'installation, l'assistant propose d'en installer un et de le configurer pour utiliser le serveur d'application WEBDEV.
    • Si un serveur Web est présent sur le poste d'installation, l'assistant le configure pour utiliser le serveur d'application WEBDEV.
28. A la fin de l'installation, l'assistant affiche un récapitulatif de ce type:
    
    Token de connexion au serveur WDBaaS à fournir à l'environnement de développement:
    WDXxxxxxxxxxxxxxxxxxxxxx
    
    Compte HFSQL à utiliser pour que le site et le webservice WDBaas accèdent au serveur HFSQL:
    - Serveur: xxx
    - Base de données: xxx
    - Utilisateur xxx - Mot de passe: xxx
    
    Le mot de passe des fichiers est: xxx
    
    Le mot de passe de l'administrateur du site WDBaaS (Utilisateur: xxx) est: xxxx
    
    Copiez et conservez ces informations. Le token de connexion au serveur WDBaaS doit être utilisé:
    • dans la fenêtre de paramétrage du groupware utilisateur de votre projet WINDEV.
    • dans la fenêtre de paramétrage du groupware utilisateur/Store Privé dans votre projet WINDEV Mobile.
    • dans la fenêtre de paramétrage du groupware utilisateur de votre projet WEBDEV.
29. Terminez l'assistant. Vous pouvez directement lancer le site WDBaaS d'administration du Store Privé.

Avertissement
Même si vous utilisez uniquement la fonctionnalité OAuth, il est recommandé de conserver l'ensemble de ces informations. Elles seront nécessaires en cas d'utilisation du Store Privé.

Lancement du site du Store Privé

1. Lancez le Store Privé: http(s)://Nommachine/WDBAAS.
   
   Avertissement
   Il est nécessaire de lancer le Store Privé en spécifiant le nom de la machine (ou son adresse IP) et non "localhost".
2. Cliquez sur "Connexion".
3. Saisissez le login et le mot de passe du compte de l'administrateur WDBAAS. Ces informations ont été fournies à la fin de l'installation du Serveur d'application WEBDEV.
4. Cliquez sur le bouton "Administration".
5. Cliquez sur l'onglet "Serveur OAuth 2.0".

Création d'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

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

• "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.

Utilisation d'un token de type "Application"

AuthParam est un OAuth2Paramètres
tok est un AuthToken

AuthParam.ClientID = "b18b7850-8f4a-4d2a-9ee2-309876b36ba6"
AuthParam.ClientSecret = "4b3e99d8-b736-430e-a780-cb1586927e2d"
AuthParam.URLAuth = "http://doc-7/oauth2/v1/authorize"
AuthParam.URLToken = "http://doc-7/oauth2/v1/token"
AuthParam.URLRedirection = "http://localhost:9874"
AuthParam.TypeAutorisation = taApplicationCliente

tok = AuthIdentifie(AuthParam)
SI ErreurDétectée ALORS
	Erreur(ErreurInfo())
SINON
	Info(tok.Valeur, tok.DateExpiration)
FIN

Utilisation d'un token de type "Utilisateur"

AuthParam est un OAuth2Paramètres
tok est un AuthToken

AuthParam.ClientID = "b18b7850-8f4a-4d2a-9ee2-309876b36ba6"
AuthParam.ClientSecret = "4b3e99d8-b736-430e-a780-cb1586927e2d"
AuthParam.URLAuth = "http://doc-7/oauth2/v1/authorize"
AuthParam.URLToken = "http://doc-7/oauth2/v1/token"
AuthParam.URLRedirection = "http://localhost:9874"

tok = AuthIdentifie(AuthParam)
SI ErreurDétectée ALORS
	Erreur(ErreurInfo())
SINON
	Info("Valeur token " + tok.Valeur, "Date expiration " + tok.DateExpiration)
	MonIdentité est une OpenIDIdentité = OpenIDLitIdentité(tok)
	SI MonIdentité.Valide ALORS
		Trace("Mail: " + MonIdentité.Email)
		Trace("Nom: " + MonIdentité.Nom)
		Trace("Prénom: " + MonIdentité.Prénom)
	FIN
FIN

openidParam est un OpenIDParamètres

openidParam.ClientID = "8351ea5f-19b6-4789-87ea-6ba01a3dffd2"
openidParam.ClientSecret = "597fcab9-f76d-4555-abdb-06adcfeaf7d8"
openidParam.URLConfiguration = "http://doc-7/.well-known/openid-configuration"
openidParam.URLRedirection = "http://localhost:9874"
openidParam.TypeAutorisation = taCodeAutorisation

tok = AuthIdentifie(openidParam)
SI ErreurDétectée ALORS
	Erreur(ErreurInfo())
SINON
	Info(tok.Valeur, tok.DateExpiration)
FIN