Journalisation des données
En vigueur le [date de publication]
| Application | TuneCraft : automatisation et nettoyage du site, une application Jira Cloud conçue sur Atlassian Forge |
|---|---|
| Fiche Marketplace | Pas encore inscrite. TuneCraft n’est pas encore sur le Marketplace d’Atlassian, et sa clé d’application sera ajoutée ici lorsqu’elle le sera. |
| Identifiant de l’application Forge | ari:cloud:ecosystem::app/facece90-dfd5-4792-9bff-6a5bd061a341 |
| Éditeur | Logiciels Plugincraft inc., société constituée en vertu des lois du Québec, Canada |
En bref
- Les journaux de l’application contiennent des identifiants, des nombres, des statuts et des codes d’erreur.
- Ils ne contiennent jamais de noms de flux, de texte de requêtes, de valeurs de champs, de noms ni d’adresses courriel.
- Un test automatisé fait échouer la compilation si le code journalise autre chose.
- Atlassian conserve les journaux, et ne les conserve pas à l’emplacement de résidence des données de votre site.
Ce que sont les journaux
Lorsqu’une fonction Forge de l’application s’exécute, elle peut écrire des lignes de journal. Atlassian les conserve et les met à la disposition de Plugincraft en tant que développeur. L’application n’utilise aucun service de journalisation externe. Comme les journaux ne sont pas conservés à l’emplacement de résidence des données de votre site et que le développeur peut les lire, l’application n’y met jamais de contenu de clients.
Ce qu’une ligne de journal peut contenir
| Type | Exemples |
|---|---|
| Identifiants | L’identifiant d’une analyse, le nom d’une tâche et sa file, le numéro d’un flux, les identifiants Jira d’objets lus par une vérification, un numéro de version. |
| Nombres et tentatives | Combien de flux une analyse a stockés, combien d’objets une vérification a lus, modifiés ou n’a pas pu lire, combien de tentatives une reprise a faites. |
| Statuts et raisons | Le statut HTTP d’un appel à Jira; la raison et l’attente d’une réponse « trop de requêtes »; pour une erreur, seulement son genre, son code, son statut et l’endroit où elle a été levée (les premiers cadres de la pile). |
| Les noms propres à l’application | Le nom d’un résolveur, d’une tâche ou d’une vérification, le nom d’une file, l’identifiant d’une tâche de maintenance. Ce sont des noms tirés du code et du manifeste de l’application. |
| La limite de débit de Jira | Au plus une fois par minute et par instance, ce que Jira dit qu’il reste de la limite de rafale par seconde de l’application, sous forme de nombres et d’une heure UTC. |
| Temps de base de données | Une fois par minute et par instance, un résumé des instructions de base de données : combien, combien de temps, selon les noms d’appels propres à l’application et selon la forme de l’instruction (ses premiers mots, jamais ses valeurs). |
| Exécutions de maintenance et de signalement | Les identifiants des tâches exécutées et le nombre d’enregistrements que chacune a retirés; le nombre d’identifiants de comptes signalés à Atlassian et de comptes fermés effacés. |
Ce que les journaux ne contiennent jamais
- Les noms de flux, de champs, de filtres, d’espaces, d’étiquettes, de personnes ou de groupes.
- Le texte des réglages d’un flux : JQL, adresses Web, en-têtes, adresses courriel, valeurs intelligentes, valeurs comparées, commentaires ou secrets.
- Les résumés, descriptions, commentaires ou valeurs de champs des tickets.
- Les adresses courriel.
- Les mots d’un message d’erreur. Les réponses de Jira, le texte d’une requête et les mots propres d’une valeur se retrouvent dans les messages d’erreur : l’application ne journalise donc que le genre, le code et le statut de l’erreur et l’endroit où elle a été levée. La réponse de Jira à un appel qui échoue est gardée en mémoire pour le code et n’est jamais journalisée.
- Les valeurs qu’une personne a saisies ou choisies dans une page, et les valeurs d’une instruction de base de données.
- Les identifiants, jetons ou la clé de l’analyse automatique. L’application ne garde ni mot de passe ni jeton d’API, et seulement une empreinte à sens unique du secret de la clé. Aucune clé, aucun secret ni aucun jeton n’est jamais écrit dans un journal.
Comment c’est appliqué
- Chaque ligne de journal passe par une seule fonction de l’application. Elle écrit ce qui a échoué avec des identifiants, des nombres et des statuts et, pour une erreur, seulement son genre, son code, son statut et les cadres de la pile.
- Un test automatisé fait échouer la compilation si du code journalise d’une autre façon, ou si une ligne de journal montre autre chose que les identifiants, les nombres et les noms qu’il permet. Le test couvre tout le code serveur de l’application.
- Un nom n’est ajouté à la liste permise qu’une fois qu’on sait qu’il ne contiendra jamais de contenu de clients.
Conservation
Atlassian fixe la durée pendant laquelle Forge garde les journaux des applications. Durée de conservation : 30 jours. La documentation d’Atlassian pour les développeurs d’applications dit : « Les journaux ne sont disponibles que pour les 30 derniers jours » (traduction libre). Plugincraft ne copie les journaux dans aucun autre système et ne les lit que pour trouver et corriger des problèmes. Un administrateur de site peut en tout temps retirer au développeur l’accès aux journaux de son site.
Le paquet de soutien
Le paquet de soutien n’est pas un journal. Un administrateur Jira le construit dans les paramètres de l’application pour l’envoyer au soutien. Il contient la version de l’application, l’état de la licence, le nombre de migrations et la taille des tables de la base de données, les dernières exécutions de maintenance et de signalement des données personnelles (des nombres), ainsi que les états et les points des vérifications en arrière-plan. Il ne contient ni identifiants de comptes, ni noms de flux, ni identifiants de projets, ni valeurs saisies par des personnes, ni noms de sites, ni adresses courriel. L’administrateur peut voir tout le fichier avant de l’envoyer et décide de l’envoyer ou non : l’application n’envoie rien d’elle-même. Les courriels de soutien sont conservés comme le décrit la politique de confidentialité de ce site Web.