InsightConnect Marketplace

Timers

Back to Marketplace

Timers

v2.0.4

Timers allows Rapid7 InsightConnect users to trigger workflows on various time intervals

Tags: timer, time, cron

Triggers
  • Daily
  • Hourly
  • Monthly
  • Every X Minutes
  • Weekly

Actions
  • Delay

Description

The Timers plugin is an implementation of crond functionality. Using this plugin, users can schedule events to be triggered on a time interval, such as periodic network scans.

Key Features

  • Trigger workflows on various time intervals

Requirements

This plugin does not contain any requirements.

Documentation

Setup

This plugin does not contain a connection.

Technical Details

Actions

Delay

This action delays the workflow by a variable number of seconds.

Input
Name Type Default Required Description Enum
delay float None True How long to delay the workflow (in seconds) None
Output

This action does not contain any outputs.

Triggers

Daily

This trigger is used to trigger events daily.

Input
Name Type Default Required Description Enum
message string None False The message to send (optional) None
times_in_utc string None True A comma-separated list of UTC times when you want the trigger to occur, e.g. 15:04,01:00,5:00 None
Output
Name Type Required Description
message string False Message
time string False Time

Example output:

{
  "message": "The timer went off!",
  "time": "2019-01-01 00:00:00"
}

Hourly

This trigger is used to trigger events hourly.

Input
Name Type Default Required Description Enum
message string None False The message to send (optional) None
minute integer None True The minute after the hour to trigger the workflow None
Output
Name Type Required Description
message string False Message
time string False Time

Example output:

{
  "message": "The timer went off!",
  "time": "2019-01-01 00:00:00"
}

Monthly

This trigger is used to trigger events monthly.

Input
Name Type Default Required Description Enum
day_of_month integer None True Names of the days that you want the trigger None
message string None False The message to send (optional) None
times_in_utc string 00:00 False UTC times on the day you want the trigger to occur None
Output
Name Type Required Description
message string False Message
time string False Time

Example output:

{
  "message": "The timer went off!",
  "time": "2019-01-01 00:00:00"
}

Every X Minutes

This trigger is used to trigger an event periodically.

Input
Name Type Default Required Description Enum
message string None False A message to send with the event None
period float 60 True Minutes between events None
Output
Name Type Required Description
message string True Message
time date True Time

Example output:

{
  "message": "The timer went off!",
  "time": "2019-01-01 00:00:00"
}

Weekly

This trigger is used to trigger events weekly.

Input
Name Type Default Required Description Enum
day string None True Names of the day that you want the trigger to run None
message string None False The message to send (optional) None
times_in_utc string None True A comma-separated list of UTC times on those days when you want the trigger to occur None
Output
Name Type Required Description
message string False Message
time string False Time

Example output:

{
  "message": "The timer went off!",
  "time": "2019-01-01 00:00:00"
}

Custom Output Types

This plugin does not contain any custom output types.

Troubleshooting

This plugin does not contain any troubleshooting information.

Version History

  • 2.0.4 - Fixed issue where daily triggers would sometimes activate multiple times, fixed issue where plugin would sometimes shutdown
  • 2.0.3 - New spec and help.md format for the Hub
  • 2.0.2 - Regenerate with latest go SDK to solve bug with triggers
  • 2.0.1 - Regenerate with latest go SDK to solve bug with actions
  • 2.0.0 - Reimplement periodic trigger | Rewrite weekly trigger | Fix double pointer bug in all triggers
  • 1.1.0 - Support web server mode | Update to v2 Go architecture
  • 1.0.0 - Initial plugin

Links

References

plugin_spec_version: v2
extension: plugin
products: ["insightconnect"]
name: timers
title: Timers
description: Timers allows Rapid7 InsightConnect users to trigger workflows on various time intervals
version: 2.0.4
vendor: rapid7
support: rapid7
status: []
resources:
  vendor_url: https://www.rapid7.com/
tags:
- timer
- time
- cron
hub_tags:
  use_cases: [data_utility]
  keywords: [timer, time, cron]
  features: []
actions:
  delay:
    title: Delay
    description: Delays the workflow by a variable number of seconds
    input:
      delay:
        title: Delay
        type: float
        description: How long to delay the workflow (in seconds)
        required: true
    output: null
triggers:
  periodic:
    title: Every X Minutes
    description: Trigger an event periodically
    input:
      period:
        title: Period
        type: float
        description: Minutes between events
        default: 60
        required: true
      message:
        title: Message
        type: string
        description: A message to send with the event
        required: false
    output:
      message:
        type: string
        title: Message
        description: Message
        required: true
      time:
        type: date
        title: Time
        description: Time
        required: true
  hourly:
    title: Hourly
    description: Trigger events hourly
    input:
      minute:
        type: integer
        description: The minute after the hour to trigger the workflow
        title: Minute
        required: true
      message:
        type: string
        description: The message to send (optional)
        title: Message
        required: false
    output:
      message:
        type: string
        description: Message
        title: Message
        required: false
      time:
        type: string
        description: Time
        title: Time
        required: false
  daily:
    title: Daily
    description: Trigger events daily
    input:
      times_in_utc:
        type: string
        description: A comma-separated list of UTC times when you want the trigger
          to occur, e.g. 15:04,01:00,5:00
        title: Time in UTC
        required: true
      message:
        type: string
        description: The message to send (optional)
        required: false
        title: Message
    output:
      message:
        type: string
        description: Message
        required: false
        title: Message
      time:
        type: string
        description: Time
        required: false
        title: Time
  weekly:
    title: Weekly
    description: Trigger events weekly
    input:
      day:
        type: string
        description: Names of the day that you want the trigger to run
        title: Day
        required: true
      times_in_utc:
        type: string
        description: A comma-separated list of UTC times on those days when you want
          the trigger to occur
        required: true
        title: Time in UTC
      message:
        type: string
        description: The message to send (optional)
        required: false
        title: Message
    output:
      message:
        type: string
        description: Message
        required: false
        title: Message
      time:
        type: string
        description: Time
        required: false
        title: Time
  monthly:
    title: Monthly
    description: Trigger events monthly
    input:
      day_of_month:
        title: Day of Month
        type: integer
        description: Names of the days that you want the trigger
        required: true
      times_in_utc:
        type: string
        description: UTC times on the day you want the trigger to occur
        default: 00:00
        required: false
      message:
        title: Message
        type: string
        description: The message to send (optional)
        required: false
    output:
      message:
        type: string
        description: Message
        required: false
        title: Message
      time:
        type: string
        description: Time
        required: false
        title: Time
Other plugins
Okta
Rapid7   |   v3.3.0
Plugin
Get
Trend Micro Deep Security
Rapid7   |   v1.0.0
Plugin
Get
FreeIPA
Rapid7   |   v2.0.2
Plugin
Get
Bitbucket
Rapid7   |   v1.0.2
Plugin
Get
Chardet
Rapid7   |   v1.0.2
Plugin
Get