Google 致力于为黑人社区推动种族平等。查看具体举措

Отправляйте сообщения с помощью консоли Firebase

Вы можете отправлять сообщения извещения с применением Уведомления композитора в консоли Firebase. Хотя это не обеспечивает такую же гибкость и масштабируемость , как отправка сообщений с Admin SDK или HTTP и XMPP протоколов , это может быть очень полезно для тестирования или для очень целевого маркетинга и взаимодействия с пользователем. Firebase консоль предоставляет аналитику на основе A / B тестирование для уточнения условий и улучшения маркетинговых сообщений.

После разработки логики в вашем приложении , чтобы получать сообщения, вы можете разрешить нетехнических пользователей для отправки сообщений в соответствии с инструкциями в Notifications странице в Firebase справочном центре.

О

При отправке сообщения уведомления от композитора Notifications , Google использует значения, вводимые в поля формы в этих способов:

  • Поля , как сегмент пользователей и Истекает определить целевые сообщения и варианты доставки.
  • Поля , такие как текст уведомления и данные пользовательских отправляются клиенту в полезной нагрузке , состоящей из пар ключ / значение.

Эти поля сопоставляются с ключами, доступными через протоколы сервера FCM. Например, ключ / значение пара , введенная в данных пользовательском обрабатываются как полезная нагрузка данных для уведомления. Другие поля отображаются непосредственно к ключам в FCM полезной нагрузки уведомления .

Обратите внимание , что некоторые поля композитора Notifications не доступны через протоколы FCM сервера. Например, вы можете настроить таргетинг на сегменты пользователей , основанные на версию приложения, языке, тип и версию браузера, или пользовательские свойства способов, которые не доступны с использованием to поле сервера API.

Ключи, которые консоль Firebase отправляет клиентам:

Ключ Метка поля консоли Описание
notification.title Название уведомления Указывает заголовок уведомления.
notification.body Текст уведомления Обозначает основной текст уведомления.
data Пользовательские данные Пары ключ / значение, которые вы определяете. Они доставляются как полезные данные для обработки приложением.

Ключи, определяющие доставку сообщения, включают:

Ключ Метка поля консоли Описание
sound Звук

Указывает звук, который будет воспроизводиться, когда устройство получит уведомление.

time_to_live Истекает

Этот параметр указывает, как долго (в секундах) сообщение должно храниться в хранилище FCM, если устройство отключено. Для получения дополнительной информации см Установка срока службы сообщения .

Журналы аудита

Эта страница описывает аудиторские журналы , созданные Firebase в рамках Виртуального аудита журналов .

Обзор

Службы Firebase создают журналы аудита, чтобы помочь вам ответить на вопросы: «Кто что сделал, где и когда?» Это облако аудит Журналы, при условии , в рамках проекта Google Cloud , подключенном к вашему проекту Firebase . Каждый из ваших проектов Firebase содержит только журналы аудита для ресурсов, которые находятся непосредственно в проекте.

Для общего обзора Облако аудита журналов, перейдите Облако аудита журналов . Для более глубокого понимания Облако аудита журналов, обзор Понимание журналов аудита .

Cloud Audit Logs ведет три журнала аудита для каждого проекта, папки и организации Google Cloud:

  • Журналы аудита активности администратора
  • Журналы аудита доступа к данным
  • Журналы аудита системных событий

Только если явно включен, Firebase Сообщение консоль пишет журналы аудита доступа к данным. Журналы аудита доступа к данным содержат вызовы API, которые считывают конфигурацию или метаданные ресурсов, а также управляемые пользователем вызовы API, которые создают, изменяют или читают предоставленные пользователем данные ресурсов. Журналы аудит доступ к данным не регистрируют операции доступа к данным о ресурсах, которые общедоступные (доступно для всех пользователей или все аутентифицированных пользователей) или которые могут быть доступны без регистрации в Google Cloud.

Firebase Сообщение консоль не пишет администратор журналов аудит деятельности.

Firebase Сообщения консоли не пишет журнал аудита событий системы.

Проверенные операции

Ниже приводится сводная информация о том, какие операции API соответствуют каждому типу журнала аудита в консоли уведомлений Firebase:

Категория журналов аудита Действия консоли уведомлений Firebase Имя типа (используется для поиска журналов в пользовательском интерфейсе)
Журналы доступа к данным (DATA_READ) Получите кампанию GetCampaign
Журналы доступа к данным (DATA_READ) Список кампаний ListCampaign
Журналы доступа к данным (DATA_READ) Получите информацию из уведомления об эксперименте ABT LegacyGetRollout
Журналы доступа к данным (DATA_READ) Получите возможности таргетинга GetAudiences
Журналы доступа к данным (DATA_READ) Получить статистику fcm (количество отправленных / открытых / доставленных / преобразованных) GetFcmStats
Журналы доступа к данным (DATA_READ) Получите список меток аналитики для диапазона дат и проекта. GetAnalyticsLabelList
Журналы доступа к данным (DATA_WRITE) Создать кампанию CreateCampaign
Журналы доступа к данным (DATA_WRITE) Удалить кампанию DeleteCampaign
Журналы доступа к данным (DATA_WRITE) Обновить кампанию UpdateCampaign
Журналы доступа к данным (DATA_WRITE) Создать развертывание из ABT LegacyCreateRollout

Формат журнала аудита

Записи журнала аудита, которые можно просмотреть в Stackdriver Logging с помощью средства просмотра журналов, Stackdriver Logging API или Cloud SDK, включают следующие объекты:

  • Запись журнала сам, который является объектом типа LogEntry . К полезным полям относятся следующие:

    • logName содержит идентификационный проект и журнал аудита типа
    • resource содержит цель проверяемом операции
    • timeStamp содержит время проверяемой операции
    • protoPayload содержит проверенную информацию
  • Ведение журнала аудита данных, который является AuditLog объект удерживается в protoPayload поле записи журнала.

  • Необязательная информация аудит конкретной службы, которая является объектом конкретной службы провел в serviceData поле AuditLog объекта. Для получения дополнительной информации, перейдите в Сервис-конкретные данные аудита .

Для других полей в этих объектах, плюс , как интерпретировать их, обзорные журналы Понимание аудита .

Имя журнала

Имена ресурсов Cloud Audit Logs указывают на проект или другую сущность, владеющую журналами аудита, а также на то, содержит ли журнал данные журнала аудита действий администратора, доступа к данным или системных событий. Например, ниже показаны имена журналов для журналов аудита действий администратора проекта и журналов аудита доступа к данным организации:

projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity
organizations/[ORGANIZATION_ID]/logs/cloudaudit.googleapis.com%2Fdata_access

Наименование услуги

Журналы аудита Firebase уведомления консоли использовать имя службы gcmcontextualcampaign-pa.googleapis.com .

Для получения более подробной информации о лесозаготовительных услугах, перейти к услугам Mapping к ресурсам .

Типы ресурсов

Журналы аудита Firebase Уведомления Консольные использовать тип ресурса audited_resource для всех журналов аудита.

Для получения полного списка, перейдите отслеживаемые типы ресурсов .

Включить ведение журнала аудита

Журналы аудита доступа к данным отключены по умолчанию и не записываются, если явно не включены (исключением являются журналы аудита доступа к данным для BigQuery, которые нельзя отключить).

Инструкции по включению некоторых или всех ваших журналов аудита доступа к данным, перейдите к Настройка журналов доступа к данным .

Включенные вами журналы аудита доступа к данным могут повлиять на стоимость ваших журналов в Stackdriver. Просмотрите Цены раздел на этой странице.

Консоль уведомлений Firebase не записывает журналы аудита активности администратора.

Разрешения журнала аудита

Разрешения и роли Cloud Identity и Access Management определяют, какие журналы аудита вы можете просматривать или экспортировать. Журналы находятся в проектах и ​​некоторых других объектах, включая организации, папки и платежные аккаунты. Для получения дополнительной информации, перейдите Понимание ролей .

Для просмотра журналов аудита доступа к данным у вас должна быть одна из следующих ролей в проекте, который содержит ваши журналы аудита:

Если вы используете журналы аудита от лица-проекта, например, организации, а затем изменить роли проекта в соответствующих организационных ролей.

Просмотр журналов

У вас есть несколько вариантов просмотра записей журнала аудита:

Базовый просмотрщик

Вы можете использовать базовый интерфейс средства просмотра журналов в консоли GCP для получения записей журнала аудита. Сделайте следующее:

  1. Перейти к лесозаготовительной Stackdriver> Журналы (Журналы просмотра) страница в GCP консоли:

    Перейдите на страницу просмотра журналов.

  2. Выберите существующий проект Google Cloud вверху страницы или создайте новый проект.

  3. В первом раскрывающемся меню выберите тип ресурса, журналы аудита которого вы хотите просмотреть. Вы можете выбрать определенный ресурс или Global для всех ресурсов.

  4. Во втором раскрывающемся меню выберите тип журнала , который вы хотите зрение: activity для журналов действий администратора аудита, data_access для журналов аудита доступа к данным, а также system_events для журналов аудита системных событий.

    Если ни один из этих параметров не отображается, значит, в проекте нет журналов аудита этого типа.

Расширенный просмотрщик

Вы можете использовать расширенный интерфейс средства просмотра журналов в консоли GCP для получения записей журнала аудита. Сделайте следующее:

  1. Перейти к лесозаготовительной Stackdriver> Журналы (Журналы просмотра) страница в GCP консоли:

    Перейдите на страницу просмотра журналов.

  2. Выберите существующий проект Google Cloud вверху страницы или создайте новый проект.

  3. В первом раскрывающемся меню выберите тип ресурса, журналы аудита которого вы хотите просмотреть. Вы можете выбрать определенный ресурс или Global для всех ресурсов.

  4. Нажмите на стрелку раскрывающегося списка (▾) в правой части окна поиска фильтра и выберите Преобразовать в расширенный фильтр.

  5. Создайте фильтр, который дополнительно определяет записи журнала, которые вы хотите просмотреть. Чтобы получить все журналы аудита в вашем проекте, добавьте следующий фильтр. Поставка действительный [PROJECT_ID] в каждом из названий журналов.

      logName = ("projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity" OR
          OR "projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events"
          OR "projects/[PROJECT_ID]logs/cloudaudit.googleapis.com%2Fdata_access")
    

    Для получения более подробной информации о фильтрах перейти к Advanced регистрирует фильтры .

API

Чтобы просмотреть записи журнала аудита с помощью Stackdriver Logging API:

  1. Перейти к Try этот API раздел в документации для entries.list метода.

  2. Поместите следующее в части запроса тела Try этот API формы. При нажатии на этой заполняемой форме автоматически заполняет тело запроса, но вам нужно будет предоставить действительный [PROJECT_ID] в каждом из названий журналов.

      {
        "resourceNames": [
          "projects/[PROJECT_ID]"
        ],
        "pageSize": 5,
        "filter": "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"
      }
    
  3. Нажмите Выполнить.

Для получения более подробной информации о запросах, перейдите к Advanced журналов запросов .

SDK

Чтобы прочитать записи журнала с помощью Cloud SDK, выполните следующую команду. Поставка действительный [PROJECT_ID] в каждом из названий журналов.

gcloud logging read "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"

Перейти к записи журнала для чтения для получения дополнительной информации об использовании облачной SDK.

Для образца записи журнала аудита и как найти наиболее важную информацию в нем, перейдите на журналы Понимание аудита .

Экспорт журналов аудита

Вы можете экспортировать журналы аудита так же, как и другие типы журналов. Более подробную информацию о том , как экспортировать журналы, перейдите на экспорт журналов . Вот некоторые применения экспорта журналов аудита:

  • Чтобы хранить журналы аудита в течение более длительного периода времени или использовать более мощные возможности поиска, вы можете экспортировать копии журналов аудита в Google Cloud Storage, BigQuery или Google Cloud Pub / Sub. Используя Cloud Pub / Sub, вы можете экспортировать в другие приложения, другие репозитории и третьим лицам.

  • Для управления журналами аудита по всей организации, вы можете создать сводной экспорт поглотители , которые могут экспортировать журналы из любых или всех проектов в организациях.

  • Если ваши включенные журналы аудита доступа к данным подталкивают ваши проекты к выделению их журналов, вы можете экспортировать и исключить журналы аудита доступа к данным из ведения журнала. Для получения дополнительной информации, перейдите на журналы исключите .

Ценообразование

Stackdriver Logging взимает плату за явно запрашиваемые вами журналы аудита доступа к данным. Консоль уведомлений Firebase не записывает журналы аудита активности администратора или журналы аудита системных событий.

Для получения дополнительной информации о журналах аудита цен, обзор Stackdriver ценообразования .