Vue d'ensemble

Les propriétés wrapper.cipher.<n>.* sont utilisées pour configurer des méthodes d'encodage (chiffrement ou obfuscation) qui peuvent être utilisées pour dissimuler vos mots de passe ou données sensibles.

Chaque index est identifié par un nom (à l'aide de la propriété wrapper.cipher.<n>.name) et regroupe plusieurs propriétés qui décrivent un encodage. La propriété wrapper.cipher.<n>.name est également liée à un ou plusieurs jeton(s) d'encodage dont le nom est écrit après la barre verticale (%...|<cipher_name>%).

NOTE

La configuration wrapper.cipher.<n>.* peut être générée automatiquement lorsqu'un texte est encodé avec la commande --encoding. Veuillez lire cette page pour apprendre à utiliser la commande --encoding.

Les propriétés suivantes sont disponibles :

Composant <n> :

Chaque élément a un nom de propriété qui commence par « wrapper.cipher. » et le composant « <n> » du nom de propriété est un nombre entier incrémenté à partir de « 1 ». Par défaut, la numérotation doit être séquentielle, sans interruption. La propriété wrapper.ignore_sequence_gaps peut éventuellement être définie pour autoriser des interruptions dans la séquence.

Propriété wrapper.cipher.<n>.name

Compatibilité :3.6.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Cette propriété spécifie un nom qui doit être unique parmi tous les index. Ce nom doit être constitué de caractères alphanumériques, de tirets ou de traits de soulignement. De plus, le nom ne peut pas être l'un des noms de méthodes d'encodage (c'est-à-dire « mask », « base64 », « base64url », « obf » ou « robf ») car ils font déjà référence aux configurations d'encodage par défaut qui ne peuvent pas être modifiées et ne doivent pas être écrites dans le fichier de configuration.

Lors de la spécification d'un fichier de clé privée, cette propriété est requise pour créer une définition d'encodage pouvant ensuite être utilisée par les jetons encodés. Cependant, cette propriété peut également être utilisée simplement pour spécifier un alias pour un encodage.

Exemple :
wrapper.cipher.1.name=r
wrapper.cipher.1.method=robf

# 'r' now refers to 'robf' and can be used after the vertical bar in encoded tokens:
wrapper.app.property.1=-Dmysecret=%5LF8WKKKnaOnCtwdGkK4aq|r%

Propriété wrapper.cipher.<n>.method

Compatibilité :3.6.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Cette propriété spécifie la méthode à utiliser pour encoder vos mots de passe ou données.

Les méthodes suivantes sont disponibles :

  • mask : avec cette méthode, le texte sera écrit en clair, mais sera masqué par des astérisques ('*') dans vos fichiers journaux

  • base64 : encodage Base64 standard

  • base64url : Base64 modifié pour les URL ('+' remplacé par '-', '/' remplacé par '_')

  • obf : méthode d'obfuscation propriétaire (la même entrée générera toujours la même sortie)

  • robf : méthode d'obfuscation aléatoire propriétaire (la même entrée générera des sorties aléatoires, ce qui la rend plus résistante à la cryptanalyse)

Propriété wrapper.cipher.<n>.private_keyfile

Compatibilité :3.6.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Cette propriété spécifie le chemin vers un fichier de clé privée pour les méthodes pouvant utiliser une clé privée (« obf » et « robf »). La valeur peut être un chemin absolu ou un chemin relatif au répertoire de travail.

La propriété wrapper.cipher.<n>.private_keyfile doit être définie conjointement avec le nom et la méthode.

Exemple :
wrapper.cipher.1.name=r1
wrapper.cipher.1.method=robf
wrapper.cipher.1.private_keyfile=../conf/secure/r1.key

NOTE

La commande --keygen peut être utilisée pour générer des clés privées. Veuillez lire cette section pour plus de détails.

AVERTISSEMENT

Il est très important de stocker votre clé dans un dossier sécurisé et de limiter les permissions accordées au strict minimum. Habituellement, seul l'utilisateur exécutant le Wrapper devrait être autorisé à y accéder.

Veuillez lire cette page pour apprendre à ajuster les permissions de votre clé privée.

Référence : Sécurité

Configuration du chiffrement :

Fichiers sécurisés :

Commandes :