Skip to main content

MinIO

Supported versions

Supported Cortex XSOAR versions: 6.0.0 and later.

An Integration with MinIO Object Storage This integration was integrated and tested with RELEASE.2020-12 of MinIO.

Configure MinIO on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for MinIO.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    serverServer Name or Address (e.g. 8.8.8.8)True
    portPort NumberTrue
    access_keyAccess KeyTrue
    access_secretAccess SecretTrue
    sslConnect over SSLFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

minio-make-bucket#


Create a new bucket.

Base Command#

minio-make-bucket

Input#

Argument NameDescriptionRequired
nameBucket Name.Required

Context Output#

PathTypeDescription
MinIO.Buckets.bucketUnknownMinIO Bucket Name
MinIO.Buckets.statusUnknownMinIO Bucket Status

Command Example#

!minio-make-bucket name="test20"

Context Example#

{
"MinIO": {
"Buckets": {
"bucket": "test20",
"status": "created"
}
}
}

Human Readable Output#

Results#

bucketstatus
test20created

minio-remove-bucket#


Remove an existing bucket.

Base Command#

minio-remove-bucket

Input#

Argument NameDescriptionRequired
nameBucket Name.Required

Context Output#

PathTypeDescription
MinIO.Buckets.bucketUnknownMinIO Bucket Name
MinIO.Buckets.statusUnknownMinIO Bucket Status

Command Example#

!minio-remove-bucket name="test20"

Context Example#

{
"MinIO": {
"Buckets": {
"bucket": "test20",
"status": "removed"
}
}
}

Human Readable Output#

Results#

bucketstatus
test20removed

minio-list-buckets#


List All MinIO Buckets

Base Command#

minio-list-buckets

Input#

There are no input arguments for this command.

Context Output#

PathTypeDescription
MinIO.BucketsUnknownMinIO Buckets

Command Example#

!minio-list-buckets

Context Example#

{
"MinIO": {
"Buckets": [
{
"bucket": "opencti-bucket",
"creation_date": "2020-12-18 17:06:04.887000+00:00"
},
{
"bucket": "test1",
"creation_date": "2020-12-29 10:54:39.996000+00:00"
},
{
"bucket": "test10",
"creation_date": "2020-12-29 10:45:46.962000+00:00"
}
]
}
}

Human Readable Output#

Results#

bucketcreation_date
opencti-bucket2020-12-18 17:06:04.887000+00:00
test12020-12-29 10:54:39.996000+00:00
test102020-12-29 10:45:46.962000+00:00

minio-list-objects#


Lists object information of a bucket.

Base Command#

minio-list-objects

Input#

Argument NameDescriptionRequired
bucket_nameName of the bucket.Required
prefixObject name starts with prefix.Optional
start_afterList objects after this key name.Optional
include_user_metaMinIO specific flag to control to include user metadata. Possible values are: True, False.Optional

Context Output#

PathTypeDescription
MinIO.ObjectsUnknownMinIO Objects

Command Example#

!minio-list-objects bucket_name="test10"

Context Example#

{
"MinIO": {
"Objects": [
{
"bucket": "test10",
"etag": "4be6f1e4bda138a555416b866a90530c",
"is_dir": false,
"last_modified": "2020-12-29 10:46:04.387000+00:00",
"object": "MINIO_wordmark.png",
"size": 11496
},
{
"bucket": "test10",
"etag": "c4e3802707693c8df821b37c91c0cfd8",
"is_dir": false,
"last_modified": "2020-12-30 06:10:37.886000+00:00",
"object": "test.txt",
"size": 9
},
{
"bucket": "test10",
"etag": "7a6add52bec4ca39eedeea16927c92e3",
"is_dir": false,
"last_modified": "2020-12-30 06:12:33.487000+00:00",
"object": "test.yml",
"size": 34960
}
]
}
}

Human Readable Output#

Results#

bucketetagis_dirlast_modifiedobjectsize
test104be6f1e4bda138a555416b866a90530cfalse2020-12-29 10:46:04.387000+00:00MINIO_wordmark.png11496
test10c4e3802707693c8df821b37c91c0cfd8false2020-12-30 06:10:37.886000+00:00test.txt9
test107a6add52bec4ca39eedeea16927c92e3false2020-12-30 06:12:33.487000+00:00test.yml34960

minio-get-object#


Gets data from offset to length of an object.

Base Command#

minio-get-object

Input#

Argument NameDescriptionRequired
bucket_nameBucket Name.Required
nameObject Name.Required
offsetStart byte position of object data.Optional
lengthNumber of bytes of object data from offset. Possible values are: .Optional
request_headersAny additional headers to be added with GET request.Optional
extra_query_paramsExtra query parameters for advanced usage.Optional

Context Output#

There is no context output for this command.

Command Example#

!minio-get-object bucket_name="test10" name="MINIO_wordmark.png"

Context Example#

{
"File": {
"EntryID": "399@58b146a9-f748-4f65-8846-a1d63c7e77f4",
"Extension": "png",
"Info": "image/png",
"MD5": "4be6f1e4bda138a555416b866a90530c",
"Name": "MINIO_wordmark.png",
"SHA1": "568f64faee0471c811e6ef5234428751236f9ad2",
"SHA256": "d53ad84d5c44a6991b0b6109703aff663d5d016ee93762eaf46624144f1c6fc5",
"SHA512": "8d5ba7577cd2a98c0a973997978c31700996d54dd76e332a108fdb5a4694e55c7c172c8bae1d1189810b4d766bbffa52c6f1acb599c5679666a4e8368241a710",
"SSDeep": "192:DBfcNvyaPaOjCOSXA/DA47c6qurTlvUnHjXoRBVaYuKY7BF019UtNB2KBlloHfoe:iB1PaO7SXA/DA47LqqToD6TaYufAcJNq",
"Size": 11496,
"Type": "PNG image data, 2401 x 362, 8-bit colormap, non-interlaced"
}
}

Human Readable Output#

minio-stat-object#


Get object information and metadata of an object.

Base Command#

minio-stat-object

Input#

Argument NameDescriptionRequired
bucket_nameBucket Name.Required
nameObject Name.Required
extra_query_paramsExtra query parameters for advanced usage.Optional

Context Output#

There is no context output for this command.

Command Example#

!minio-stat-object bucket_name="test10" name="test.txt"

Context Example#

{
"MinIO": {
"Objects": {
"bucket": "test10",
"content-type": "application/octet-stream",
"etag": "\"c4e3802707693c8df821b37c91c0cfd8\"",
"object": "test.txt",
"size": 9
}
}
}

Human Readable Output#

Results#

bucketcontent-typeetagobjectsize
test10application/octet-stream"c4e3802707693c8df821b37c91c0cfd8"test.txt9

minio-remove-object#


Remove an object.

Base Command#

minio-remove-object

Input#

Argument NameDescriptionRequired
bucket_nameBucket Name.Required
nameObject Name.Required

Context Output#

PathTypeDescription
MinIO.Objects.nameUnknownObject Name
MinIO.Objects.statusUnknownObject Status

Command Example#

!minio-remove-object bucket_name="test10" name="test.txt"

Context Example#

{
"MinIO": {
"Objects": {
"bucket": "test10",
"object": "test.txt",
"status": "removed"
}
}
}

Human Readable Output#

Results#

bucketobjectstatus
test10test.txtremoved

minio-fput-object#


Uploads data from a file to an object in a bucket.

Base Command#

minio-fput-object

Input#

Argument NameDescriptionRequired
bucket_nameBucket Name. Possible values are: .Required
entry_idFile Entry ID.Required
content_typeFile Type.Optional
metadataAny additional metadata to be uploaded along with your PUT request.Optional

Context Output#

There is no context output for this command.

Command Example#

!minio-fput-object bucket_name="test10" entry_id="297@58b146a9-f748-4f65-8846-a1d63c7e77f4"

Context Example#

{
"MinIO": {
"Objects": {
"bucket": "test10",
"object": "test.yml",
"status": "uploaded"
}
}
}

Human Readable Output#

Results#

bucketobjectstatus
test10test.ymluploaded

minio-put-object#


Uploads data from a stream to an object in a bucket.

Base Command#

minio-put-object

Input#

Argument NameDescriptionRequired
bucket_nameBucket Name. Possible values are: .Required
dataContains object data.Required
nameObject name in the bucket.Required
content_typeFile Type.Optional
metadataAny additional metadata to be uploaded along with your PUT request.Optional

Context Output#

There is no context output for this command.

Command Example#

!minio-put-object bucket_name="test10" data="'test100'" name="test.txt"

Context Example#

{
"MinIO": {
"Objects": {
"bucket": "test10",
"object": "test.txt",
"status": "uploaded"
}
}
}

Human Readable Output#

Results#

bucketobjectstatus
test10test.txtuploaded