Clés & signature
Les serveurs DayZ qui vérifient les signatures n'acceptent un mod que si chacun de ses PBO porte une signature faite avec une clé à laquelle le serveur fait confiance. Cette page crée votre paire de clés, signe des PBO et vérifie un dossier de mod comme le fait un serveur. Elle remplace DSCreateKey, DSSignFile et DSCheckSignatures de Bohemia et produit les mêmes fichiers. Il vous faut des PBO empaquetés à signer (Packer PBO ou Compiler le mod sur Steam Workshop).
C'est la deuxième étape du chemin de build et de publication : empaqueter, signer, tester dans le Launcher, publier depuis Steam Workshop. Vous créez une clé une fois ; ensuite, Compiler le mod signe pour vous avec elle.
L'écran
- Créer une paire de clés (en haut à gauche) : Nom de l'autorité (le nom de votre clé),
Taille de clé, Dossier de sortie, Générer. Écrit
<name>.biprivatekeyet<name>.bikeydans le dossier. La première clé que vous créez devient la clé par défaut. - Signer des PBO (en haut à droite) : Clé privée (préremplie avec la clé par défaut), la
cible (un dossier de mod comme
@MyModou son dossieraddons, ou un seul PBO via Fichier PBO…), l'option Supprimer les signatures d'autres clés et copier la .bikey dans le keys/ du mod (activée par défaut), Signer, Définir comme clé par défaut, et un journal de chaque fichier écrit ou supprimé. - Vérifier les signatures (en bas) : Dossier du mod, Clés de confiance (un fichier
.bikeyou un dossier de fichiers ; vide, utilise le dossierkeys/du mod), Vérifier, puis un tableau avec une ligne par PBO : valide, non signé, clé inconnue, INVALIDE ou erreur, avec le détail.
Premiers pas
- Dans Créer une paire de clés, saisissez un nom d'autorité : le tag de votre mod, sans
espaces (par exemple
MyModTag). - Choisissez un dossier de sortie hors de votre dossier de mod (par exemple un dossier
keysdans vos documents, ouci/keysde votre projet si ce dossier n'est pas publié). - Appuyez sur Générer. Deux fichiers sont écrits, et la clé devient votre clé par défaut.
- Dans Signer des PBO, choisissez le dossier de votre mod construit (
…/target/@MyMod) et appuyez sur Signer. Chaque PBO reçoit un.bisign, et votre.bikeyest copiée dans@MyMod/keys/. - Dans Vérifier les signatures, choisissez le même dossier de mod et appuyez sur Vérifier : chaque ligne doit être valide.
Suivre la visite guidée (dans l'app)
Tâches courantes
Créer votre paire de clés (une fois)
- Nom de l'autorité, dossier de sortie, Générer.
- Sauvegardez le
.biprivatekeyen lieu sûr. Si vous le perdez, vous ne pouvez plus signer de mises à jour avec la même clé, et les propriétaires de serveurs doivent installer une nouvelle.bikey.
Signer un mod entier
- Clé privée : votre
.biprivatekey. - Cible : le dossier
@Mod(chaqueaddons/*.pboest signé). - Gardez l'option de nettoyage cochée, appuyez sur Signer, lisez le journal.
Signer un seul PBO
- Appuyez sur Fichier PBO… et choisissez le
.pbo. - Signer. Le
.bisignest écrit à côté. Si le PBO n'est pas dans un dossier@Mod/addons, le journal dit qu'il n'y a pas de dossierkeys/où copier la.bikey.
Vérifier un mod avant de le donner à un serveur
- Dossier du mod : le dossier
@Mod. - Laissez Clés de confiance vide pour vérifier avec
@Mod/keys, ou pointez-le vers le dossierkeysd'un serveur pour savoir ce que ce serveur dirait. - Vérifier. Corrigez tout ce qui n'est pas valide : non signé (signez-le), clé
inconnue (la
.bikeyde cette signature ne figure pas parmi les clés de confiance), INVALIDE (le PBO a changé après sa signature : signez de nouveau).
Définir une clé par défaut
- Mettez son chemin dans Clé privée, appuyez sur Définir comme clé par défaut.
- La page PBO (« Signer après l'empaquetage ») et Compiler le mod l'utilisent quand le projet n'a pas de clé propre.
Exemples
Cette page n'a pas d'exemple à ouvrir : elle travaille sur vos propres clés et mods. Pour voir de
vraies signatures, regardez un dossier de mod Workshop sur votre disque : son dossier addons a
un .bisign à côté de chaque .pbo et son dossier keys contient la .bikey de l'auteur.
Vérifier un tel dossier est sans risque : Vérifier ne fait que lire.
Concepts
.biprivatekey: votre clé privée. Elle fabrique les signatures. Quiconque la possède peut signer des PBO en votre nom. Elle reste sur votre ordinateur et n'est jamais publiée, versée dans un dépôt public, envoyée à un propriétaire de serveur ni montrée à un assistant..bikey: la clé publique correspondante. Elle ne peut que vérifier des signatures. Elle est faite pour être donnée : elle est livrée dans le dossierkeys/de votre mod..bisign: la signature d'un PBO faite avec une clé privée, nommée<pbo name>.<authority>.bisign, stockée à côté du PBO dansaddons/. Cette page écrit des signatures de version 3, la version qu'utilise DayZ.- Autorité : le nom contenu dans une clé et ses signatures ; c'est ainsi qu'une signature retrouve sa clé.
- Où va chaque fichier :
@MyMod/addons/x.pboet@MyMod/addons/x.pbo.<authority>.bisign: livrés avec le mod.@MyMod/keys/<authority>.bikey: livrée avec le mod, pour les propriétaires de serveurs.<DayZ Server>/keys/<authority>.bikey: le propriétaire du serveur la copie là. Un serveur fait confiance exactement aux clés de son dossierkeys/. Le Launcher fait cette copie pour vous quand il démarre un serveur local.<authority>.biprivatekey: nulle part ailleurs que sur votre machine et votre sauvegarde.verifySignatures: le réglage de la config du serveur (serverDZ.cfg) qui fait vérifier les signatures par le serveur.verifySignatures = 2;est la valeur à utiliser ; les diagnostics du Launcher signalent toute autre valeur. Quand il est activé, un client qui charge un PBO dont le serveur ne fait pas confiance à la signature est expulsé. Référence : la page « DayZ:Server Configuration » du wiki communautaire de Bohemia Interactive, https://community.bistudio.com/wiki/DayZ:Server_Configuration.- Un seul jeu de clés par mod : un PBO signé par deux clés, ou un
.bisignrésiduel d'une ancienne clé, trouble les vérifications et les envois. L'option de nettoyage supprime les signatures du même PBO faites avec d'autres clés et liste chaque fichier supprimé.
Pièges
- Publier la clé privée : ne générez jamais la clé dans le dossier que vous envoyez
(
@MyMod). Les vérifications préalables du Workshop refusent un envoi qui contient une clé privée. - Réempaqueter après la signature : un PBO modifié après signature est INVALIDE. Signez toujours en dernier. Compiler le mod supprime les signatures périmées et signe de nouveau.
- Oublier la
.bikey: sanskeys/<authority>.bikeydans le mod, les propriétaires de serveurs ne peuvent pas lui faire confiance. L'option de nettoyage et Compiler le mod l'y placent. - Perdre la clé : une nouvelle clé signifie une nouvelle
.bikeypour chaque serveur qui fait tourner votre mod. - « clé inconnue » sur un mod que vous venez de signer : les clés de confiance avec
lesquelles vous avez vérifié n'incluent pas votre
.bikey; laissez le champ vide pour utiliser lekeys/du mod. - Boutons grisés : survolez-les, l'infobulle dit ce qui manque (nom d'autorité, dossier de sortie, clé, cible, dossier du mod).
Pour les agents
- Outils de
dztqui font le même travail sans la fenêtre : sign_create_key: crée une paire.biprivatekey+.bikey(comme DSCreateKey).sign_pbo: signe un PBO ou chaque PBO d'un dossier de mod (v3) ; comme la page, supprime les signatures du même PBO faites par d'autres clés et copie la.bikeydans lekeys/du mod.sign_check: vérifie un dossier de mod avec des fichiers.bikeyde confiance (par défaut : lekeys/du mod).pbo_packavec une clé signe juste après l'empaquetage ;mod_buildsigne le mod entier.- Fichiers lus : la
.biprivatekey, les PBO, les fichiers.bikeydes clés de confiance ou de@Mod/keys(aussiKeys). Fichiers écrits : la paire de clés dans le dossier choisi ;.bisignà côté de chaque PBO ;@Mod/keys/<authority>.bikey; les.bisignd'autres clés sont supprimés quand l'option de nettoyage est activée. Le chemin de la clé par défaut est stocké dans les paramètres (private_key). - État de la page transmis à l'assistant : l'autorité en cours de création, le PBO ou dossier à signer, le dossier de mod vérifié, les clés de comparaison, et comme problèmes chaque ligne de vérification qui n'est pas valide plus les lignes d'avertissement / d'erreur du journal de signature. Les fichiers de clés sont nommés, jamais lus ni envoyés. Ne demandez jamais à l'utilisateur de coller une clé privée.
- Ancres :
signing-create,signing-generate,signing-sign,signing-tidy,signing-sign-button,signing-set-default,signing-check,signing-check-button.
Voir aussi
- Packer PBO : empaqueter (et éventuellement signer) un addon.
- Steam Workshop : Compiler le mod empaquette et signe le mod entier, puis le publie.
- Launcher : son onglet Diagnostics vérifie
verifySignatureset les mods non signés. - Présentation de Beans Workbench.