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-формат.

См. также

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