Privacy Manifest for Capacitor Apps: Guide

Manifeste de confidentialité pour les applications __CAPGO_KEEP_0__ : Guide Capacitor __CAPGO_KEEP_0__ App Store sans retard? Start by creating a Privacy Manifest. Apple now requires developers to include this document to ensure apps meet strict privacy standards. Here’s what you need to know:

Qu'est-ce qu'un manifeste de confidentialité ?
A fichier structuré décrivant les pratiques de collecte de données de votre application, API utilisation et les domaines de suivi.
Pourquoi cela compte :
- Complète les règles de l'App Store pour éviter les rejets ou la suppression.
- Construit la confiance en étant transparent sur la gestion des données utilisateur.
Composants clés à inclure :
- APIs accédant aux données utilisateur (par exemple, localisation, photos).
- Privacy labels for collected data types.
- Domaines de suivi utilisés pour les analyses ou les publicités.
Comment créer un :
- Utilisez JSON pour définir les détails de collecte de données.
- Placez le PrivacyInfo.xcprivacy fichier dans le répertoire correct de votre projet.
- Vérifiez-l’avec des outils comme Xcode pour éviter les erreurs.
Les outils pour simplifier le processus :
Utilisez des plateformes comme Capgo pour la validation automatique du manifeste de confidentialité, les mises à jour en temps réel et le suivi des erreurs. Lorsque votre manifeste déclare des SDK de suivi ou d'analytique, @capgo/capacitor-transparence-sur-la-suivi-des-applications gère les invitations iOS ATT @capgo/capacitor-analytics-Firebase documents de collecte de données Firebase pour examen de l'App Store.

documente la collecte de données Firebase pour la revue de l'App Store.

Bases de la Déclaration de Confidentialité

Définition de la Déclaration de Confidentialité

Une déclaration de confidentialité est un fichier structuré qui décrit les pratiques de données de votre application. Elle détaille des éléments comme les API accédant aux données des utilisateurs, les domaines de suivi, les types de données collectés et les intégrations tierces SDK. Ce document n'a pas seulement pour but d'établir la confiance mais aussi d'assurer le respect des lignes directrices de l'App Store. Commençons à décomposer les composants clés que votre manifeste doit inclure.

Éléments Principaux de la Déclaration de Confidentialité

Voici les éléments principaux à inclure dans votre déclaration de confidentialité pour vous aligner sur les exigences d'Apple :

APIs de Raisonnement Obligatoires
Cette section liste les API sensibles à la confidentialité que votre application utilise et explique pourquoi elles sont nécessaires.

Voici ci-dessous une table résumant les exigences API courantes :

API Catégorie	Utilisation Courante	Documentation Requise
Services de Localisation	Navigation de l'utilisateur	La description de l'utilisation et la finalité.
Bibliothèque de photos	Photos de profil	Niveau d'accès et intention
Contacts	Synchronisation du carnet d'adresses	Déclaration de minimisation des données

Étiquettes de confidentialité
Ces étiquettes fournissent une transparence en spécifiant :
- Types de données collectées
- Raisons de la collecte de données
- Quelle donnée est liée à l'identité de l'utilisateur
- Comment les données sont utilisées pour le suivi
Domaines de suivi
Cette section liste tous les domaines impliqués dans le suivi, comme ceux utilisés pour les analyses, les publicités ou le traitement de données tiers.

“Conforme à l'App Store” - Capgo [1]

Selon Capgo, 95% des utilisateurs s'acquittent de leurs mises à jour dans les 24 heures. Avec plus de 23,5 millions de mises à jour délivrées [1]Maintenez votre documentation de confidentialité à jour pour conserver la confiance des utilisateurs.

Construire des déclarations de confidentialité pour Capacitor

Documentation du site Web du Framework Capacitor

Exigences de configuration

Avant de commencer à construire le manifeste, assurez-vous d'avoir :

Xcode 15 ou une version ultérieure installée
Un projet Capacitor 8.0+ configuré
Accès à votre application's Info.plist fichier
Une compréhension de base de la structure JSON
Guide de la collecte de données de votre application

Étapes de création

Commencez par créer un PrivacyInfo.xcprivacy le fichier dans votre dossier de projet iOS. Ce fichier doit suivre des directives de formatage spécifiques.

Configuration des informations de base

{
    "NSPrivacyTracking": false,
    "NSPrivacyTrackingDomains": [],
    "NSPrivacyCollectedDataTypes": []
}

Définition des détails de collecte de données

{
    "NSPrivacyAccessedAPITypes": [
        {
            "NSPrivacyAccessedAPIType": "NSLocationWhenInUseUsageDescription",
            "NSPrivacyAccessedAPITypeReasons": ["1.1"]
        },
        {
            "NSPrivacyAccessedAPIType": "NSCameraUsageDescription",
            "NSPrivacyAccessedAPITypeReasons": ["2.1"]
        }
    ]
}

Ajout de domaines de suivi

{
    "NSPrivacyTrackingDomains": [
        "analytics.yourdomain.com",
        "metrics.yourdomain.com"
    ]
}

Évitement des erreurs courantes

Pour prévenir les problèmes, gardez ces conseils à l'esprit :

Inclure tous les champs requis: Même si certains champs sont vides, ils doivent être présents.
Utiliser des types API valides: Vérifiez les identifiants API avec la documentation officielle d'Apple.
Vérifier la mise en forme JSON: Exécutez votre fichier à l'aide d'un linter JSON pour détecter les erreurs de syntaxe.
Fournir des raisons complètes: Assurez-vous que chaque accès API inclut une raison correspondante code.
Tenir les informations à jour: Update the manifest whenever new features are added.

De plus, assurez-vous que le fichier de manifeste reste inférieur à 512 Ko pour éviter les erreurs de construction. Validez régulièrement le fichier pendant le processus de construction de Xcode pour détecter les erreurs tôt. Une fois votre manifeste prêt, intégrez-l’à votre projet Capacitor en suivant les directives de placement de fichiers.

Intégrer les manifestes de confidentialité à Capacitor

Guide de placement de fichiers

Pour inclure un manifeste de confidentialité dans votre projet Capacitor, placez le PrivacyInfo.xcprivacy fichier dans la structure de répertoire suivante :

your-app/
├── ios/
│   ├── App/
│   │   ├── PrivacyInfo.xcprivacy
│   │   └── Info.plist
│   └── App.xcworkspace

Pour les plugins Capacitor, utilisez cette structure :

your-plugin/
├── ios/
│   ├── Plugin/
│   │   └── PrivacyInfo.xcprivacy
│   └── Plugin.xcodeproj

Paramètres de configuration de la construction

Une fois le fichier en place, mettez à jour vos paramètres de compilation Xcode pour s'assurer qu'il s'intègre correctement.

Ouvrez votre projet dans Xcode.
Sous OBJECTIFS, select your app or plugin target.
Allez à la Paramètres de construction section.
Configurez Privacy Manifest Development Region to en.
Configurez Inclure le manifeste de confidentialité to YES.

Si votre projet utilise CocoaPods, incluez le suivant dans votre Podfile pour activer le manifeste de confidentialité :

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['INCLUDE_PRIVACY_MANIFEST'] = 'YES'
    end
  end
end

Après avoir effectué ces modifications, procédez aux vérifications d'implémentation pour vous assurer que tout est correctement configuré.

Vérification d'implémentation

Pour vous assurer que le manifeste de confidentialité fonctionne comme prévu, suivez ces étapes :

Vérification de la construction
- Confirmez qu'il n'y a pas d'avertissements liés à la confidentialité pendant la construction.
- Assurez-vous que le manifeste compile sans problème.
- Vérifiez que le manifeste de confidentialité est inclus dans les produits de construction.
Validation en temps de exécution
- En mode debug, testez les invites de confidentialité et le comportement d'accès API.
Validation d'App Store Connect
- Envoyez votre build et consultez le Rapport de confidentialité dans App Store Connect.
- Vérifiez que les déclarations API sont complètes et que les formats de domaine de suivi sont corrects.

Si vous rencontrez une erreur « Validation de manifeste de confidentialité échouée », vérifiez à nouveau votre manifeste pour vous assurer qu'il répond aux dernières exigences de l'App Store. Faites particulièrement attention aux types API et aux configurations de domaine de suivi.

Changements de manifeste de confidentialité d'Apple

Tests et corrections

Créer un manifeste de confidentialité qui répond aux lignes directrices d'Apple est crucial. Pour rester sur la bonne voie, intégrez un suivi d'erreurs fiable dans votre processus de développement. Cela aide à relier les efforts de développement aux exigences de conformité.

Un outil comme Capgo Peut vous aider. Il surveille l'accès API et identifie les problèmes de manifeste avant qu'ils n'affectent les utilisateurs. Une fois les problèmes potentiels signalés, vous pouvez vous concentrer sur une validation approfondie.

Après avoir effectué des mises à jour, testez votre manifeste dans un environnement de développement. Utilisez les informations provenant du suivi d'erreurs pour guider votre revue. Cette approche vous aide à vous assurer que votre application reste alignée avec les normes de confidentialité d'Apple.

Capgo Outils de confidentialité

Capgo Live Update Tableau de bord Interface

Capgo simplifie la gestion des manifestes de confidentialité et des mises à jour d'applications, garantissant que vos normes de confidentialité restent intactes sans retarder les déploiements.

Capgo Fonctionnalités

Avec plus de 23,5 millions de mises à jour sécurisées et un taux de réussite mondial de 82% , Capgo s'assure que 95% des utilisateurs actifs reçoivent des mises à jour dans les 24 heures [1]. Voici ce qu'il offre :

Chiffrement de bout en bout pour maintenir les mises à jour sécurisées
Système de canal pour la distribution d'actualisations contrôlées
Suivi des erreurs pour identifier et résoudre les problèmes rapidement
Annulation rapide pour revenir instantanément à une version précédente

Ces outils rendent l'ajout de Capgo à votre flux de travail fluide et efficace.

Using Capgo

Pour commencer, installez le plugin Capgo avec cette commande :

npx @capgo/cli init

Capgo s'intègre de manière fluide avec les pipelines CI/CD, automatisant la validation du manifeste de confidentialité à travers des plateformes comme GitHub Actions, GitLab CI, ou JenkinsQuoi que vous choisissiez entre options cloud ou auto-hébergées, Capgo soutient 750 applications en production tout en garantissant que chaque mise à jour respecte les normes de confidentialité.

“Nous pratiquons le développement agile et @Capgo est essentiel à la livraison continue à nos utilisateurs !” – Rodrigo Mantica

“Capgo est un moyen intelligent de faire des mises à jour chaudes code 🙂” – NASA’s OSIRIS-REx

Capgo comprend également des analyses intégrées pour surveiller les taux de réussite des mises à jour et l'engagement des utilisateurs en temps réel. Cela garantit que les mises à jour de confidentialité atteignent toute votre base d'utilisateurs tout en restant conforme aux directives d'Apple.

Conclusion

Principaux points clés

Lorsqu'il s'agit de gérer les manifestes de confidentialité, rester conforme et maintenir des mesures de sécurité solides est crucial. Voici ce qui compte le plus :

Chiffrement de bout en bout: Garantit les mises à jour sécurisées de bout en bout.
Surveillance en temps réel: Suivi efficace de la distribution des mises à jour.
Capacité de rebond instantané: Sert de filet de sécurité pour les corrections rapides.
Validation automatisée: Vérifiez que vos mises à jour répondent aux normes de conformité.

La mise en place d'un système de mise à jour fiable vous aide à suivre les évolutions des exigences de confidentialité d'Apple et de Google. Cette approche a été démontrée pour améliorer les taux d'approbation des magasins d'applications et renforcer la confiance des utilisateurs. [1].

Comment Commencer

Vous pouvez commencer à mettre en œuvre ces principes en suivant ces étapes :

Configurer votre environnement: Exécutez npx @capgo/cli init pour commencer.
Activer les fonctionnalités de confidentialitéUtilisez l'encryption à la fin à fin pour des mises à jour sécurisées.
Déployez des outils de suiviSuivez les mises à jour avec des analyses.
Planifiez des retours en arrière: Assurez-vous de pouvoir revenir rapidement à des versions antérieures si nécessaire.

“Capgo est un outil indispensable pour les développeurs qui souhaitent booster leur productivité. Éviter les retards de revue pour les correctifs de bogues est un changement de jeu.” - Bessie Cooper

Mises à jour régulières et outils appropriés sont essentiels pour rester conforme et améliorer au fil du temps.

Continuez de Privacy Manifest for Capacitor Apps: Guide

Si vous utilisez Privacy Manifest for Capacitor Apps: Guide pour planifier la sécurité et la conformité, connectez-l’avec Chiffrement pour le détail d'implémentation dans Chiffrement, Conformité pour le détail d'implémentation dans Conformité, Capgo Scanner de sécurité pour le flux de travail du produit dans Capgo Scanner de sécurité, Capgo Sécurité pour le flux de travail du produit dans Capgo Sécurité, et Capgo Centre de confiance pour le flux de travail du produit dans Capgo Centre de confiance.