public final class UDM extends GeneratedMessage implements UDMOrBuilder
A Unified Data Model event.
Protobuf type google.backstory.UDM
Inherited Members
com.google.protobuf.GeneratedMessage.<ContainingT,T>newFileScopedGeneratedExtension(java.lang.Class<?>,com.google.protobuf.Message)
com.google.protobuf.GeneratedMessage.<ContainingT,T>newMessageScopedGeneratedExtension(com.google.protobuf.Message,int,java.lang.Class<?>,com.google.protobuf.Message)
com.google.protobuf.GeneratedMessage.<ListT>makeMutableCopy(ListT)
com.google.protobuf.GeneratedMessage.<ListT>makeMutableCopy(ListT,int)
com.google.protobuf.GeneratedMessage.<T>emptyList(java.lang.Class<T>)
com.google.protobuf.GeneratedMessage.<V>serializeBooleanMapTo(com.google.protobuf.CodedOutputStream,com.google.protobuf.MapField<java.lang.Boolean,V>,com.google.protobuf.MapEntry<java.lang.Boolean,V>,int)
com.google.protobuf.GeneratedMessage.<V>serializeIntegerMapTo(com.google.protobuf.CodedOutputStream,com.google.protobuf.MapField<java.lang.Integer,V>,com.google.protobuf.MapEntry<java.lang.Integer,V>,int)
com.google.protobuf.GeneratedMessage.<V>serializeLongMapTo(com.google.protobuf.CodedOutputStream,com.google.protobuf.MapField<java.lang.Long,V>,com.google.protobuf.MapEntry<java.lang.Long,V>,int)
com.google.protobuf.GeneratedMessage.<V>serializeStringMapTo(com.google.protobuf.CodedOutputStream,com.google.protobuf.MapField<java.lang.String,V>,com.google.protobuf.MapEntry<java.lang.String,V>,int)
com.google.protobuf.GeneratedMessage.canUseUnsafe()
com.google.protobuf.GeneratedMessage.emptyBooleanList()
com.google.protobuf.GeneratedMessage.emptyDoubleList()
com.google.protobuf.GeneratedMessage.emptyFloatList()
com.google.protobuf.GeneratedMessage.emptyIntList()
com.google.protobuf.GeneratedMessage.emptyLongList()
com.google.protobuf.GeneratedMessage.internalGetMapFieldReflection(int)
com.google.protobuf.GeneratedMessage.isStringEmpty(java.lang.Object)
com.google.protobuf.GeneratedMessage.mergeFromAndMakeImmutableInternal(com.google.protobuf.CodedInputStream,com.google.protobuf.ExtensionRegistryLite)
com.google.protobuf.GeneratedMessage.newInstance(com.google.protobuf.GeneratedMessage.UnusedPrivateParameter)
com.google.protobuf.GeneratedMessage.parseUnknownFieldProto3(com.google.protobuf.CodedInputStream,com.google.protobuf.UnknownFieldSet.Builder,com.google.protobuf.ExtensionRegistryLite,int)
Static Fields
ABOUT_FIELD_NUMBER
public static final int ABOUT_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
ADDITIONAL_FIELD_NUMBER
public static final int ADDITIONAL_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
EXTENSIONS_FIELD_NUMBER
public static final int EXTENSIONS_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
public static final int EXTRACTED_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
GROUPED_FIELD_NUMBER
public static final int GROUPED_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
INTERMEDIARY_FIELD_NUMBER
public static final int INTERMEDIARY_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
METADATA_FIELD_NUMBER
public static final int METADATA_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
NETWORK_FIELD_NUMBER
public static final int NETWORK_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
OBSERVER_FIELD_NUMBER
public static final int OBSERVER_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
PRINCIPAL_FIELD_NUMBER
public static final int PRINCIPAL_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
SECURITY_RESULT_FIELD_NUMBER
public static final int SECURITY_RESULT_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
SRC_FIELD_NUMBER
public static final int SRC_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
TARGET_FIELD_NUMBER
public static final int TARGET_FIELD_NUMBER
| Field Value |
| Type |
Description |
int |
|
Static Methods
getDefaultInstance()
public static UDM getDefaultInstance()
| Returns |
| Type |
Description |
UDM |
|
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
newBuilder()
public static UDM.Builder newBuilder()
newBuilder(UDM prototype)
public static UDM.Builder newBuilder(UDM prototype)
| Parameter |
| Name |
Description |
prototype |
UDM
|
parseDelimitedFrom(InputStream input)
public static UDM parseDelimitedFrom(InputStream input)
| Returns |
| Type |
Description |
UDM |
|
parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
public static UDM parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
| Returns |
| Type |
Description |
UDM |
|
parseFrom(byte[] data)
public static UDM parseFrom(byte[] data)
| Parameter |
| Name |
Description |
data |
byte[]
|
| Returns |
| Type |
Description |
UDM |
|
parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
public static UDM parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
| Returns |
| Type |
Description |
UDM |
|
parseFrom(ByteString data)
public static UDM parseFrom(ByteString data)
| Returns |
| Type |
Description |
UDM |
|
parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static UDM parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
| Returns |
| Type |
Description |
UDM |
|
parseFrom(CodedInputStream input)
public static UDM parseFrom(CodedInputStream input)
| Returns |
| Type |
Description |
UDM |
|
parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public static UDM parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
| Returns |
| Type |
Description |
UDM |
|
parseFrom(InputStream input)
public static UDM parseFrom(InputStream input)
| Returns |
| Type |
Description |
UDM |
|
parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
public static UDM parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
| Returns |
| Type |
Description |
UDM |
|
parseFrom(ByteBuffer data)
public static UDM parseFrom(ByteBuffer data)
| Returns |
| Type |
Description |
UDM |
|
parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
public static UDM parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
| Returns |
| Type |
Description |
UDM |
|
parser()
public static Parser<UDM> parser()
Methods
equals(Object obj)
public boolean equals(Object obj)
| Parameter |
| Name |
Description |
obj |
Object
|
Overrides
getAbout(int index)
public Noun getAbout(int index)
Represents entities referenced by the event that are not otherwise
described in principal, src, target, intermediary or observer. For example,
it could be used to track email file attachments, domains/URLs/IPs embedded
within an email body, and DLLs that are loaded during a PROCESS_LAUNCH
event.
repeated .google.backstory.Noun about = 8;
| Parameter |
| Name |
Description |
index |
int
|
| Returns |
| Type |
Description |
Noun |
|
getAboutCount()
public int getAboutCount()
Represents entities referenced by the event that are not otherwise
described in principal, src, target, intermediary or observer. For example,
it could be used to track email file attachments, domains/URLs/IPs embedded
within an email body, and DLLs that are loaded during a PROCESS_LAUNCH
event.
repeated .google.backstory.Noun about = 8;
| Returns |
| Type |
Description |
int |
|
getAboutList()
public List<Noun> getAboutList()
Represents entities referenced by the event that are not otherwise
described in principal, src, target, intermediary or observer. For example,
it could be used to track email file attachments, domains/URLs/IPs embedded
within an email body, and DLLs that are loaded during a PROCESS_LAUNCH
event.
repeated .google.backstory.Noun about = 8;
getAboutOrBuilder(int index)
public NounOrBuilder getAboutOrBuilder(int index)
Represents entities referenced by the event that are not otherwise
described in principal, src, target, intermediary or observer. For example,
it could be used to track email file attachments, domains/URLs/IPs embedded
within an email body, and DLLs that are loaded during a PROCESS_LAUNCH
event.
repeated .google.backstory.Noun about = 8;
| Parameter |
| Name |
Description |
index |
int
|
getAboutOrBuilderList()
public List<? extends NounOrBuilder> getAboutOrBuilderList()
Represents entities referenced by the event that are not otherwise
described in principal, src, target, intermediary or observer. For example,
it could be used to track email file attachments, domains/URLs/IPs embedded
within an email body, and DLLs that are loaded during a PROCESS_LAUNCH
event.
repeated .google.backstory.Noun about = 8;
| Returns |
| Type |
Description |
List<? extends com.google.backstory.NounOrBuilder> |
|
getAdditional()
public Struct getAdditional()
Any important vendor-specific event data that cannot be adequately
represented within the formal sections of the UDM model.
.google.protobuf.Struct additional = 2;
| Returns |
| Type |
Description |
Struct |
The additional.
|
getAdditionalOrBuilder()
public StructOrBuilder getAdditionalOrBuilder()
Any important vendor-specific event data that cannot be adequately
represented within the formal sections of the UDM model.
.google.protobuf.Struct additional = 2;
getDefaultInstanceForType()
public UDM getDefaultInstanceForType()
| Returns |
| Type |
Description |
UDM |
|
getExtensions()
public Extensions getExtensions()
All other first-class, event-specific metadata goes in this message.
Do not place protocol metadata in Extensions; put it in Network.
.google.backstory.Extensions extensions = 11;
| Returns |
| Type |
Description |
Extensions |
The extensions.
|
getExtensionsOrBuilder()
public ExtensionsOrBuilder getExtensionsOrBuilder()
All other first-class, event-specific metadata goes in this message.
Do not place protocol metadata in Extensions; put it in Network.
.google.backstory.Extensions extensions = 11;
public Struct getExtracted()
Flattened fields extracted from the log.
.google.protobuf.Struct extracted = 12;
| Returns |
| Type |
Description |
Struct |
The extracted.
|
public StructOrBuilder getExtractedOrBuilder()
Flattened fields extracted from the log.
.google.protobuf.Struct extracted = 12;
getGrouped()
public GroupedFields getGrouped()
Related UDM fields that are grouped together.
optional .google.backstory.GroupedFields grouped = 13;
getGroupedOrBuilder()
public GroupedFieldsOrBuilder getGroupedOrBuilder()
Related UDM fields that are grouped together.
optional .google.backstory.GroupedFields grouped = 13;
getIntermediary(int index)
public Noun getIntermediary(int index)
Represents details on one or more intermediate entities processing activity
described in the event. This includes device details about a proxy server
or SMTP relay server. If an active event (that has a principal and
possibly target) passes through any intermediaries, they're added here.
Intermediaries can impact the overall action, for example blocking or
modifying an ongoing request. A rule of thumb here is that 'principal',
'target', and description of the initial action should be the same
regardless of the intermediary or its action. A successful network
connection from A->B should look the same in principal/target/intermediary
as one blocked by firewall C: principal: A, target: B (intermediary: C).
repeated .google.backstory.Noun intermediary = 6;
| Parameter |
| Name |
Description |
index |
int
|
| Returns |
| Type |
Description |
Noun |
|
getIntermediaryCount()
public int getIntermediaryCount()
Represents details on one or more intermediate entities processing activity
described in the event. This includes device details about a proxy server
or SMTP relay server. If an active event (that has a principal and
possibly target) passes through any intermediaries, they're added here.
Intermediaries can impact the overall action, for example blocking or
modifying an ongoing request. A rule of thumb here is that 'principal',
'target', and description of the initial action should be the same
regardless of the intermediary or its action. A successful network
connection from A->B should look the same in principal/target/intermediary
as one blocked by firewall C: principal: A, target: B (intermediary: C).
repeated .google.backstory.Noun intermediary = 6;
| Returns |
| Type |
Description |
int |
|
getIntermediaryList()
public List<Noun> getIntermediaryList()
Represents details on one or more intermediate entities processing activity
described in the event. This includes device details about a proxy server
or SMTP relay server. If an active event (that has a principal and
possibly target) passes through any intermediaries, they're added here.
Intermediaries can impact the overall action, for example blocking or
modifying an ongoing request. A rule of thumb here is that 'principal',
'target', and description of the initial action should be the same
regardless of the intermediary or its action. A successful network
connection from A->B should look the same in principal/target/intermediary
as one blocked by firewall C: principal: A, target: B (intermediary: C).
repeated .google.backstory.Noun intermediary = 6;
getIntermediaryOrBuilder(int index)
public NounOrBuilder getIntermediaryOrBuilder(int index)
Represents details on one or more intermediate entities processing activity
described in the event. This includes device details about a proxy server
or SMTP relay server. If an active event (that has a principal and
possibly target) passes through any intermediaries, they're added here.
Intermediaries can impact the overall action, for example blocking or
modifying an ongoing request. A rule of thumb here is that 'principal',
'target', and description of the initial action should be the same
regardless of the intermediary or its action. A successful network
connection from A->B should look the same in principal/target/intermediary
as one blocked by firewall C: principal: A, target: B (intermediary: C).
repeated .google.backstory.Noun intermediary = 6;
| Parameter |
| Name |
Description |
index |
int
|
getIntermediaryOrBuilderList()
public List<? extends NounOrBuilder> getIntermediaryOrBuilderList()
Represents details on one or more intermediate entities processing activity
described in the event. This includes device details about a proxy server
or SMTP relay server. If an active event (that has a principal and
possibly target) passes through any intermediaries, they're added here.
Intermediaries can impact the overall action, for example blocking or
modifying an ongoing request. A rule of thumb here is that 'principal',
'target', and description of the initial action should be the same
regardless of the intermediary or its action. A successful network
connection from A->B should look the same in principal/target/intermediary
as one blocked by firewall C: principal: A, target: B (intermediary: C).
repeated .google.backstory.Noun intermediary = 6;
| Returns |
| Type |
Description |
List<? extends com.google.backstory.NounOrBuilder> |
|
getMetadata()
public Metadata getMetadata()
Event metadata such as timestamp, source product, etc.
.google.backstory.Metadata metadata = 1;
| Returns |
| Type |
Description |
Metadata |
The metadata.
|
getMetadataOrBuilder()
public MetadataOrBuilder getMetadataOrBuilder()
Event metadata such as timestamp, source product, etc.
.google.backstory.Metadata metadata = 1;
getNetwork()
public Network getNetwork()
All network details go here, including sub-messages with details on each
protocol (for example, DHCP, DNS, or HTTP).
.google.backstory.Network network = 10;
| Returns |
| Type |
Description |
Network |
The network.
|
getNetworkOrBuilder()
public NetworkOrBuilder getNetworkOrBuilder()
All network details go here, including sub-messages with details on each
protocol (for example, DHCP, DNS, or HTTP).
.google.backstory.Network network = 10;
getObserver()
public Noun getObserver()
Represents an observer entity (for example, a packet sniffer or
network-based vulnerability scanner), which is not a direct intermediary,
but which observes and reports on the event in question.
.google.backstory.Noun observer = 7;
| Returns |
| Type |
Description |
Noun |
The observer.
|
getObserverOrBuilder()
public NounOrBuilder getObserverOrBuilder()
Represents an observer entity (for example, a packet sniffer or
network-based vulnerability scanner), which is not a direct intermediary,
but which observes and reports on the event in question.
.google.backstory.Noun observer = 7;
getParserForType()
public Parser<UDM> getParserForType()
Overrides
getPrincipal()
public Noun getPrincipal()
Represents the acting entity that originates the activity
described in the event. The principal must include at least one machine
detail (hostname, MACs, IPs, port, product-specific identifiers like an
EDR asset ID) or user detail (for example, username), and optionally
include process details. It must NOT include any of the following fields:
email, files, registry keys or values.
.google.backstory.Noun principal = 3;
| Returns |
| Type |
Description |
Noun |
The principal.
|
getPrincipalOrBuilder()
public NounOrBuilder getPrincipalOrBuilder()
Represents the acting entity that originates the activity
described in the event. The principal must include at least one machine
detail (hostname, MACs, IPs, port, product-specific identifiers like an
EDR asset ID) or user detail (for example, username), and optionally
include process details. It must NOT include any of the following fields:
email, files, registry keys or values.
.google.backstory.Noun principal = 3;
getSecurityResult(int index)
public SecurityResult getSecurityResult(int index)
A list of security results.
repeated .google.backstory.SecurityResult security_result = 9;
| Parameter |
| Name |
Description |
index |
int
|
getSecurityResultCount()
public int getSecurityResultCount()
A list of security results.
repeated .google.backstory.SecurityResult security_result = 9;
| Returns |
| Type |
Description |
int |
|
getSecurityResultList()
public List<SecurityResult> getSecurityResultList()
A list of security results.
repeated .google.backstory.SecurityResult security_result = 9;
getSecurityResultOrBuilder(int index)
public SecurityResultOrBuilder getSecurityResultOrBuilder(int index)
A list of security results.
repeated .google.backstory.SecurityResult security_result = 9;
| Parameter |
| Name |
Description |
index |
int
|
getSecurityResultOrBuilderList()
public List<? extends SecurityResultOrBuilder> getSecurityResultOrBuilderList()
A list of security results.
repeated .google.backstory.SecurityResult security_result = 9;
| Returns |
| Type |
Description |
List<? extends com.google.backstory.SecurityResultOrBuilder> |
|
getSerializedSize()
public int getSerializedSize()
| Returns |
| Type |
Description |
int |
|
Overrides
getSrc()
Represents a source entity being acted upon by the participant along with
the device or process context for the source object (the machine where the
source object resides). For example, if user U copies file A on machine X
to file B on machine Y, both file A and machine X would be specified in the
src portion of the UDM event.
.google.backstory.Noun src = 4;
| Returns |
| Type |
Description |
Noun |
The src.
|
getSrcOrBuilder()
public NounOrBuilder getSrcOrBuilder()
Represents a source entity being acted upon by the participant along with
the device or process context for the source object (the machine where the
source object resides). For example, if user U copies file A on machine X
to file B on machine Y, both file A and machine X would be specified in the
src portion of the UDM event.
.google.backstory.Noun src = 4;
getTarget()
Represents a target entity being referenced by the event or an object on
the target entity. For example, in a firewall connection from device A to
device B, A is described as the principal and B is described as the target.
For a process injection by process C into target process D, process C is
described as the principal and process D is described as the target.
.google.backstory.Noun target = 5;
| Returns |
| Type |
Description |
Noun |
The target.
|
getTargetOrBuilder()
public NounOrBuilder getTargetOrBuilder()
Represents a target entity being referenced by the event or an object on
the target entity. For example, in a firewall connection from device A to
device B, A is described as the principal and B is described as the target.
For a process injection by process C into target process D, process C is
described as the principal and process D is described as the target.
.google.backstory.Noun target = 5;
hasAdditional()
public boolean hasAdditional()
Any important vendor-specific event data that cannot be adequately
represented within the formal sections of the UDM model.
.google.protobuf.Struct additional = 2;
| Returns |
| Type |
Description |
boolean |
Whether the additional field is set.
|
hasExtensions()
public boolean hasExtensions()
All other first-class, event-specific metadata goes in this message.
Do not place protocol metadata in Extensions; put it in Network.
.google.backstory.Extensions extensions = 11;
| Returns |
| Type |
Description |
boolean |
Whether the extensions field is set.
|
public boolean hasExtracted()
Flattened fields extracted from the log.
.google.protobuf.Struct extracted = 12;
| Returns |
| Type |
Description |
boolean |
Whether the extracted field is set.
|
hasGrouped()
public boolean hasGrouped()
Related UDM fields that are grouped together.
optional .google.backstory.GroupedFields grouped = 13;
| Returns |
| Type |
Description |
boolean |
Whether the grouped field is set.
|
hasMetadata()
public boolean hasMetadata()
Event metadata such as timestamp, source product, etc.
.google.backstory.Metadata metadata = 1;
| Returns |
| Type |
Description |
boolean |
Whether the metadata field is set.
|
hasNetwork()
public boolean hasNetwork()
All network details go here, including sub-messages with details on each
protocol (for example, DHCP, DNS, or HTTP).
.google.backstory.Network network = 10;
| Returns |
| Type |
Description |
boolean |
Whether the network field is set.
|
hasObserver()
public boolean hasObserver()
Represents an observer entity (for example, a packet sniffer or
network-based vulnerability scanner), which is not a direct intermediary,
but which observes and reports on the event in question.
.google.backstory.Noun observer = 7;
| Returns |
| Type |
Description |
boolean |
Whether the observer field is set.
|
hasPrincipal()
public boolean hasPrincipal()
Represents the acting entity that originates the activity
described in the event. The principal must include at least one machine
detail (hostname, MACs, IPs, port, product-specific identifiers like an
EDR asset ID) or user detail (for example, username), and optionally
include process details. It must NOT include any of the following fields:
email, files, registry keys or values.
.google.backstory.Noun principal = 3;
| Returns |
| Type |
Description |
boolean |
Whether the principal field is set.
|
hasSrc()
Represents a source entity being acted upon by the participant along with
the device or process context for the source object (the machine where the
source object resides). For example, if user U copies file A on machine X
to file B on machine Y, both file A and machine X would be specified in the
src portion of the UDM event.
.google.backstory.Noun src = 4;
| Returns |
| Type |
Description |
boolean |
Whether the src field is set.
|
hasTarget()
public boolean hasTarget()
Represents a target entity being referenced by the event or an object on
the target entity. For example, in a firewall connection from device A to
device B, A is described as the principal and B is described as the target.
For a process injection by process C into target process D, process C is
described as the principal and process D is described as the target.
.google.backstory.Noun target = 5;
| Returns |
| Type |
Description |
boolean |
Whether the target field is set.
|
hashCode()
| Returns |
| Type |
Description |
int |
|
Overrides
internalGetFieldAccessorTable()
protected GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()
Overrides
isInitialized()
public final boolean isInitialized()
Overrides
newBuilderForType()
public UDM.Builder newBuilderForType()
newBuilderForType(AbstractMessage.BuilderParent parent)
protected UDM.Builder newBuilderForType(AbstractMessage.BuilderParent parent)
Overrides
toBuilder()
public UDM.Builder toBuilder()
writeTo(CodedOutputStream output)
public void writeTo(CodedOutputStream output)
Overrides