/ 
STIX-1.01
/ STIX::Sighting

NAME

STIX::Sighting - STIX Relationship Object (SRO) - Sighting

SYNOPSIS

use STIX::Sighting;

my $sighting = STIX::Sighting->new();

DESCRIPTION

A Sighting denotes the belief that something in CTI (e.g., an indicator, malware, tool, threat actor, etc.) was seen.

METHODS

STIX::Sighting inherits all methods from STIX::Common::Properties and implements the following new ones.

STIX::Sighting->new(%properties)

Create a new instance of STIX::Sighting.

$sighting->count

This is an integer between 0 and 999,999,999 inclusive and represents the number of times the object was sighted.

$sighting->description

A description that provides more details and context about the Sighting.

$sighting->first_seen

The beginning of the time window during which the SDO referenced by the sighting_of_ref property was sighted.

$sighting->id
$sighting->last_seen

The end of the time window during which the SDO referenced by the sighting_of_ref property was sighted.

$sighting->observed_data_refs

A list of ID references to the Observed Data objects that contain the raw cyber data for this Sighting.

$sighting->sighting_of_ref

An ID reference to the object that has been sighted.

$sighting->summary

The summary property indicates whether the Sighting should be considered summary data.

$sighting->type

The type of this object, which MUST be the literal sighting.

$sighting->where_sighted_refs

A list of ID references to the Identity or Location objects describing the entities or types of entities that saw the sighting.

HELPERS

$sighting->TO_JSON

Encode the object in JSON.

$sighting->to_hash

Return the object HASH.

$sighting->to_string

Encode the object in JSON.

$sighting->validate

Validate the object using JSON Schema (see STIX::Schema).

SUPPORT

Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at https://github.com/giterlizzi/perl-STIX/issues. You will be notified automatically of any progress on your issue.

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

https://github.com/giterlizzi/perl-STIX

git clone https://github.com/giterlizzi/perl-STIX.git

AUTHOR

  • Giuseppe Di Terlizzi <gdt@cpan.org>

LICENSE AND COPYRIGHT

This software is copyright (c) 2024 by Giuseppe Di Terlizzi.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.