Расширение Delete User Data (delete-user-data) позволяет удалять данные пользователя, когда он удаляется из проекта Firebase. Вы можете настроить это расширение, чтобы удалять пользовательские данные из Cloud Firestore, Realtime Database и/или Cloud Storage. Каждый триггер расширения для удаления данных привязан к UserId пользователя.
Это расширение позволяет соблюдать конфиденциальность пользователей и нормативные требования. Однако использование этого расширения не гарантирует соблюдение государственных и отраслевых нормативных требований.
Требования
Для управления пользователями необходимо использовать Firebase Authentication.
Это расширение удаляет данные только из Cloud Firestore, Realtime Database и Cloud Storage. Если вы храните пользовательские данные в других местах, то при удалении пользователей вам также следует удалить их данные из этих источников.
Установите расширение
Чтобы установить расширение, следуйте инструкциям на странице Install Firebase Extension (Установка расширения Firebase). Выполните одно из следующих действий:
Консоль Firebase. Нажмите кнопку ниже.
CLI. Выполните следующую команду:
firebase ext:install firebase/delete-user-data --project=projectId-or-alias
Во время установки расширения вам будет предложено указать ряд параметров конфигурации:
Местоположение Cloud Functions:
Выберите местоположение, в котором вы хотите развернуть функции, созданные для этого расширения. Обычно выбирается местоположение, близкое к вашей базе данных. Если вам нужна помощь с выбором местоположения, ознакомьтесь с руководством по выбору местоположения.
Пути Cloud Firestore:
Какие пути в вашем экземпляре Cloud Firestore содержат пользовательские данные? Если вы не используете Cloud Firestore, оставьте поле пустым. Введите полные пути через запятую. Идентификатор удаленного пользователя можно представить как
{UID}. Например, если у вас есть коллекцииusersиadmins, и в каждой коллекции есть документы с идентификатором пользователя в качестве идентификатора документа, вы можете ввестиusers/{UID},admins/{UID}.Режим удаления Cloud Firestore:
(Только если вы используете параметр
Cloud Firestore paths.) Как вы хотите удалить документы Cloud Firestore? Чтобы также удалить документы в подколлекциях, задайте для этого параметра значениеrecursive.Экземпляр Realtime Database:
Из какого экземпляра Realtime Database вы хотите удалить пользовательские данные?
Местоположение Realtime Database:
(Только если вы указали параметр
Realtime Database instance.) Из какого местоположения Realtime Database вы хотите удалить пользовательские данные?Пути к Realtime Database:
Какие пути в вашем экземпляре Realtime Database содержат пользовательские данные? Если вы не используете Realtime Database, оставьте поле пустым. Введите полные пути через запятую. Идентификатор удаленного пользователя можно представить как
{UID}. Пример:users/{UID},admins/{UID}.Пути Cloud Storage:
Где в Google Cloud Storage хранятся данные пользователей? Если вы не используете Cloud Storage, оставьте это поле пустым. Введите полные пути к файлам или каталогам в сегментах хранилища через запятую. Используйте
{UID}, чтобы указать идентификатор удаленного пользователя, и{DEFAULT}, чтобы указать сегмент хранилища по умолчанию.Вот несколько примеров:
- Чтобы удалить все файлы в сегменте по умолчанию со схемой именования
{UID}-pic.png, введите{DEFAULT}/{UID}-pic.png. - Чтобы также удалить все файлы в другом сегменте с названием
my-app-logsи схемой именования файлов{UID}-logs.txt, введите{DEFAULT}/{UID}-pic.png,my-app-logs/{UID}-logs.txt. - Чтобы также удалить каталог с идентификатором пользователя и все его файлы (например,
media/{UID}), введите{DEFAULT}/{UID}-pic.png,my-app-logs/{UID}-logs.txt,{DEFAULT}/media/{UID}.
- Чтобы удалить все файлы в сегменте по умолчанию со схемой именования
Поиск данных для удаления
Это расширение использует несколько механизмов для поиска данных, которые нужно удалить. Чтобы расширение удаляло данные, эти механизмы должны быть явно настроены. Расширение будет удалять только те данные, которые явно настроены для удаления на основе предоставленных механизмов.
Обратите внимание на следующие различия в поведении между сервисами:
- Cloud Firestore: по умолчанию выполняется поверхностное удаление документа (подколлекции не удаляются). Чтобы рекурсивно удалить все подколлекции документа, установите для параметра "Cloud Firestore delete mode" (Режим удаления Cloud Firestore) значение "Recursive" (Рекурсивный).
- Realtime Database: все данные в указанном узле будут удалены.
- Хранилище. Если указан путь к каталогу, все файлы и подкаталоги будут удалены.
По пути
При настройке путей Cloud Firestore, Realtime Database и Cloud Storage можно определить переменную UID, которая будет заменена на UID аутентифицированного пользователя. Когда пользователь удаляется, расширение удаляет все данные, связанные с этим UID, по указанным путям, например:
- Пути Cloud Firestore:
users/{UID},admins/{UID} - Пути к Realtime Database:
likes/{UID} - Пути к Cloud Storage:
{DEFAULT}/uploads/{UID},{DEFAULT}/avatars/{UID}.jpeg
Автоматическое обнаружение (Cloud Firestore)
Чтобы расширение автоматически находило документы Firestore для удаления, установите для параметра конфигурации "Включить автоматическое обнаружение" значение "Да".
Автоматическое обнаружение работает путем автоматического обхода базы данных для поиска коллекций и документов, которые должны быть удалены в соответствии с вашей конфигурацией. Расширение идентифицирует эти коллекции и документы по следующей методике:
- Сначала расширение находит все корневые коллекции в базе данных. Если идентификатор коллекции совпадает с UID пользователя, удаляется вся коллекция (удаление может быть рекурсивным или поверхностным в зависимости от конфигурации расширения для режима удаления Cloud Firestore).
- Если идентификатор коллекции не совпадает, расширение попытается найти и удалить документ, идентификатор которого совпадает с UID пользователя.
- Наконец, для каждого документа: а. Если текущая глубина поиска (см. ниже) меньше или равна настроенной глубине поиска, процесс будет повторен для всех подколлекций текущего документа. б. Если строки поиска настроены, расширение проверит, соответствуют ли предоставленные поля уникальному идентификатору пользователя. Если совпадение будет найдено, документ будет удален.
Глубина поиска
В расширении можно настроить глубину поиска (по умолчанию – 3). Обход будет выполнен, только если текущая глубина поиска меньше или равна настроенной. Текущая глубина поиска зависит от глубины текущей коллекции или родительской коллекции документов, например:
/users = 1
/users/<document-id> = 1
/users/<document-id>/comments = 2
/users/<document-id>/comments/<document-id> = 2
Это расширение НЕ будет автоматически удалять идентификаторы пользователей, хранящиеся в массивах или картах, и не будет искать данные, связанные с идентификатором пользователя, хранящиеся в глубоко вложенных подколлекциях, глубина которых превышает указанную выше.