Перейти к основному содержимому

SecurityEventList

Список событий безопасности в ящике.

message SecurityEventList {
repeated SecurityEvent Events = 1;
optional string LastIndexKey = 2;
}

message SecurityEvent {
required string EventId = 1;
required SecurityEventType EventType = 2;
required SecurityEventTarget Target = 3;
required sfixed64 TimestampTicks = 4;
required string Details = 5;
required string IndexKey = 6;
}

enum SecurityEventType {
UnknownEventType = 0;
MalwareDetected = 1;
}

message SecurityEventTarget {
required SecurityEventTargetType Type = 1;
optional DocumentTarget Document = 2;
}

enum SecurityEventTargetType {
UnknownTargetType = 0;
Document = 1;
}

message DocumentTarget {
required string LetterId = 1;
required string DocumentId = 2;
}
  • Events — список событий безопасности в ящике. Каждый элемент списка представлен структурой SecurityEvent с полями:
    • EventId — идентификатор события.
    • EventType — тип события, принимает значения из перечисления SecurityEventType:
      • UnknownEventType — неизвестное значение;
      • MalwareDetected — обнаружено вредоносное ПО.
    • Target — объект, на котором было обнаружено событие безопасности, представленный структурой SecurityEventTarget с полями:
      • Type — тип объекта, принимает значения из перечисления SecurityEventTargetType:
        • UnknownTargetType — неизвестное значение;
        • Document — документ.
      • Document — информация о документе, в котором обнаружено событие безопасности. Заполняется только в случае, если Type = Document. Представлена структурой DocumentTarget с полями:
        • LetterId — идентификатор сообщения;
        • DocumentId — идентификатор документа.
    • TimestampTicks — время создания события.
    • Details — дополнительная техническая информация о событии, например Comment: Malware link found.
    • IndexKey — ключ события.
  • LastIndexKey — ключ для постраничного получения списка найденных событий. Его можно передавать в качестве параметра afterIndexKey в метод GetSecurityEvents: ключ может содержать недопустимые символы, поэтому при вызове метода должен быть закодирован в URL-формат.

См. также

Структура используется:

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года