Clé de l’App, secret de signature et clé CLI : les différences

Chaque App a une clé publique dès sa création. Le secret de signature n’existe qu’une fois le webhook créé. Seule la clé peut apparaître dans le code de votre site.

• Clé de l’App : elle identifie votre App dans le code d’installation et peut être partagée sans risque. Elle se trouve dans Paramètres de l’App > Développeurs > Démarrage et ne change pas.
• Secret de signature : il signe chaque appel du webhook. Il est créé avec la première adresse de webhook, dans Paramètres de l’App > Développeurs > Webhook, et reste sur votre serveur.
• Clé CLI : privée, elle commence par zk_cli_. Elle laisse la CLI Zean recevoir les événements de l’App sur l’ordinateur d’un développeur. Ce n’est jamais la clé de l’App. Elle se crée avec « Créer une clé CLI », dans Paramètres de l’App > Développeurs > Webhook > « Clé CLI ».
• Secret d’écoute : il signe les appels que la CLI Zean transmet, à la place du secret de signature. La commande l’affiche ; il change quand la clé CLI est régénérée.
• Contacts vérifiés : aucun secret. Votre App donne l’ID utilisateur de la personne connectée, voir l’article « Vérifier l’identité de vos Contacts ».

Régénérer le secret de signature

Si le secret a pu fuiter, cliquez sur « Régénérer » dans la section Webhook, puis mettez à jour votre serveur juste après : les appels du webhook sont signés avec le nouveau secret dès la régénération.

Régénérer la clé CLI

Si la clé CLI a pu fuiter, cliquez sur « Régénérer » dans « Clé CLI », puis confirmez. Chaque CLI Zean en cours s’arrête aussitôt et le secret d’écoute change : vos développeurs relancent la CLI Zean avec la nouvelle clé.

Développeurs, avec ses pages Démarrage, Domaine, apps et pages et Webhook, est réservé aux Admins et au Propriétaire. Où les clés et les secrets servent dans votre code : Documentation > Clés et secrets.