• mot de passe de connexion à une base de données.
• mot de passe d'un fichier de données.
• mot de passe du compte pour envoi d'email.
• token OAuth.
• mot de passe d'une feuille de tableur.
• mot de passe d'un document Word.
• etc.

Accès au coffre-fort

• soit utiliser le mot de passe maître.
  Ce mot de passe est défini à la création du coffre-fort. Ce mot de passe maître identifie le créateur du coffre-fort comme son propriétaire et permet de crypter le contenu des chaînes secrètes.
  
  Avertissement
  Les chaînes secrètes sont cryptées à partir du mot de passe maître. La perte de ce mot de passe entraîne la perte du contenu des données secrètes.
  L'accès au coffre-fort avec le mot de passe maître permet de créer des mots de passe secondaires. Un mot de passe secondaire permet par exemple à des collaborateurs de confiance d'accéder au contenu du coffre-fort.
• soit utiliser un mot de passe secondaire.
  L'accès au coffre-fort avec un mot de passe secondaire permet comme le mot de passe maître de créer, modifier, supprimer des chaînes secrètes. Cependant, il ne permet pas de créer de nouveaux mots de passe secondaires.
  
  

  Attention : Les mots de passe secondaires doivent être accordés à des utilisateurs de "confiance" car ces derniers peuvent manipuler les données présentes dans le coffre-fort sans restriction, notamment visualiser les mots de passe et les modifier.

Contenu du coffre-fort

• d'un identifiant. Cet identifiant permet d'utiliser le contenu de la chaîne secrète en paramètre des fonctions WLangage.
• d'un contenu secret. Ce contenu secret sera utilisé lors de l'exécution de l'application. Il sera crypté à l'aide du mot de passe maître. Ce contenu est visible et modifiable dans le coffre-fort uniquement si un mot de passe (maître ou secondaire) est utilisé.
• d'un contenu pour test. Ce contenu sera utilisé lors des tests de l'application. Il reste lisible par tous les utilisateurs du coffre-fort.

• le contenu secret sera masqué.
• le contenu pour test sera visible.

Utilisation des chaînes secrètes

• sur un projet,
• sur une collection de procédures. Dans ce cas, le coffre-fort pourra être partagé entre plusieurs projets via le GDS.

Créer un coffre-fort

1. Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Coffre-fort". L'assistant de création d'un coffre-fort s'affiche.
2. Dans l'assistant, définissez le mot de passe "Maître". Ce mot de passe permet d'identifier le créateur du coffre-fort. Conservez ce mot de passe précieusement.
   
3. Validez.

1. Dans le volet "Explorateur de projet", sélectionnez la procédure globale.
2. Affichez le menu contextuel de la procédure globale et sélectionnez l'option "Propriétés".
3. Dans la fenêtre qui s'affiche, cliquez sur "Accéder au Coffre-fort". L'assistant de création d'un coffre-fort s'affiche.
4. Dans l'assistant, définissez le mot de passe "Maître". Ce mot de passe permet d'identifier le créateur du coffre-fort. Conservez ce mot de passe précieusement.
5. Validez.

Créer un mot de passe secondaire

1. Ouvrez le coffre-fort :
   • Pour le coffre-fort du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Coffre-fort". La fenêtre de gestion du coffre-fort est affichée.
   • Pour le coffre-fort d'une collection de procédures : affichez les propriétés de la collection de procédure depuis le volet "Explorateur de projet" et cliquez sur "Accéder au coffre-fort".
2. Cliquez sur le volet "Mots de passe secondaires".
3. Ajoutez un mot de passe secondaire (bouton "+").
4. Dans la nouvelle ligne du tableau, indiquez le mot de passe et si nécessaire des informations spécifiques (nom de la personne ou de l'équipe concernée par exemple).

• Le bouton permet de générer un mot de passe automatiquement.
• Le bouton "Modifier le mot de passe maître" permet de réinitialiser le coffre-fort : les chaînes secrètes seront vidées (leur contenu sera effacé) et les mots de passe secondaires seront supprimés.

Définir des chaînes secrètes

1. Ouvrez le coffre-fort :
   • Pour le coffre-fort du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Coffre-fort". La fenêtre de gestion du coffre-fort est affichée.
   • Pour le coffre-fort d'une collection de procédures : affichez les propriétés de la collection de procédure depuis le volet "Explorateur de projet" et cliquez sur "Accéder au coffre-fort".
   La fenêtre de gestion des chaînes secrètes s'affiche :
   
2. Cliquez sur "+".
3. Dans la nouvelle ligne du tableau, indiquez :
   • l'identifiant : cet identifiant sera utilisé par les utilisateurs dans le code WLangage pour spécifier le mot de passe à utiliser. Indiquez un nom parlant.
   • le contenu de la chaîne secrète, c'est-à-dire le mot de passe en lui-même.
   • le type de la chaîne secrète. Ce type dépend de l'utilisation qui va être faite de la chaîne secrète (la fonction WLangage qui va l'utiliser).

Remarque : L'icône permet de visualiser le contenu des chaînes secrètes. Cette fonctionnalité nécessite la saisie d'un mot de passe (mot de passe maître ou secondaire).

Détecter les fonctions WLangage nécessitant des chaînes secrètes

1. Affichez la fenêtre de description du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
2. Dans l'onglet "Compilation", cochez l'option "Signaler les chaînes qui devraient être secrètes".
   
3. Validez.

1. Affichez le volet des erreurs de compilation : sous le volet "Accueil", dans le groupe "Environnement", déroulez "Volets" et sélectionnez "Volets" puis "Erreurs de compilation".
2. Cliquez sur l'icône .

Utiliser des chaînes secrètes

• La chaîne secrète MdpConnexionHFSQL a été définie dans le coffre-fort.
• Le code de connexion à la base de données est le suivant :
  

  MaConnexion est une Connexion
  // Description de la connexion
  MaConnexion.Utilisateur = "USER" 
  MaConnexion.MotDePasse = MdpConnexionHFSQL 
  MaConnexion.Serveur = "MONSERVEUR" 
  MaConnexion.BaseDeDonnées = "Base de données" 
  MaConnexion.Provider = hAccèsHFClientServeur 
  MaConnexion.Accès = hOLectureEcriture 
  MaConnexion.InfosEtendues = "Infos étendues" 
  MaConnexion.OptionsCurseur = hCurseurClient 
  HOuvreConnexion(MaConnexion)

Variable de type ChaîneSecrète

s est une ChaîneSecrète
SI EnModeTest ALORS
	s = BaseHFSQL_Tests
SINON
	s = BaseHFSQL_Production
FIN

HPasse("*", s)

Ouvrir un projet WINDEV ou WINDEV Mobile

Ouvrir un projet WEBDEV

• les différentes pages AWP / AWL sont générées en utilisant les mots de passe de test.
  Attention : Si vous utilisez un déploiement manuel des pages AWP / AWL, les mots de passe de test seront utilisés dans les pages déployées.
  
• lors de la génération du site, le mot de passe d'accès au coffre-fort est demandé afin de regénérer les pages en utilisant les chaînes secrètes d'exécution.

1. Affichez la fenêtre de paramétrage du mode test : sous le volet "Projet", dans le groupe "Mode test", déroulez "Mode test" et sélectionnez "Paramétrage du mode test" (Ctrl + Maj + F9).
2. Dans les options avancées, dans l'onglet "Coffres-forts", indiquez si les contenus pour le mode test ou les contenus secrets doivent être utilisés.
   
3. Validez.

• donner les mots de passe du ou des coffres-forts utilisé(s) par le projet.
• mémoriser les mots de passe sur le poste. Dans ce cas, les mots de passe du ou des coffres-forts ne seront plus demandés sur le poste en cours (pour toutes les actions nécessitant l'ouverture des coffres-forts).
• utiliser les contenus pour le mode test. dans ce cas, les contenus secrets pour test seront utilisées. Il ne sera pas nécessaire de préciser les mots de passe des coffres-forts.

Créer l'exécutable d'un projet utilisant un coffre-fort

Déployer un projet WEBDEV utilisant un coffre-fort