Skip to main content

MitreCaldera

This Integration is part of the MITRE Caldera Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.2.0 and later.

Mitre Caldera can be used to test endpoint security solutions and assess a network's security posture against the common post-compromise adversarial techniques contained in the ATT&CK model. CALDERA leverages the ATT&CK model to identify and replicate adversary behaviors as if a real intrusion is occurring. This integration was integrated and tested with version 4.0.0 of MitreCaldera

Configure MitreCaldera in Cortex#

ParameterRequired
Server URL (e.g. https://www.example.com:8888)True
API KeyTrue
Trust any certificate (not secure)False
Use system proxy settingsFalse

Commands#

You can execute these commands from the 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.

caldera-create-fact#


Create a Fact

Base Command#

caldera-create-fact

Input#

Argument NameDescriptionRequired
fact_nameFact name.Optional
fact_linksFact links (CSV of IDs).Optional
fact_relationshipsFact relationships (CSV of IDs).Optional
fact_origin_typeFact origin type.Optional
fact_limit_countFact limit count.Optional
fact_technique_idFact technique ID.Optional
fact_traitFact trait.Required
fact_sourceFact source.Optional
fact_scoreFact score.Optional
fact_valueFact value.Optional

Context Output#

PathTypeDescription
MitreCaldera.Facts.uniqueString
MitreCaldera.Facts.nameString
MitreCaldera.Facts.createdString
MitreCaldera.Facts.limit_countNumber
MitreCaldera.Facts.technique_idString
MitreCaldera.Facts.traitString
MitreCaldera.Facts.sourceString
MitreCaldera.Facts.scoreNumber

caldera-create-fact-source#


Create a Fact Source.

Base Command#

caldera-create-fact-source

Input#

Argument NameDescriptionRequired
nameName.Optional
adjustmentsAdjustments (array of adjustment objects).Optional
relationshipsRelationships (array of relationship objects).Optional
rulesRules (array of rule objects).Optional
factsFacts (array of fact objects).Optional
pluginPlugin.Optional

Context Output#

PathTypeDescription
MitreCaldera.Sources.nameString
MitreCaldera.Sources.adjustments.ability_idString
MitreCaldera.Sources.adjustments.offsetNumber
MitreCaldera.Sources.adjustments.traitString
MitreCaldera.Sources.adjustments.valueString
MitreCaldera.Sources.relationships.uniqueString
MitreCaldera.Sources.relationships.originString
MitreCaldera.Sources.relationships.edgeString
MitreCaldera.Sources.relationships.scoreNumber
MitreCaldera.Sources.idString
MitreCaldera.Sources.rules.traitString
MitreCaldera.Sources.rules.matchString
MitreCaldera.Sources.facts.uniqueString
MitreCaldera.Sources.facts.nameString
MitreCaldera.Sources.facts.createdString
MitreCaldera.Sources.facts.limit_countNumber
MitreCaldera.Sources.facts.technique_idString
MitreCaldera.Sources.facts.traitString
MitreCaldera.Sources.facts.sourceString
MitreCaldera.Sources.facts.scoreNumber
MitreCaldera.Sources.pluginString

caldera-create-adversary#


Create a new adversary

Base Command#

caldera-create-adversary

Input#

Argument NameDescriptionRequired
nameAdversary name.Optional
tagsTags (CSV of tag names).Optional
objectiveObjective.Optional
atomic_orderingAtomic ordering (CSV of ability IDs).Optional
pluginPlugin.Optional
descriptionDescription.Optional

Context Output#

PathTypeDescription
MitreCaldera.Adversaries.nameString
MitreCaldera.Adversaries.objectiveString
MitreCaldera.Adversaries.adversary_idString
MitreCaldera.Adversaries.has_repeatable_abilitiesBoolean
MitreCaldera.Adversaries.pluginString
MitreCaldera.Adversaries.descriptionString

caldera-create-agent#


Create a new agent

Base Command#

caldera-create-agent

Input#

Argument NameDescriptionRequired
watchdogWatchdog timer.Optional
deadman_enabledDeadman enabled (true or false). Possible values are: false, true. Default is false.Optional
ppidPPID.Optional
pidPID.Optional
proxy_receiversProxy Receivers (JSON dict).Optional
origin_link_idOrigin link ID.Optional
available_contactsAvailable contacts (CSV of contact IDs).Optional
platformPlatform.Optional
hostHost.Optional
groupGroup.Optional
locationLocation.Optional
display_nameDisplay name.Optional
upstream_destUpstream destination.Optional
host_ip_addrsHost IP addresses (CSV of IP addresses).Optional
sleep_maxSleep maximum.Optional
architectureArchitecture.Optional
sleep_minSleep minimum.Optional
serverServer.Optional
contactContact.Optional
exeutorsExecutors (CSV of executor IDs).Optional
privilegePrivilege.Optional
usernameUsername.Optional
trustedTrusted. Possible values are: false, true. Default is true.Optional
proxy_chainProxy chain (array of proxy arrays).Optional
pawAgent PAW.Optional
exe_nameEXE name.Optional

Context Output#

PathTypeDescription
MitreCaldera.Agents.watchdogNumber
MitreCaldera.Agents.links.relationships.uniqueString
MitreCaldera.Agents.links.relationships.originString
MitreCaldera.Agents.links.relationships.edgeString
MitreCaldera.Agents.links.relationships.scoreNumber
MitreCaldera.Agents.links.idString
MitreCaldera.Agents.links.collectString
MitreCaldera.Agents.links.pidString
MitreCaldera.Agents.links.finishString
MitreCaldera.Agents.links.pinNumber
MitreCaldera.Agents.links.jitterNumber
MitreCaldera.Agents.links.agent_reported_timeString
MitreCaldera.Agents.links.deadmanBoolean
MitreCaldera.Agents.links.used.uniqueString
MitreCaldera.Agents.links.used.nameString
MitreCaldera.Agents.links.used.createdString
MitreCaldera.Agents.links.used.limit_countNumber
MitreCaldera.Agents.links.used.technique_idString
MitreCaldera.Agents.links.used.traitString
MitreCaldera.Agents.links.used.sourceString
MitreCaldera.Agents.links.used.scoreNumber
MitreCaldera.Agents.links.hostString
MitreCaldera.Agents.links.statusNumber
MitreCaldera.Agents.links.scoreNumber
MitreCaldera.Agents.links.commandString
MitreCaldera.Agents.links.uniqueString
MitreCaldera.Agents.links.cleanupNumber
MitreCaldera.Agents.links.decideString
MitreCaldera.Agents.links.facts.uniqueString
MitreCaldera.Agents.links.facts.nameString
MitreCaldera.Agents.links.facts.createdString
MitreCaldera.Agents.links.facts.limit_countNumber
MitreCaldera.Agents.links.facts.technique_idString
MitreCaldera.Agents.links.facts.traitString
MitreCaldera.Agents.links.facts.sourceString
MitreCaldera.Agents.links.facts.scoreNumber
MitreCaldera.Agents.links.pawString
MitreCaldera.Agents.links.outputString
MitreCaldera.Agents.deadman_enabledBoolean
MitreCaldera.Agents.ppidNumber
MitreCaldera.Agents.pidNumber
MitreCaldera.Agents.createdString
MitreCaldera.Agents.origin_link_idString
MitreCaldera.Agents.last_seenString
MitreCaldera.Agents.platformString
MitreCaldera.Agents.pending_contactString
MitreCaldera.Agents.hostString
MitreCaldera.Agents.groupString
MitreCaldera.Agents.locationString
MitreCaldera.Agents.display_nameString
MitreCaldera.Agents.upstream_destString
MitreCaldera.Agents.sleep_maxNumber
MitreCaldera.Agents.architectureString
MitreCaldera.Agents.sleep_minNumber
MitreCaldera.Agents.serverString
MitreCaldera.Agents.contactString
MitreCaldera.Agents.privilegeString
MitreCaldera.Agents.usernameString
MitreCaldera.Agents.trustedBoolean
MitreCaldera.Agents.proxy_chainString
MitreCaldera.Agents.pawString
MitreCaldera.Agents.exe_nameString

caldera-create-operation#


Create a new CALDERA operation record

Base Command#

caldera-create-operation

Input#

Argument NameDescriptionRequired
nameOperation name.Required
autonomousAutonomous (autonomous or manual). Possible values are: autonomous, manual. Default is autonomous.Optional
objective_idObjective ID.Optional
visibilityHow visible should the operation be to the defense (1-100), default is 51.Optional
stateState. Possible values are: running, paused, run_one_link. Default is running.Optional
groupGroup.Optional
host_groupHost group.Optional
planner_idPlanner ID.Required
obfuscatorObfuscator. Possible values are: base64, base64jumble, base64noPadding, caesar cipher, plain-text, steganography. Default is plain-text.Optional
use_learning_parsersUse learning parsers. Possible values are: false, true. Default is false.Optional
source_idSource ID.Required
jitterJitter is defined as a fraction (default is "2/8").Optional
adversary_idadversary id.Required
auto_closeAuto close. Possible values are: false, true. Default is false.Optional

Context Output#

PathTypeDescription
MitreCaldera.Operations.nameString
MitreCaldera.Operations.autonomousNumber
MitreCaldera.Operations.idString
MitreCaldera.Operations.visibilityNumber
MitreCaldera.Operations.stateString
MitreCaldera.Operations.groupString
MitreCaldera.Operations.host_group.watchdogNumber
MitreCaldera.Operations.host_group.links.relationships.uniqueString
MitreCaldera.Operations.host_group.links.relationships.originString
MitreCaldera.Operations.host_group.links.relationships.edgeString
MitreCaldera.Operations.host_group.links.relationships.scoreNumber
MitreCaldera.Operations.host_group.links.idString
MitreCaldera.Operations.host_group.links.collectString
MitreCaldera.Operations.host_group.links.pidString
MitreCaldera.Operations.host_group.links.finishString
MitreCaldera.Operations.host_group.links.pinNumber
MitreCaldera.Operations.host_group.links.jitterNumber
MitreCaldera.Operations.host_group.links.agent_reported_timeString
MitreCaldera.Operations.host_group.links.deadmanBoolean
MitreCaldera.Operations.host_group.links.used.uniqueString
MitreCaldera.Operations.host_group.links.used.nameString
MitreCaldera.Operations.host_group.links.used.createdString
MitreCaldera.Operations.host_group.links.used.limit_countNumber
MitreCaldera.Operations.host_group.links.used.technique_idString
MitreCaldera.Operations.host_group.links.used.traitString
MitreCaldera.Operations.host_group.links.used.sourceString
MitreCaldera.Operations.host_group.links.used.scoreNumber
MitreCaldera.Operations.host_group.links.hostString
MitreCaldera.Operations.host_group.links.statusNumber
MitreCaldera.Operations.host_group.links.scoreNumber
MitreCaldera.Operations.host_group.links.commandString
MitreCaldera.Operations.host_group.links.uniqueString
MitreCaldera.Operations.host_group.links.cleanupNumber
MitreCaldera.Operations.host_group.links.decideString
MitreCaldera.Operations.host_group.links.facts.uniqueString
MitreCaldera.Operations.host_group.links.facts.nameString
MitreCaldera.Operations.host_group.links.facts.createdString
MitreCaldera.Operations.host_group.links.facts.limit_countNumber
MitreCaldera.Operations.host_group.links.facts.technique_idString
MitreCaldera.Operations.host_group.links.facts.traitString
MitreCaldera.Operations.host_group.links.facts.sourceString
MitreCaldera.Operations.host_group.links.facts.scoreNumber
MitreCaldera.Operations.host_group.links.pawString
MitreCaldera.Operations.host_group.links.outputString
MitreCaldera.Operations.host_group.deadman_enabledBoolean
MitreCaldera.Operations.host_group.ppidNumber
MitreCaldera.Operations.host_group.pidNumber
MitreCaldera.Operations.host_group.createdString
MitreCaldera.Operations.host_group.origin_link_idString
MitreCaldera.Operations.host_group.last_seenString
MitreCaldera.Operations.host_group.platformString
MitreCaldera.Operations.host_group.pending_contactString
MitreCaldera.Operations.host_group.hostString
MitreCaldera.Operations.host_group.groupString
MitreCaldera.Operations.host_group.locationString
MitreCaldera.Operations.host_group.display_nameString
MitreCaldera.Operations.host_group.upstream_destString
MitreCaldera.Operations.host_group.sleep_maxNumber
MitreCaldera.Operations.host_group.architectureString
MitreCaldera.Operations.host_group.sleep_minNumber
MitreCaldera.Operations.host_group.serverString
MitreCaldera.Operations.host_group.contactString
MitreCaldera.Operations.host_group.privilegeString
MitreCaldera.Operations.host_group.usernameString
MitreCaldera.Operations.host_group.trustedBoolean
MitreCaldera.Operations.host_group.proxy_chainString
MitreCaldera.Operations.host_group.pawString
MitreCaldera.Operations.host_group.exe_nameString
MitreCaldera.Operations.obfuscatorString
MitreCaldera.Operations.use_learning_parsersBoolean
MitreCaldera.Operations.jitterString
MitreCaldera.Operations.startString
MitreCaldera.Operations.auto_closeBoolean

caldera-create-objective#


Create a new objective

Base Command#

caldera-create-objective

Input#

Argument NameDescriptionRequired
nameObjective name.Optional
goalsGoals (array of objective objects).Optional
descriptionDescription.Optional

Context Output#

PathTypeDescription
MitreCaldera.Objectives.nameString
MitreCaldera.Objectives.idString
MitreCaldera.Objectives.percentageUnknown
MitreCaldera.Objectives.goals.countNumber
MitreCaldera.Objectives.goals.achievedBoolean
MitreCaldera.Objectives.goals.operatorString
MitreCaldera.Objectives.goals.valueString
MitreCaldera.Objectives.goals.targetString
MitreCaldera.Objectives.descriptionString

caldera-create-relationship#


Create a Relationship

Base Command#

caldera-create-relationship

Input#

Argument NameDescriptionRequired
relationship_unique.Optional
relationship_origin.Optional
relationship_edge.Optional
relationship_source_uniquerelationship_source unique.Optional
relationship_source_namerelationship_source name.Optional
relationship_source_linksrelationship_source links.Optional
relationship_source_relationshipsrelationship_source relationships.Optional
relationship_source_origin_typerelationship_source origin_type.Optional
relationship_source_createdrelationship_source created.Optional
relationship_source_limit_countrelationship_source limit_count.Optional
relationship_source_technique_idrelationship_source technique_id.Optional
relationship_source_traitrelationship_source trait.Required
relationship_source_sourcerelationship_source source.Optional
relationship_source_scorerelationship_source score.Optional
relationship_source_valuerelationship_source value.Optional
relationship_source_collected_byrelationship_source collected_by.Optional
relationship_score.Optional
relationship_target.Optional

Context Output#

PathTypeDescription
MitreCaldera.Relationship.uniqueString
MitreCaldera.Relationship.originString
MitreCaldera.Relationship.edgeString
MitreCaldera.Relationship.scoreNumber

caldera-create-ability#


Creates a new ability.

Base Command#

caldera-create-ability

Input#

Argument NameDescriptionRequired
ability_ability_id.Optional
ability_name.Optional
ability_buckets.Optional
ability_technique_id.Optional
ability_delete_payload.Optional
ability_executors.Optional
ability_privilege.Optional
ability_requirements.Optional
ability_plugin.Optional
ability_access.Optional
ability_tactic.Optional
ability_additional_info.Optional
ability_singleton.Optional
ability_technique_name.Optional
ability_repeatable.Optional
ability_description.Optional

Context Output#

PathTypeDescription
MitreCaldera.Abilities.ability_idString
MitreCaldera.Abilities.nameString
MitreCaldera.Abilities.technique_idString
MitreCaldera.Abilities.delete_payloadBoolean
MitreCaldera.Abilities.executors.nameString
MitreCaldera.Abilities.executors.platformString
MitreCaldera.Abilities.executors.languageString
MitreCaldera.Abilities.executors.variations.commandString
MitreCaldera.Abilities.executors.variations.descriptionString
MitreCaldera.Abilities.executors.build_targetString
MitreCaldera.Abilities.executors.timeoutNumber
MitreCaldera.Abilities.executors.parsers.moduleString
MitreCaldera.Abilities.executors.parsers.parserconfigs.edgeString
MitreCaldera.Abilities.executors.parsers.parserconfigs.sourceString
MitreCaldera.Abilities.executors.parsers.parserconfigs.targetString
MitreCaldera.Abilities.executors.commandString
MitreCaldera.Abilities.executors.codeString
MitreCaldera.Abilities.privilegeString
MitreCaldera.Abilities.requirements.moduleString
MitreCaldera.Abilities.pluginString
MitreCaldera.Abilities.tacticString
MitreCaldera.Abilities.singletonBoolean
MitreCaldera.Abilities.technique_nameString
MitreCaldera.Abilities.repeatableBoolean
MitreCaldera.Abilities.descriptionString

caldera-create-potential-link#


Creates a potential Link

Base Command#

caldera-create-potential-link

Input#

Argument NameDescriptionRequired
operation_idUUID of the operation object for the link to be created on.Required
link_relationships.Optional
link_id.Optional
link_collect.Optional
link_pid.Optional
link_visibility_adjustmentslink_visibility adjustments.Optional
link_visibility_scorelink_visibility score.Optional
link_finish.Optional
link_pin.Optional
link_jitter.Optional
link_agent_reported_time.Optional
link_deadman.Optional
link_used.Optional
link_host.Optional
link_ability_ability_idlink_ability ability_id.Optional
link_ability_namelink_ability name.Optional
link_ability_bucketslink_ability buckets.Optional
link_ability_technique_idlink_ability technique_id.Optional
link_ability_delete_payloadlink_ability delete_payload.Optional
link_ability_executorslink_ability executors.Optional
link_ability_privilegelink_ability privilege.Optional
link_ability_requirementslink_ability requirements.Optional
link_ability_pluginlink_ability plugin.Optional
link_ability_accesslink_ability access.Optional
link_ability_tacticlink_ability tactic.Optional
link_ability_additional_infolink_ability additional_info.Optional
link_ability_singletonlink_ability singleton.Optional
link_ability_technique_namelink_ability technique_name.Optional
link_ability_repeatablelink_ability repeatable.Optional
link_ability_descriptionlink_ability description.Optional
link_status.Optional
link_score.Optional
link_command.Optional
link_unique.Optional
link_cleanup.Optional
link_decide.Optional
link_facts.Optional
link_executor_namelink_executor name.Optional
link_executor_cleanuplink_executor cleanup.Optional
link_executor_platformlink_executor platform.Optional
link_executor_languagelink_executor language.Optional
link_executor_uploadslink_executor uploads.Optional
link_executor_variationslink_executor variations.Optional
link_executor_build_targetlink_executor build_target.Optional
link_executor_payloadslink_executor payloads.Optional
link_executor_timeoutlink_executor timeout.Optional
link_executor_parserslink_executor parsers.Optional
link_executor_commandlink_executor command.Optional
link_executor_additional_infolink_executor additional_info.Optional
link_executor_codelink_executor code.Optional
link_paw.Optional
link_output.Optional

Context Output#

PathTypeDescription
MitreCaldera.Links.relationships.uniqueString
MitreCaldera.Links.relationships.originString
MitreCaldera.Links.relationships.edgeString
MitreCaldera.Links.relationships.scoreNumber
MitreCaldera.Links.idString
MitreCaldera.Links.collectString
MitreCaldera.Links.pidString
MitreCaldera.Links.finishString
MitreCaldera.Links.pinNumber
MitreCaldera.Links.jitterNumber
MitreCaldera.Links.agent_reported_timeString
MitreCaldera.Links.deadmanBoolean
MitreCaldera.Links.used.uniqueString
MitreCaldera.Links.used.nameString
MitreCaldera.Links.used.createdString
MitreCaldera.Links.used.limit_countNumber
MitreCaldera.Links.used.technique_idString
MitreCaldera.Links.used.traitString
MitreCaldera.Links.used.sourceString
MitreCaldera.Links.used.scoreNumber
MitreCaldera.Links.hostString
MitreCaldera.Links.statusNumber
MitreCaldera.Links.scoreNumber
MitreCaldera.Links.commandString
MitreCaldera.Links.uniqueString
MitreCaldera.Links.cleanupNumber
MitreCaldera.Links.decideString
MitreCaldera.Links.facts.uniqueString
MitreCaldera.Links.facts.nameString
MitreCaldera.Links.facts.createdString
MitreCaldera.Links.facts.limit_countNumber
MitreCaldera.Links.facts.technique_idString
MitreCaldera.Links.facts.traitString
MitreCaldera.Links.facts.sourceString
MitreCaldera.Links.facts.scoreNumber
MitreCaldera.Links.pawString
MitreCaldera.Links.outputString

caldera-create-schedule#


Create Schedule

Base Command#

caldera-create-schedule

Input#

Argument NameDescriptionRequired
schedule_schedule.Required
schedule_task_nameschedule_task name.Optional
schedule_task_autonomousschedule_task autonomous.Optional
schedule_task_idschedule_task id.Optional
schedule_task_objectiveschedule_task objective.Optional
schedule_task_visibilityschedule_task visibility.Optional
schedule_task_stateschedule_task state.Optional
schedule_task_groupschedule_task group.Optional
schedule_task_host_groupschedule_task host_group.Optional
schedule_task_plannerschedule_task planner.Optional
schedule_task_obfuscatorschedule_task obfuscator.Optional
schedule_task_chainschedule_task chain.Optional
schedule_task_use_learning_parsersschedule_task use_learning_parsers.Optional
schedule_task_sourceschedule_task source.Optional
schedule_task_jitterschedule_task jitter.Optional
schedule_task_startschedule_task start.Optional
schedule_task_adversaryschedule_task adversary.Optional
schedule_task_auto_closeschedule_task auto_close.Optional
schedule_id.Optional

Context Output#

PathTypeDescription
MitreCaldera.Schedule.scheduleString
MitreCaldera.Schedule.idString

caldera-delete-agent#


Delete an Agent

Base Command#

caldera-delete-agent

Input#

Argument NameDescriptionRequired
pawpaw of the Agent to be deleted.Required

Context Output#

There is no context output for this command.

caldera-delete-fact-source#


Delete an existing Fact Source.

Base Command#

caldera-delete-fact-source

Input#

Argument NameDescriptionRequired
fact_source_idThe id of the Fact Source to be deleted.Required

Context Output#

There is no context output for this command.

caldera-delete-operation#


Delete an operation by operation id

Base Command#

caldera-delete-operation

Input#

Argument NameDescriptionRequired
operation_idUUID of the Operation object to be retrieved.Required

Context Output#

There is no context output for this command.

caldera-delete-facts#


Delete One or More Facts

Base Command#

caldera-delete-facts

Input#

Argument NameDescriptionRequired
fact_unique.Optional
fact_name.Optional
fact_links.Optional
fact_relationships.Optional
fact_origin_type.Optional
fact_created.Optional
fact_limit_count.Optional
fact_technique_id.Optional
fact_trait.Optional
fact_source.Optional
fact_score.Optional
fact_value.Optional
fact_collected_by.Optional

Context Output#

PathTypeDescription
MitreCaldera.Facts.uniqueString
MitreCaldera.Facts.nameString
MitreCaldera.Facts.createdString
MitreCaldera.Facts.limit_countNumber
MitreCaldera.Facts.technique_idString
MitreCaldera.Facts.traitString
MitreCaldera.Facts.sourceString
MitreCaldera.Facts.scoreNumber

caldera-delete-relationships#


Delete One or More Relationships

Base Command#

caldera-delete-relationships

Input#

Argument NameDescriptionRequired
relationship_unique.Optional
relationship_origin.Optional
relationship_edge.Optional
relationship_source_uniquerelationship_source unique.Optional
relationship_source_namerelationship_source name.Optional
relationship_source_linksrelationship_source links.Optional
relationship_source_relationshipsrelationship_source relationships.Optional
relationship_source_origin_typerelationship_source origin_type.Optional
relationship_source_createdrelationship_source created.Optional
relationship_source_limit_countrelationship_source limit_count.Optional
relationship_source_technique_idrelationship_source technique_id.Optional
relationship_source_traitrelationship_source trait.Optional
relationship_source_sourcerelationship_source source.Optional
relationship_source_scorerelationship_source score.Optional
relationship_source_valuerelationship_source value.Optional
relationship_source_collected_byrelationship_source collected_by.Optional
relationship_score.Optional
relationship_target.Optional

Context Output#

PathTypeDescription
MitreCaldera.Relationship.uniqueString
MitreCaldera.Relationship.originString
MitreCaldera.Relationship.edgeString
MitreCaldera.Relationship.scoreNumber

caldera-delete-ability#


Deletes an ability.

Base Command#

caldera-delete-ability

Input#

Argument NameDescriptionRequired
ability_idUUID of the Ability to be deleted.Required

Context Output#

There is no context output for this command.

caldera-delete-adversary#


Deletes an adversary.

Base Command#

caldera-delete-adversary

Input#

Argument NameDescriptionRequired
adversary_idUUID of the adversary to be deleted.Required

Context Output#

There is no context output for this command.

caldera-delete-schedule#


Delete Schedule

Base Command#

caldera-delete-schedule

Input#

Argument NameDescriptionRequired
schedule_idUUID of the Schedule to be deleted.Required

Context Output#

There is no context output for this command.

caldera-get-abilities#


Get all Abilities with optional ability ID.

Base Command#

caldera-get-abilities

Input#

Argument NameDescriptionRequired
ability_idOptional UUID of the Ability to be retrieved.Optional
sortResults are sorted if no Ability ID is provided.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Abilities.ability_idString
MitreCaldera.Abilities.nameString
MitreCaldera.Abilities.technique_idString
MitreCaldera.Abilities.delete_payloadBoolean
MitreCaldera.Abilities.executors.nameString
MitreCaldera.Abilities.executors.platformString
MitreCaldera.Abilities.executors.languageString
MitreCaldera.Abilities.executors.variations.commandString
MitreCaldera.Abilities.executors.variations.descriptionString
MitreCaldera.Abilities.executors.build_targetString
MitreCaldera.Abilities.executors.timeoutNumber
MitreCaldera.Abilities.executors.parsers.moduleString
MitreCaldera.Abilities.executors.parsers.parserconfigs.edgeString
MitreCaldera.Abilities.executors.parsers.parserconfigs.sourceString
MitreCaldera.Abilities.executors.parsers.parserconfigs.targetString
MitreCaldera.Abilities.executors.commandString
MitreCaldera.Abilities.executors.codeString
MitreCaldera.Abilities.privilegeString
MitreCaldera.Abilities.requirements.moduleString
MitreCaldera.Abilities.pluginString
MitreCaldera.Abilities.tacticString
MitreCaldera.Abilities.singletonBoolean
MitreCaldera.Abilities.technique_nameString
MitreCaldera.Abilities.repeatableBoolean
MitreCaldera.Abilities.descriptionString

caldera-get-adversaries#


Get all Adversaries with optional Adversary ID

Base Command#

caldera-get-adversaries

Input#

Argument NameDescriptionRequired
adversary_idOptional UUID of the adversary to be retrieved.Optional
sortResults are sorted if no Adversary ID is provided.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Adversaries.nameString
MitreCaldera.Adversaries.objectiveString
MitreCaldera.Adversaries.adversary_idString
MitreCaldera.Adversaries.has_repeatable_abilitiesBoolean
MitreCaldera.Adversaries.pluginString
MitreCaldera.Adversaries.descriptionString

caldera-get-agents#


Retrieves all agents with optional Agent PAW

Base Command#

caldera-get-agents

Input#

Argument NameDescriptionRequired
pawOptioanl PAW ID of the Agent to retrieve information about.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Agents.watchdogNumber
MitreCaldera.Agents.links.relationships.uniqueString
MitreCaldera.Agents.links.relationships.originString
MitreCaldera.Agents.links.relationships.edgeString
MitreCaldera.Agents.links.relationships.scoreNumber
MitreCaldera.Agents.links.idString
MitreCaldera.Agents.links.collectString
MitreCaldera.Agents.links.pidString
MitreCaldera.Agents.links.finishString
MitreCaldera.Agents.links.pinNumber
MitreCaldera.Agents.links.jitterNumber
MitreCaldera.Agents.links.agent_reported_timeString
MitreCaldera.Agents.links.deadmanBoolean
MitreCaldera.Agents.links.used.uniqueString
MitreCaldera.Agents.links.used.nameString
MitreCaldera.Agents.links.used.createdString
MitreCaldera.Agents.links.used.limit_countNumber
MitreCaldera.Agents.links.used.technique_idString
MitreCaldera.Agents.links.used.traitString
MitreCaldera.Agents.links.used.sourceString
MitreCaldera.Agents.links.used.scoreNumber
MitreCaldera.Agents.links.hostString
MitreCaldera.Agents.links.statusNumber
MitreCaldera.Agents.links.scoreNumber
MitreCaldera.Agents.links.commandString
MitreCaldera.Agents.links.uniqueString
MitreCaldera.Agents.links.cleanupNumber
MitreCaldera.Agents.links.decideString
MitreCaldera.Agents.links.facts.uniqueString
MitreCaldera.Agents.links.facts.nameString
MitreCaldera.Agents.links.facts.createdString
MitreCaldera.Agents.links.facts.limit_countNumber
MitreCaldera.Agents.links.facts.technique_idString
MitreCaldera.Agents.links.facts.traitString
MitreCaldera.Agents.links.facts.sourceString
MitreCaldera.Agents.links.facts.scoreNumber
MitreCaldera.Agents.links.pawString
MitreCaldera.Agents.links.outputString
MitreCaldera.Agents.deadman_enabledBoolean
MitreCaldera.Agents.ppidNumber
MitreCaldera.Agents.pidNumber
MitreCaldera.Agents.createdString
MitreCaldera.Agents.origin_link_idString
MitreCaldera.Agents.last_seenString
MitreCaldera.Agents.platformString
MitreCaldera.Agents.pending_contactString
MitreCaldera.Agents.hostString
MitreCaldera.Agents.groupString
MitreCaldera.Agents.locationString
MitreCaldera.Agents.display_nameString
MitreCaldera.Agents.upstream_destString
MitreCaldera.Agents.sleep_maxNumber
MitreCaldera.Agents.architectureString
MitreCaldera.Agents.sleep_minNumber
MitreCaldera.Agents.serverString
MitreCaldera.Agents.contactString
MitreCaldera.Agents.privilegeString
MitreCaldera.Agents.usernameString
MitreCaldera.Agents.trustedBoolean
MitreCaldera.Agents.proxy_chainString
MitreCaldera.Agents.pawString
MitreCaldera.Agents.exe_nameString

caldera-get-config#


Retrieve Config

Base Command#

caldera-get-config

Input#

Argument NameDescriptionRequired
nameName of the configuration file to be retrieved (example: main). Default is main.Required

Context Output#

PathTypeDescription
MitreCaldera.NameStringConfig name
MitreCaldera.ConfigUnknownConfig settings

caldera-get-contacts#


Retrieve a List of all available Contact reports

Base Command#

caldera-get-contacts

Input#

Argument NameDescriptionRequired
nameOptional name of the contact to get beacons for, e.g. HTTP, TCP, et cetera.Optional

Context Output#

PathTypeDescription
MitreCaldera.ContactsUnknnownList of contacts

caldera-get-deploy-commands#


Retrieve deploy commands with optional Ability ID

Base Command#

caldera-get-deploy-commands

Input#

Argument NameDescriptionRequired
ability_idID of the ability to retrieve deploy commands for.Optional

Context Output#

PathTypeDescription
MitreCaldera.DeployCommands.commandStringCommand
MitreCaldera.DeployCommands.descriptionStringDescription
MitreCaldera.DeployCommands.executorStringExecutor
MitreCaldera.DeployCommands.nameStringName
MitreCaldera.DeployCommands.platformStringPlatform
MitreCaldera.DeployCommands.variations.commandStringCommand
MitreCaldera.DeployCommands.variations.descriptionStringDescription

caldera-get-facts#


Retrieve Facts with optional Operation ID

Base Command#

caldera-get-facts

Input#

Argument NameDescriptionRequired
sort.Optional
include.Optional
exclude.Optional
operation_idOptional Operation ID.Optional

Context Output#

PathTypeDescription
MitreCaldera.Facts.uniqueString
MitreCaldera.Facts.nameString
MitreCaldera.Facts.createdString
MitreCaldera.Facts.limit_countNumber
MitreCaldera.Facts.technique_idString
MitreCaldera.Facts.traitString
MitreCaldera.Facts.sourceString
MitreCaldera.Facts.scoreNumber

caldera-get-health#


Health endpoints returns the status of CALDERA

Base Command#

caldera-get-health

Input#

There are no input arguments for this command.

Context Output#

PathTypeDescription
MitreCaldera.CalderaInfo.applicationString
MitreCaldera.CalderaInfo.versionString
MitreCaldera.CalderaInfo.plugins.nameString
MitreCaldera.CalderaInfo.plugins.enabledBoolean
MitreCaldera.CalderaInfo.plugins.descriptionString
MitreCaldera.CalderaInfo.plugins.addressString

caldera-get-obfuscators#


Retrieve obfuscators with optional name

Base Command#

caldera-get-obfuscators

Input#

Argument NameDescriptionRequired
nameName of the Obfuscator.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Obfuscators.nameString
MitreCaldera.Obfuscators.moduleString
MitreCaldera.Obfuscators.descriptionString

caldera-get-objectives#


Retrieve objectives with optional Objective ID

Base Command#

caldera-get-objectives

Input#

Argument NameDescriptionRequired
idOptional UUID of the objective to be retrieved.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Objectives.nameString
MitreCaldera.Objectives.idString
MitreCaldera.Objectives.percentageUnknown
MitreCaldera.Objectives.goals.countNumber
MitreCaldera.Objectives.goals.achievedBoolean
MitreCaldera.Objectives.goals.operatorString
MitreCaldera.Objectives.goals.valueString
MitreCaldera.Objectives.goals.targetString
MitreCaldera.Objectives.descriptionString

caldera-get-operations#


Retrieve operations

Base Command#

caldera-get-operations

Input#

Argument NameDescriptionRequired
idOptional UUID of the Operation object to be retrieved.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Operations.nameString
MitreCaldera.Operations.autonomousNumber
MitreCaldera.Operations.idString
MitreCaldera.Operations.visibilityNumber
MitreCaldera.Operations.stateString
MitreCaldera.Operations.groupString
MitreCaldera.Operations.host_group.watchdogNumber
MitreCaldera.Operations.host_group.links.relationships.uniqueString
MitreCaldera.Operations.host_group.links.relationships.originString
MitreCaldera.Operations.host_group.links.relationships.edgeString
MitreCaldera.Operations.host_group.links.relationships.scoreNumber
MitreCaldera.Operations.host_group.links.idString
MitreCaldera.Operations.host_group.links.collectString
MitreCaldera.Operations.host_group.links.pidString
MitreCaldera.Operations.host_group.links.finishString
MitreCaldera.Operations.host_group.links.pinNumber
MitreCaldera.Operations.host_group.links.jitterNumber
MitreCaldera.Operations.host_group.links.agent_reported_timeString
MitreCaldera.Operations.host_group.links.deadmanBoolean
MitreCaldera.Operations.host_group.links.used.uniqueString
MitreCaldera.Operations.host_group.links.used.nameString
MitreCaldera.Operations.host_group.links.used.createdString
MitreCaldera.Operations.host_group.links.used.limit_countNumber
MitreCaldera.Operations.host_group.links.used.technique_idString
MitreCaldera.Operations.host_group.links.used.traitString
MitreCaldera.Operations.host_group.links.used.sourceString
MitreCaldera.Operations.host_group.links.used.scoreNumber
MitreCaldera.Operations.host_group.links.hostString
MitreCaldera.Operations.host_group.links.statusNumber
MitreCaldera.Operations.host_group.links.scoreNumber
MitreCaldera.Operations.host_group.links.commandString
MitreCaldera.Operations.host_group.links.uniqueString
MitreCaldera.Operations.host_group.links.cleanupNumber
MitreCaldera.Operations.host_group.links.decideString
MitreCaldera.Operations.host_group.links.facts.uniqueString
MitreCaldera.Operations.host_group.links.facts.nameString
MitreCaldera.Operations.host_group.links.facts.createdString
MitreCaldera.Operations.host_group.links.facts.limit_countNumber
MitreCaldera.Operations.host_group.links.facts.technique_idString
MitreCaldera.Operations.host_group.links.facts.traitString
MitreCaldera.Operations.host_group.links.facts.sourceString
MitreCaldera.Operations.host_group.links.facts.scoreNumber
MitreCaldera.Operations.host_group.links.pawString
MitreCaldera.Operations.host_group.links.outputString
MitreCaldera.Operations.host_group.deadman_enabledBoolean
MitreCaldera.Operations.host_group.ppidNumber
MitreCaldera.Operations.host_group.pidNumber
MitreCaldera.Operations.host_group.createdString
MitreCaldera.Operations.host_group.origin_link_idString
MitreCaldera.Operations.host_group.last_seenString
MitreCaldera.Operations.host_group.platformString
MitreCaldera.Operations.host_group.pending_contactString
MitreCaldera.Operations.host_group.hostString
MitreCaldera.Operations.host_group.groupString
MitreCaldera.Operations.host_group.locationString
MitreCaldera.Operations.host_group.display_nameString
MitreCaldera.Operations.host_group.upstream_destString
MitreCaldera.Operations.host_group.sleep_maxNumber
MitreCaldera.Operations.host_group.architectureString
MitreCaldera.Operations.host_group.sleep_minNumber
MitreCaldera.Operations.host_group.serverString
MitreCaldera.Operations.host_group.contactString
MitreCaldera.Operations.host_group.privilegeString
MitreCaldera.Operations.host_group.usernameString
MitreCaldera.Operations.host_group.trustedBoolean
MitreCaldera.Operations.host_group.proxy_chainString
MitreCaldera.Operations.host_group.pawString
MitreCaldera.Operations.host_group.exe_nameString
MitreCaldera.Operations.obfuscatorString
MitreCaldera.Operations.use_learning_parsersBoolean
MitreCaldera.Operations.jitterString
MitreCaldera.Operations.startString
MitreCaldera.Operations.auto_closeBoolean

caldera-get-operation-links#


Get Links from Operation with optional Link ID

Base Command#

caldera-get-operation-links

Input#

Argument NameDescriptionRequired
operation_id.Required
link_idOptional UUID of the Link with the operation.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.OperationLinks.relationships.uniqueString
MitreCaldera.OperationLinks.relationships.originString
MitreCaldera.OperationLinks.relationships.edgeString
MitreCaldera.OperationLinks.relationships.scoreNumber
MitreCaldera.OperationLinks.idString
MitreCaldera.OperationLinks.collectString
MitreCaldera.OperationLinks.pidString
MitreCaldera.OperationLinks.finishString
MitreCaldera.OperationLinks.pinNumber
MitreCaldera.OperationLinks.jitterNumber
MitreCaldera.OperationLinks.agent_reported_timeString
MitreCaldera.OperationLinks.deadmanBoolean
MitreCaldera.OperationLinks.used.uniqueString
MitreCaldera.OperationLinks.used.nameString
MitreCaldera.OperationLinks.used.createdString
MitreCaldera.OperationLinks.used.limit_countNumber
MitreCaldera.OperationLinks.used.technique_idString
MitreCaldera.OperationLinks.used.traitString
MitreCaldera.OperationLinks.used.sourceString
MitreCaldera.OperationLinks.used.scoreNumber
MitreCaldera.OperationLinks.hostString
MitreCaldera.OperationLinks.statusNumber
MitreCaldera.OperationLinks.scoreNumber
MitreCaldera.OperationLinks.commandString
MitreCaldera.OperationLinks.uniqueString
MitreCaldera.OperationLinks.cleanupNumber
MitreCaldera.OperationLinks.decideString
MitreCaldera.OperationLinks.facts.uniqueString
MitreCaldera.OperationLinks.facts.nameString
MitreCaldera.OperationLinks.facts.createdString
MitreCaldera.OperationLinks.facts.limit_countNumber
MitreCaldera.OperationLinks.facts.technique_idString
MitreCaldera.OperationLinks.facts.traitString
MitreCaldera.OperationLinks.facts.sourceString
MitreCaldera.OperationLinks.facts.scoreNumber
MitreCaldera.OperationLinks.pawString
MitreCaldera.OperationLinks.outputString

caldera-get-operation-links-result#


Retrieve the result of a link

Base Command#

caldera-get-operation-links-result

Input#

Argument NameDescriptionRequired
operation_idUUID of the operation object to be retrieved.Required
link_idUUID of the link object to retrieve results of.Required
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.OperationLinks.relationships.uniqueString
MitreCaldera.OperationLinks.relationships.originString
MitreCaldera.OperationLinks.relationships.edgeString
MitreCaldera.OperationLinks.relationships.scoreNumber
MitreCaldera.OperationLinks.idString
MitreCaldera.OperationLinks.collectString
MitreCaldera.OperationLinks.pidString
MitreCaldera.OperationLinks.finishString
MitreCaldera.OperationLinks.pinNumber
MitreCaldera.OperationLinks.jitterNumber
MitreCaldera.OperationLinks.agent_reported_timeString
MitreCaldera.OperationLinks.deadmanBoolean
MitreCaldera.OperationLinks.used.uniqueString
MitreCaldera.OperationLinks.used.nameString
MitreCaldera.OperationLinks.used.createdString
MitreCaldera.OperationLinks.used.limit_countNumber
MitreCaldera.OperationLinks.used.technique_idString
MitreCaldera.OperationLinks.used.traitString
MitreCaldera.OperationLinks.used.sourceString
MitreCaldera.OperationLinks.used.scoreNumber
MitreCaldera.OperationLinks.hostString
MitreCaldera.OperationLinks.statusNumber
MitreCaldera.OperationLinks.scoreNumber
MitreCaldera.OperationLinks.commandString
MitreCaldera.OperationLinks.uniqueString
MitreCaldera.OperationLinks.cleanupNumber
MitreCaldera.OperationLinks.decideString
MitreCaldera.OperationLinks.facts.uniqueString
MitreCaldera.OperationLinks.facts.nameString
MitreCaldera.OperationLinks.facts.createdString
MitreCaldera.OperationLinks.facts.limit_countNumber
MitreCaldera.OperationLinks.facts.technique_idString
MitreCaldera.OperationLinks.facts.traitString
MitreCaldera.OperationLinks.facts.sourceString
MitreCaldera.OperationLinks.facts.scoreNumber
MitreCaldera.OperationLinks.pawString
MitreCaldera.OperationLinks.outputString

caldera-get-operations-potential-links#


Retrieve potential links for an operation with optional PAW.

Base Command#

caldera-get-operations-potential-links

Input#

Argument NameDescriptionRequired
operation_idUUID of the operation object to retrieve links for.Required
pawOptional Agent paw for the specified operation.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.OperationLinks.relationships.uniqueString
MitreCaldera.OperationLinks.relationships.originString
MitreCaldera.OperationLinks.relationships.edgeString
MitreCaldera.OperationLinks.relationships.scoreNumber
MitreCaldera.OperationLinks.idString
MitreCaldera.OperationLinks.collectString
MitreCaldera.OperationLinks.pidString
MitreCaldera.OperationLinks.finishString
MitreCaldera.OperationLinks.pinNumber
MitreCaldera.OperationLinks.jitterNumber
MitreCaldera.OperationLinks.agent_reported_timeString
MitreCaldera.OperationLinks.deadmanBoolean
MitreCaldera.OperationLinks.used.uniqueString
MitreCaldera.OperationLinks.used.nameString
MitreCaldera.OperationLinks.used.createdString
MitreCaldera.OperationLinks.used.limit_countNumber
MitreCaldera.OperationLinks.used.technique_idString
MitreCaldera.OperationLinks.used.traitString
MitreCaldera.OperationLinks.used.sourceString
MitreCaldera.OperationLinks.used.scoreNumber
MitreCaldera.OperationLinks.hostString
MitreCaldera.OperationLinks.statusNumber
MitreCaldera.OperationLinks.scoreNumber
MitreCaldera.OperationLinks.commandString
MitreCaldera.OperationLinks.uniqueString
MitreCaldera.OperationLinks.cleanupNumber
MitreCaldera.OperationLinks.decideString
MitreCaldera.OperationLinks.facts.uniqueString
MitreCaldera.OperationLinks.facts.nameString
MitreCaldera.OperationLinks.facts.createdString
MitreCaldera.OperationLinks.facts.limit_countNumber
MitreCaldera.OperationLinks.facts.technique_idString
MitreCaldera.OperationLinks.facts.traitString
MitreCaldera.OperationLinks.facts.sourceString
MitreCaldera.OperationLinks.facts.scoreNumber
MitreCaldera.OperationLinks.pawString
MitreCaldera.OperationLinks.outputString

caldera-get-planners#


Retrieve planners with optional Planner ID

Base Command#

caldera-get-planners

Input#

Argument NameDescriptionRequired
planner_idUUID of the Planner object to be retrieved.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Planners.nameString
MitreCaldera.Planners.allow_repeatable_abilitiesBoolean
MitreCaldera.Planners.stopping_conditions.uniqueString
MitreCaldera.Planners.stopping_conditions.nameString
MitreCaldera.Planners.stopping_conditions.createdString
MitreCaldera.Planners.stopping_conditions.limit_countNumber
MitreCaldera.Planners.stopping_conditions.technique_idString
MitreCaldera.Planners.stopping_conditions.traitString
MitreCaldera.Planners.stopping_conditions.sourceString
MitreCaldera.Planners.stopping_conditions.scoreNumber
MitreCaldera.Planners.idString
MitreCaldera.Planners.pluginString
MitreCaldera.Planners.moduleString
MitreCaldera.Planners.descriptionString

caldera-get-plugins#


Retrieve plugins with optional Name

Base Command#

caldera-get-plugins

Input#

Argument NameDescriptionRequired
nameThe name of the plugin.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Plugins.nameString
MitreCaldera.Plugins.enabledBoolean
MitreCaldera.Plugins.addressString
MitreCaldera.Plugins.accessNumber
MitreCaldera.Plugins.data_dirString
MitreCaldera.Plugins.descriptionString

caldera-get-relationships#


Retrieve Relationships with optional Operation ID

Base Command#

caldera-get-relationships

Input#

Argument NameDescriptionRequired
operation_id.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Relationships.uniqueString
MitreCaldera.Relationships.originString
MitreCaldera.Relationships.edgeString
MitreCaldera.Relationships.scoreNumber

caldera-get-schedules#


Retrieve Schedules with optional Schedule ID

Base Command#

caldera-get-schedules

Input#

Argument NameDescriptionRequired
schedule_idOptional UUID of the Schedule to be retrieved.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Schedules.scheduleString
MitreCaldera.Schedules.idString

caldera-get-sources#


Retrieve all Fact Sources with optional Fact Source ID

Base Command#

caldera-get-sources

Input#

Argument NameDescriptionRequired
source_idThe id of the Fact Source.Optional
sort.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Sources.nameString
MitreCaldera.Sources.adjustments.ability_idString
MitreCaldera.Sources.adjustments.offsetNumber
MitreCaldera.Sources.adjustments.traitString
MitreCaldera.Sources.adjustments.valueString
MitreCaldera.Sources.relationships.uniqueString
MitreCaldera.Sources.relationships.originString
MitreCaldera.Sources.relationships.edgeString
MitreCaldera.Sources.relationships.scoreNumber
MitreCaldera.Sources.idString
MitreCaldera.Sources.rules.traitString
MitreCaldera.Sources.rules.matchString
MitreCaldera.Sources.facts.uniqueString
MitreCaldera.Sources.facts.nameString
MitreCaldera.Sources.facts.createdString
MitreCaldera.Sources.facts.limit_countNumber
MitreCaldera.Sources.facts.technique_idString
MitreCaldera.Sources.facts.traitString
MitreCaldera.Sources.facts.sourceString
MitreCaldera.Sources.facts.scoreNumber
MitreCaldera.Sources.pluginString

caldera-get-operation-event-logs#


Get Operation Event Logs

Base Command#

caldera-get-operation-event-logs

Input#

Argument NameDescriptionRequired
operation_id.Required
enable_agent_outputWhether to enable the agent output. Possible values are: false, true. Default is false.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Operations.EventLogs.idString
MitreCaldera.Operations.EventLogs.collected_timestampString
MitreCaldera.Operations.EventLogs.ability_metadataUnknown
MitreCaldera.Operations.EventLogs.attack_metadataUnknown
MitreCaldera.Operations.EventLogs.operation_metadataUnknown
MitreCaldera.Operations.EventLogs.finished_timestampString
MitreCaldera.Operations.EventLogs.agent_metadataUnknown
MitreCaldera.Operations.EventLogs.pidNumber
MitreCaldera.Operations.EventLogs.commandString
MitreCaldera.Operations.EventLogs.statusNumber
MitreCaldera.Operations.EventLogs.platformString
MitreCaldera.Operations.EventLogs.executorString
MitreCaldera.Operations.EventLogs.delegated_timestampString

caldera-get-operation-report#


Get Operation Report

Base Command#

caldera-get-operation-report

Input#

Argument NameDescriptionRequired
operation_id.Required
enable_agent_outputWhether to enable the agent output. Possible values are: false, true. Default is false.Optional
include.Optional
exclude.Optional

Context Output#

PathTypeDescription
MitreCaldera.Operations.OperationReport.idString
MitreCaldera.Operations.OperationReport.startString
MitreCaldera.Operations.OperationReport.stepsUnknown
MitreCaldera.Operations.OperationReport.factsUnknown
MitreCaldera.Operations.OperationReport.host_groupUnknown
MitreCaldera.Operations.OperationReport.nameString
MitreCaldera.Operations.OperationReport.jitterString
MitreCaldera.Operations.OperationReport.plannerString
MitreCaldera.Operations.OperationReport.finishString
MitreCaldera.Operations.OperationReport.adversaryUnknown
MitreCaldera.Operations.OperationReport.skipped_abilitiesUnknown
MitreCaldera.Operations.OperationReport.objectivesUnknown

caldera-replace-ability#


Replaces an existing ability.

Base Command#

caldera-replace-ability

Input#

Argument NameDescriptionRequired
ability_idUUID of the Ability to be retrieved.Required
ability_name.Optional
ability_buckets.Optional
ability_technique_id.Optional
ability_delete_payload.Optional
ability_executors.Optional
ability_privilege.Optional
ability_requirements.Optional
ability_plugin.Optional
ability_access.Optional
ability_tactic.Optional
ability_additional_info.Optional
ability_singleton.Optional
ability_technique_name.Optional
ability_repeatable.Optional
ability_description.Optional

Context Output#

PathTypeDescription
MitreCaldera.Abilities.idString
MitreCaldera.Abilities.nameString
MitreCaldera.Abilities.technique_idString
MitreCaldera.Abilities.delete_payloadBoolean
MitreCaldera.Abilities.executors.nameString
MitreCaldera.Abilities.executors.platformString
MitreCaldera.Abilities.executors.languageString
MitreCaldera.Abilities.executors.variations.commandString
MitreCaldera.Abilities.executors.variations.descriptionString
MitreCaldera.Abilities.executors.build_targetString
MitreCaldera.Abilities.executors.timeoutNumber
MitreCaldera.Abilities.executors.parsers.moduleString
MitreCaldera.Abilities.executors.parsers.parserconfigs.edgeString
MitreCaldera.Abilities.executors.parsers.parserconfigs.sourceString
MitreCaldera.Abilities.executors.parsers.parserconfigs.targetString
MitreCaldera.Abilities.executors.commandString
MitreCaldera.Abilities.executors.codeString
MitreCaldera.Abilities.privilegeString
MitreCaldera.Abilities.requirements.moduleString
MitreCaldera.Abilities.pluginString
MitreCaldera.Abilities.tacticString
MitreCaldera.Abilities.singletonBoolean
MitreCaldera.Abilities.technique_nameString
MitreCaldera.Abilities.repeatableBoolean
MitreCaldera.Abilities.descriptionString

caldera-replace-schedule#


Replace Schedule

Base Command#

caldera-replace-schedule

Input#

Argument NameDescriptionRequired
schedule_idUUID of the Schedule to be replaced.Required
partial_schedule_schedule.Optional
partial_schedule_task_namepartial_schedule_task name.Optional
partial_schedule_task_autonomouspartial_schedule_task autonomous.Optional
partial_schedule_task_idpartial_schedule_task id.Optional
partial_schedule_task_objectivepartial_schedule_task objective.Optional
partial_schedule_task_visibilitypartial_schedule_task visibility.Optional
partial_schedule_task_statepartial_schedule_task state.Optional
partial_schedule_task_grouppartial_schedule_task group.Optional
partial_schedule_task_host_grouppartial_schedule_task host_group.Optional
partial_schedule_task_plannerpartial_schedule_task planner.Optional
partial_schedule_task_obfuscatorpartial_schedule_task obfuscator.Optional
partial_schedule_task_chainpartial_schedule_task chain.Optional
partial_schedule_task_use_learning_parserspartial_schedule_task use_learning_parsers.Optional
partial_schedule_task_sourcepartial_schedule_task source.Optional
partial_schedule_task_jitterpartial_schedule_task jitter.Optional
partial_schedule_task_startpartial_schedule_task start.Optional
partial_schedule_task_adversarypartial_schedule_task adversary.Optional
partial_schedule_task_auto_closepartial_schedule_task auto_close.Optional

Context Output#

PathTypeDescription
MitreCaldera.Schedules.scheduleString
MitreCaldera.Schedules.idString

caldera-update-agent-config#


Update Agent Config

Base Command#

caldera-update-agent-config

Input#

Argument NameDescriptionRequired
watchdog.Optional
sleep_min.Optional
deployments.Optional
deadman_abilities.Optional
untrusted_timer.Optional
bootstrap_abilities.Optional
sleep_max.Optional
implant_name.Optional

Context Output#

PathTypeDescription
MitreCaldera.AgentConfig.watchdogNumber
MitreCaldera.AgentConfig.sleep_minNumber
MitreCaldera.AgentConfig.untrusted_timerNumber
MitreCaldera.AgentConfig.sleep_maxNumber
MitreCaldera.AgentConfig.implant_nameString

caldera-update-adversary#


Update an adversary

Base Command#

caldera-update-adversary

Input#

Argument NameDescriptionRequired
adversary_idUUID of the adversary to be updated.Required
adversaryname.Optional
adversarytags.Optional
adversaryobjective.Optional
adversaryhas_repeatable_abilities.Optional
adversaryatomic_ordering.Optional
adversaryplugin.Optional
adversarydescription.Optional

Context Output#

PathTypeDescription
MitreCaldera.Adversaries.nameString
MitreCaldera.Adversaries.objectiveString
MitreCaldera.Adversaries.adversary_idString
MitreCaldera.Adversaries.has_repeatable_abilitiesBoolean
MitreCaldera.Adversaries.pluginString
MitreCaldera.Adversaries.descriptionString

caldera-update-agent#


Update an Agent

Base Command#

caldera-update-agent

Input#

Argument NameDescriptionRequired
pawID of the Agent to update.Required
watchdog.Optional
sleep_min.Optional
trusted.Optional
sleep_max.Optional
pending_contact.Optional
group.Optional

Context Output#

PathTypeDescription
MitreCaldera.Agents.watchdogNumber
MitreCaldera.Agents.links.relationships.uniqueString
MitreCaldera.Agents.links.relationships.originString
MitreCaldera.Agents.links.relationships.edgeString
MitreCaldera.Agents.links.relationships.scoreNumber
MitreCaldera.Agents.links.idString
MitreCaldera.Agents.links.collectString
MitreCaldera.Agents.links.pidString
MitreCaldera.Agents.links.finishString
MitreCaldera.Agents.links.pinNumber
MitreCaldera.Agents.links.jitterNumber
MitreCaldera.Agents.links.agent_reported_timeString
MitreCaldera.Agents.links.deadmanBoolean
MitreCaldera.Agents.links.used.uniqueString
MitreCaldera.Agents.links.used.nameString
MitreCaldera.Agents.links.used.createdString
MitreCaldera.Agents.links.used.limit_countNumber
MitreCaldera.Agents.links.used.technique_idString
MitreCaldera.Agents.links.used.traitString
MitreCaldera.Agents.links.used.sourceString
MitreCaldera.Agents.links.used.scoreNumber
MitreCaldera.Agents.links.hostString
MitreCaldera.Agents.links.statusNumber
MitreCaldera.Agents.links.scoreNumber
MitreCaldera.Agents.links.commandString
MitreCaldera.Agents.links.uniqueString
MitreCaldera.Agents.links.cleanupNumber
MitreCaldera.Agents.links.decideString
MitreCaldera.Agents.links.facts.uniqueString
MitreCaldera.Agents.links.facts.nameString
MitreCaldera.Agents.links.facts.createdString
MitreCaldera.Agents.links.facts.limit_countNumber
MitreCaldera.Agents.links.facts.technique_idString
MitreCaldera.Agents.links.facts.traitString
MitreCaldera.Agents.links.facts.sourceString
MitreCaldera.Agents.links.facts.scoreNumber
MitreCaldera.Agents.links.pawString
MitreCaldera.Agents.links.outputString
MitreCaldera.Agents.deadman_enabledBoolean
MitreCaldera.Agents.ppidNumber
MitreCaldera.Agents.pidNumber
MitreCaldera.Agents.createdString
MitreCaldera.Agents.origin_link_idString
MitreCaldera.Agents.last_seenString
MitreCaldera.Agents.platformString
MitreCaldera.Agents.pending_contactString
MitreCaldera.Agents.hostString
MitreCaldera.Agents.groupString
MitreCaldera.Agents.locationString
MitreCaldera.Agents.display_nameString
MitreCaldera.Agents.upstream_destString
MitreCaldera.Agents.sleep_maxNumber
MitreCaldera.Agents.architectureString
MitreCaldera.Agents.sleep_minNumber
MitreCaldera.Agents.serverString
MitreCaldera.Agents.contactString
MitreCaldera.Agents.privilegeString
MitreCaldera.Agents.usernameString
MitreCaldera.Agents.trustedBoolean
MitreCaldera.Agents.proxy_chainString
MitreCaldera.Agents.pawString
MitreCaldera.Agents.exe_nameString

caldera-update-fact-source#


Update an existing Fact Source.

Base Command#

caldera-update-fact-source

Input#

Argument NameDescriptionRequired
fact_source_idThe id of the Fact Source.Required
source_name.Optional
source_adjustments.Optional
source_relationships.Optional
source_id.Optional
source_rules.Optional
source_facts.Optional
source_plugin.Optional

Context Output#

PathTypeDescription
MitreCaldera.Sources.nameString
MitreCaldera.Sources.adjustments.ability_idString
MitreCaldera.Sources.adjustments.offsetNumber
MitreCaldera.Sources.adjustments.traitString
MitreCaldera.Sources.adjustments.valueString
MitreCaldera.Sources.relationships.uniqueString
MitreCaldera.Sources.relationships.originString
MitreCaldera.Sources.relationships.edgeString
MitreCaldera.Sources.relationships.scoreNumber
MitreCaldera.Sources.idString
MitreCaldera.Sources.rules.traitString
MitreCaldera.Sources.rules.matchString
MitreCaldera.Sources.facts.uniqueString
MitreCaldera.Sources.facts.nameString
MitreCaldera.Sources.facts.createdString
MitreCaldera.Sources.facts.limit_countNumber
MitreCaldera.Sources.facts.technique_idString
MitreCaldera.Sources.facts.traitString
MitreCaldera.Sources.facts.sourceString
MitreCaldera.Sources.facts.scoreNumber
MitreCaldera.Sources.pluginString

caldera-update-objective#


Update an objective

Base Command#

caldera-update-objective

Input#

Argument NameDescriptionRequired
objective_idUUID of the Objective to be updated.Required
name.Optional
goals.Optional
description.Optional

Context Output#

PathTypeDescription
MitreCaldera.Objectives.nameString
MitreCaldera.Objectives.idString
MitreCaldera.Objectives.percentageUnknown
MitreCaldera.Objectives.goals.countNumber
MitreCaldera.Objectives.goals.achievedBoolean
MitreCaldera.Objectives.goals.operatorString
MitreCaldera.Objectives.goals.valueString
MitreCaldera.Objectives.goals.targetString
MitreCaldera.Objectives.descriptionString

caldera-update-operation-fields#


Update fields within an operation

Base Command#

caldera-update-operation-fields

Input#

Argument NameDescriptionRequired
operation_idUUID of the Operation object to be retrieved.Required
obfuscator.Optional
autonomous.Optional
state.Optional

Context Output#

PathTypeDescription
MitreCaldera.Operations.nameString
MitreCaldera.Operations.autonomousNumber
MitreCaldera.Operations.idString
MitreCaldera.Operations.visibilityNumber
MitreCaldera.Operations.stateString
MitreCaldera.Operations.groupString
MitreCaldera.Operations.host_group.watchdogNumber
MitreCaldera.Operations.host_group.links.relationships.uniqueString
MitreCaldera.Operations.host_group.links.relationships.originString
MitreCaldera.Operations.host_group.links.relationships.edgeString
MitreCaldera.Operations.host_group.links.relationships.scoreNumber
MitreCaldera.Operations.host_group.links.idString
MitreCaldera.Operations.host_group.links.collectString
MitreCaldera.Operations.host_group.links.pidString
MitreCaldera.Operations.host_group.links.finishString
MitreCaldera.Operations.host_group.links.pinNumber
MitreCaldera.Operations.host_group.links.jitterNumber
MitreCaldera.Operations.host_group.links.agent_reported_timeString
MitreCaldera.Operations.host_group.links.deadmanBoolean
MitreCaldera.Operations.host_group.links.used.uniqueString
MitreCaldera.Operations.host_group.links.used.nameString
MitreCaldera.Operations.host_group.links.used.createdString
MitreCaldera.Operations.host_group.links.used.limit_countNumber
MitreCaldera.Operations.host_group.links.used.technique_idString
MitreCaldera.Operations.host_group.links.used.traitString
MitreCaldera.Operations.host_group.links.used.sourceString
MitreCaldera.Operations.host_group.links.used.scoreNumber
MitreCaldera.Operations.host_group.links.hostString
MitreCaldera.Operations.host_group.links.statusNumber
MitreCaldera.Operations.host_group.links.scoreNumber
MitreCaldera.Operations.host_group.links.commandString
MitreCaldera.Operations.host_group.links.uniqueString
MitreCaldera.Operations.host_group.links.cleanupNumber
MitreCaldera.Operations.host_group.links.decideString
MitreCaldera.Operations.host_group.links.facts.uniqueString
MitreCaldera.Operations.host_group.links.facts.nameString
MitreCaldera.Operations.host_group.links.facts.createdString
MitreCaldera.Operations.host_group.links.facts.limit_countNumber
MitreCaldera.Operations.host_group.links.facts.technique_idString
MitreCaldera.Operations.host_group.links.facts.traitString
MitreCaldera.Operations.host_group.links.facts.sourceString
MitreCaldera.Operations.host_group.links.facts.scoreNumber
MitreCaldera.Operations.host_group.links.pawString
MitreCaldera.Operations.host_group.links.outputString
MitreCaldera.Operations.host_group.deadman_enabledBoolean
MitreCaldera.Operations.host_group.ppidNumber
MitreCaldera.Operations.host_group.pidNumber
MitreCaldera.Operations.host_group.createdString
MitreCaldera.Operations.host_group.origin_link_idString
MitreCaldera.Operations.host_group.last_seenString
MitreCaldera.Operations.host_group.platformString
MitreCaldera.Operations.host_group.pending_contactString
MitreCaldera.Operations.host_group.hostString
MitreCaldera.Operations.host_group.groupString
MitreCaldera.Operations.host_group.locationString
MitreCaldera.Operations.host_group.display_nameString
MitreCaldera.Operations.host_group.upstream_destString
MitreCaldera.Operations.host_group.sleep_maxNumber
MitreCaldera.Operations.host_group.architectureString
MitreCaldera.Operations.host_group.sleep_minNumber
MitreCaldera.Operations.host_group.serverString
MitreCaldera.Operations.host_group.contactString
MitreCaldera.Operations.host_group.privilegeString
MitreCaldera.Operations.host_group.usernameString
MitreCaldera.Operations.host_group.trustedBoolean
MitreCaldera.Operations.host_group.proxy_chainString
MitreCaldera.Operations.host_group.pawString
MitreCaldera.Operations.host_group.exe_nameString
MitreCaldera.Operations.obfuscatorString
MitreCaldera.Operations.use_learning_parsersBoolean
MitreCaldera.Operations.jitterString
MitreCaldera.Operations.startString
MitreCaldera.Operations.auto_closeBoolean

caldera-update-main-config#


Update Main Config

Base Command#

caldera-update-main-config

Input#

Argument NameDescriptionRequired
property.Required
value.Required

Context Output#

There is no context output for this command.

caldera-update-facts#


Update One or More Facts

Base Command#

caldera-update-facts

Input#

Argument NameDescriptionRequired
uniquepartial_factupdaterequest_updates unique.Optional
namepartial_factupdaterequest_updates name.Optional
linkspartial_factupdaterequest_updates links.Optional
relationshipspartial_factupdaterequest_updates relationships.Optional
origin_typepartial_factupdaterequest_updates origin_type.Optional
createdpartial_factupdaterequest_updates created.Optional
limit_countpartial_factupdaterequest_updates limit_count.Optional
technique_idpartial_factupdaterequest_updates technique_id.Optional
traitpartial_factupdaterequest_updates trait.Optional
sourcepartial_factupdaterequest_updates source.Optional
scorepartial_factupdaterequest_updates score.Optional
valuepartial_factupdaterequest_updates value.Optional
collected_bypartial_factupdaterequest_updates collected_by.Optional
criteria_uniquepartial_factupdaterequest_criteria unique.Optional
criteria_namepartial_factupdaterequest_criteria name.Optional
criteria_linkspartial_factupdaterequest_criteria links.Optional
criteria_relationshipspartial_factupdaterequest_criteria relationships.Optional
criteria_origin_typepartial_factupdaterequest_criteria origin_type.Optional
criteria_createdpartial_factupdaterequest_criteria created.Optional
criteria_limit_countpartial_factupdaterequest_criteria limit_count.Optional
criteria_technique_idpartial_factupdaterequest_criteria technique_id.Optional
criteria_traitpartial_factupdaterequest_criteria trait.Optional
criteria_sourcepartial_factupdaterequest_criteria source.Optional
criteria_scorepartial_factupdaterequest_criteria score.Optional
criteria_valuepartial_factupdaterequest_criteria value.Optional
criteria_collected_bypartial_factupdaterequest_criteria collected_by.Optional

Context Output#

PathTypeDescription
MitreCaldera.Facts.uniqueString
MitreCaldera.Facts.nameString
MitreCaldera.Facts.createdString
MitreCaldera.Facts.limit_countNumber
MitreCaldera.Facts.technique_idString
MitreCaldera.Facts.traitString
MitreCaldera.Facts.sourceString
MitreCaldera.Facts.scoreNumber

caldera-update-relationships#


Update One or More Relationships

Base Command#

caldera-update-relationships

Input#

Argument NameDescriptionRequired
uniquepartial_relationshipupdate_updates unique.Optional
originpartial_relationshipupdate_updates origin.Optional
edgepartial_relationshipupdate_updates edge.Optional
sourcepartial_relationshipupdate_updates source.Optional
scorepartial_relationshipupdate_updates score.Optional
targetpartial_relationshipupdate_updates target.Optional
criteria_uniquepartial_relationshipupdate_criteria unique.Optional
criteria_originpartial_relationshipupdate_criteria origin.Optional
criteria_edgepartial_relationshipupdate_criteria edge.Optional
criteria_sourcepartial_relationshipupdate_criteria source.Optional
criteria_scorepartial_relationshipupdate_criteria score.Optional
criteria_targetpartial_relationshipupdate_criteria target.Optional

Context Output#

PathTypeDescription
MitreCaldera.Relationships.uniqueString
MitreCaldera.Relationships.originString
MitreCaldera.Relationships.edgeString
MitreCaldera.Relationships.scoreNumber

caldera-update-ability#


Updates an existing ability.

Base Command#

caldera-update-ability

Input#

Argument NameDescriptionRequired
ability_idUUID of the Ability to be retrieved.Required
name.Optional
buckets.Optional
technique_id.Optional
delete_payload.Optional
executors.Optional
privilege.Optional
technique_name.Optional
tactic.Optional
singleton.Optional
plugin.Optional
repeatable.Optional
description.Optional

Context Output#

PathTypeDescription
MitreCaldera.Abilities.ability_idString
MitreCaldera.Abilities.nameString
MitreCaldera.Abilities.technique_idString
MitreCaldera.Abilities.delete_payloadBoolean
MitreCaldera.Abilities.executors.nameString
MitreCaldera.Abilities.executors.platformString
MitreCaldera.Abilities.executors.languageString
MitreCaldera.Abilities.executors.variations.commandString
MitreCaldera.Abilities.executors.variations.descriptionString
MitreCaldera.Abilities.executors.build_targetString
MitreCaldera.Abilities.executors.timeoutNumber
MitreCaldera.Abilities.executors.parsers.moduleString
MitreCaldera.Abilities.executors.parsers.parserconfigs.edgeString
MitreCaldera.Abilities.executors.parsers.parserconfigs.sourceString
MitreCaldera.Abilities.executors.parsers.parserconfigs.targetString
MitreCaldera.Abilities.executors.commandString
MitreCaldera.Abilities.executors.codeString
MitreCaldera.Abilities.privilegeString
MitreCaldera.Abilities.requirements.moduleString
MitreCaldera.Abilities.pluginString
MitreCaldera.Abilities.tacticString
MitreCaldera.Abilities.singletonBoolean
MitreCaldera.Abilities.technique_nameString
MitreCaldera.Abilities.repeatableBoolean
MitreCaldera.Abilities.descriptionString

caldera-update-schedule#


Update Schedule

Base Command#

caldera-update-schedule

Input#

Argument NameDescriptionRequired
schedule_idUUID of the Schedule to be updated.Required
schedule.Optional
task_obfuscatortask obfuscator.Optional
task_autonomoustask autonomous.Optional
task_statetask state.Optional

Context Output#

PathTypeDescription
MitreCaldera.Schedules.scheduleString
MitreCaldera.Schedules.idString

caldera-update-operation-link#


Update the specified link within an operation

Base Command#

caldera-update-operation-link

Input#

Argument NameDescriptionRequired
operation_idString UUID of the Operation containing desired link.Required
link_idString UUID of the Link with the above operation.Required
command.Optional
status.Optional

Context Output#

PathTypeDescription
MitreCaldera.Links.relationships.uniqueString
MitreCaldera.Links.relationships.originString
MitreCaldera.Links.relationships.edgeString
MitreCaldera.Links.relationships.scoreNumber
MitreCaldera.Links.idString
MitreCaldera.Links.collectString
MitreCaldera.Links.pidString
MitreCaldera.Links.finishString
MitreCaldera.Links.pinNumber
MitreCaldera.Links.jitterNumber
MitreCaldera.Links.agent_reported_timeString
MitreCaldera.Links.deadmanBoolean
MitreCaldera.Links.used.uniqueString
MitreCaldera.Links.used.nameString
MitreCaldera.Links.used.createdString
MitreCaldera.Links.used.limit_countNumber
MitreCaldera.Links.used.technique_idString
MitreCaldera.Links.used.traitString
MitreCaldera.Links.used.sourceString
MitreCaldera.Links.used.scoreNumber
MitreCaldera.Links.hostString
MitreCaldera.Links.statusNumber
MitreCaldera.Links.scoreNumber
MitreCaldera.Links.commandString
MitreCaldera.Links.uniqueString
MitreCaldera.Links.cleanupNumber
MitreCaldera.Links.decideString
MitreCaldera.Links.facts.uniqueString
MitreCaldera.Links.facts.nameString
MitreCaldera.Links.facts.createdString
MitreCaldera.Links.facts.limit_countNumber
MitreCaldera.Links.facts.technique_idString
MitreCaldera.Links.facts.traitString
MitreCaldera.Links.facts.sourceString
MitreCaldera.Links.facts.scoreNumber
MitreCaldera.Links.pawString
MitreCaldera.Links.outputString