NAME

STIX::Observable::Artifact - STIX Cyber-observable Object (SCO) - Artifact

SYNOPSIS

use STIX::Observable::Artifact;

my $artifact = STIX::Observable::Artifact->new();

DESCRIPTION

The Artifact Object permits capturing an array of bytes (8-bits), as a base64-encoded string string, or linking to a file-like payload.

METHODS

STIX::Observable::Artifact inherits all methods from STIX::Observable and implements the following new ones.

STIX::Observable::Artifact->new(%properties)

Create a new instance of STIX::Observable::Artifact.

$artifact->decryption_key

Specifies the decryption key for the encrypted binary data (either via payload_bin or url).

$artifact->encryption_algorithm

If the artifact is encrypted, specifies the type of encryption algorithm the binary data (either via payload_bin or url) is encoded in.

$artifact->hashes

Specifies a dictionary of hashes for the contents of the url or the payload_bin. This MUST be provided when the url property is present (see STIX::Common::Hashes).

$artifact->id
$artifact->mime_type

The value of this property MUST be a valid MIME type as specified in the IANA Media Types registry.

$artifact->payload_bin

Specifies the binary data contained in the artifact as a base64-encoded string.

$artifact->type

The value of this property MUST be artifact.

$artifact->url

The value of this property MUST be a valid URL that resolves to the unencoded content.

HELPERS

$artifact->TO_JSON

Encode the object in JSON.

$artifact->to_hash

Return the object HASH.

$artifact->to_string

Encode the object in JSON.

$artifact->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.