L'extension Delete User Data (delete-user-data) vous permet de supprimer les données d'un utilisateur lorsque celui-ci est supprimé de votre projet Firebase. Vous pouvez configurer cette extension pour supprimer les données utilisateur de l'un ou de l'ensemble des services suivants : Cloud Firestore, Realtime Database ou Cloud Storage. Chaque déclencheur de l'extension pour supprimer des données est associé à l'UserId de l'utilisateur.
Cette extension est utile pour respecter la confidentialité des utilisateurs et répondre aux exigences de conformité. Toutefois, l'utilisation de cette extension ne garantit pas la conformité avec les réglementations gouvernementales et du secteur.
Prérequis
Vous devez utiliser Firebase Authentication pour gérer vos utilisateurs.
Cette extension ne supprime que les données de Cloud Firestore, de Realtime Database et de Cloud Storage. Si vous stockez des données utilisateur ailleurs, vous devez également les supprimer de ces sources lorsque vous supprimez des utilisateurs.
Installer l'extension
Pour installer l'extension, suivez les étapes de la page Installer l'extension Firebase. En résumé, effectuez l'une des opérations suivantes :
Console Firebase : cliquez sur le bouton suivant :
CLI : exécutez la commande suivante :
firebase ext:install firebase/delete-user-data --project=projectId-or-alias
Lors de l'installation de l'extension, vous serez invité à spécifier un certain nombre de paramètres de configuration :
Emplacement de Cloud Functions :
Sélectionnez l'emplacement où vous souhaitez déployer les fonctions créées pour cette extension. En général, vous devez choisir un emplacement proche de votre base de données. Pour obtenir de l'aide sur la sélection d'un emplacement, consultez le guide de sélection d'un emplacement.
Chemins Cloud Firestore :
Quels chemins d'accès de votre instance Cloud Firestore contiennent des données utilisateur ? Laissez ce champ vide si vous n'utilisez pas Cloud Firestore. Saisissez les chemins d'accès complets, séparés par une virgule. Vous pouvez représenter l'ID utilisateur de l'utilisateur supprimé par
{UID}. Par exemple, si vous disposez des collectionsusersetadmins, et que chaque collection contient des documents dont l'ID utilisateur correspond à l'ID du document, vous pouvez saisirusers/{UID},admins/{UID}.Mode de suppression Cloud Firestore :
(ne s'applique que si vous utilisez le paramètre
Cloud Firestore paths) ? Comment souhaitez-vous supprimer les documents Cloud Firestore ? Pour supprimer également les documents des sous-collections, définissez ce paramètre surrecursive.Instance Realtime Database :
De quelle instance Realtime Database souhaitez-vous supprimer les données utilisateur ?
Emplacement de Realtime Database :
(Uniquement applicable si vous avez fourni le paramètre
Realtime Database instance.) De quel emplacement Realtime Database souhaitez-vous supprimer les données utilisateur ?Chemins Realtime Database :
Quels chemins d'accès de votre instance Realtime Database contiennent des données utilisateur ? Laissez ce champ vide si vous n'utilisez pas Realtime Database. Saisissez les chemins d'accès complets, séparés par une virgule. Vous pouvez représenter l'ID utilisateur de l'utilisateur supprimé par
{UID}. Exemple :users/{UID},admins/{UID}.Chemins d'accès Cloud Storage :
Où stockez-vous les données utilisateur dans Google Cloud Storage ? Laissez ce champ vide si vous n'utilisez pas Cloud Storage. Saisissez les chemins d'accès complets aux fichiers ou répertoires de vos buckets Storage, séparés par une virgule. Utilisez
{UID}pour représenter l'ID utilisateur de l'utilisateur supprimé et{DEFAULT}pour représenter votre bucket Storage par défaut.Voici une série d'exemples :
- Pour supprimer tous les fichiers de votre bucket par défaut dont le nom respecte le schéma
{UID}-pic.png, saisissez{DEFAULT}/{UID}-pic.png. - Pour supprimer également tous les fichiers d'un autre bucket nommé
my-app-logsavec le schéma de dénomination de fichier{UID}-logs.txt, saisissez{DEFAULT}/{UID}-pic.png,my-app-logs/{UID}-logs.txt. - Pour supprimer également un répertoire portant un ID utilisateur et tous ses fichiers (comme
media/{UID}), saisissez{DEFAULT}/{UID}-pic.png,my-app-logs/{UID}-logs.txt,{DEFAULT}/media/{UID}.
- Pour supprimer tous les fichiers de votre bucket par défaut dont le nom respecte le schéma
Découvrir les données à supprimer
Cette extension utilise plusieurs mécanismes pour identifier les données à supprimer. Ces mécanismes doivent être explicitement configurés pour que l'extension supprime des données. L'extension ne supprimera que les données explicitement configurées pour être supprimées en fonction des mécanismes fournis.
Tenez compte des différences de comportement suivantes entre chaque service :
- Cloud Firestore : le comportement par défaut consiste à supprimer superficiellement un document (les sous-collections ne seront pas supprimées). Pour supprimer de manière récursive toutes les sous-collections d'un document, définissez l'option "Mode de suppression Cloud Firestore" sur "Récursif".
- Realtime Database : toutes les données du nœud spécifié seront supprimées.
- Stockage : si un chemin d'accès au répertoire est spécifié, tous les fichiers et sous-répertoires seront supprimés.
Par chemin d'accès
Lorsque vous configurez les chemins d'accès Cloud Firestore, Realtime Database et Cloud Storage, vous pouvez définir une variable UID dans les chemins d'accès, qui sera remplacée par l'UID de l'utilisateur authentifié. Lorsqu'un utilisateur est supprimé, l'extension supprime toutes les données associées à cet UID aux chemins d'accès indiqués, par exemple :
- Chemin(s) Cloud Firestore :
users/{UID},admins/{UID} - Chemin(s) Realtime Database :
likes/{UID} - Chemin(s) Cloud Storage :
{DEFAULT}/uploads/{UID},{DEFAULT}/avatars/{UID}.jpeg
Découverte automatique (Cloud Firestore)
Pour permettre à l'extension de détecter automatiquement les documents Firestore à supprimer, définissez le paramètre de configuration "Activer la détection automatique" sur "Oui".
La découverte automatique parcourt automatiquement la base de données pour trouver les collections et les documents qui doivent être supprimés en fonction de votre configuration. L'extension identifie ces collections et documents à l'aide de la méthodologie suivante :
- Tout d'abord, l'extension recherche toutes les collections racine dans la base de données. Si l'ID d'une collection correspond à l'UID de l'utilisateur, l'intégralité de la collection est supprimée (la suppression est récursive ou superficielle, selon la configuration de l'extension pour le "mode de suppression Cloud Firestore").
- Ensuite, si l'ID de collection ne correspond pas, l'extension tentera d'identifier et de supprimer un document si son ID correspond à l'UID de l'utilisateur.
- Enfin, pour chaque document : a. Si l'étendue de la recherche actuelle (voir ci-dessous) est inférieure ou égale à l'étendue de la recherche configurée, le processus sera répété pour toutes les sous-collections du document actuel. b. Si des champs de recherche ont été configurés, l'extension vérifie si les champs fournis correspondent à l'UID de l'utilisateur. Si une correspondance est trouvée, le document sera supprimé.
Étendue de la recherche
L'extension propose une valeur d'étendue de la recherche configurable (par défaut, 3). Le parcours ne sera exécuté que si la profondeur de recherche actuelle est inférieure ou égale à la profondeur de recherche configurée. L'étendue de la recherche actuelle est basée sur la profondeur de la collection actuelle ou de la collection parente des documents, par exemple :
/users = 1
/users/<document-id> = 1
/users/<document-id>/comments = 2
/users/<document-id>/comments/<document-id> = 2
Cette extension ne supprimera PAS automatiquement les UID stockés dans des tableaux ou des cartes, et elle ne recherchera pas les données indexées par ID utilisateur stockées dans des sous-collections profondément imbriquées au-delà de la profondeur spécifiée ci-dessus.