0.0
No commit activity in last 3 years
No release in over 3 years
A Lita handler for viewing alertlogic resources.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 4.0
 Project Readme

lita-alertlogic

Build Status MIT License RubyGems :: RMuh Gem Version Code Climate

lita-alertlogic is a handler for Lita. It can be used to pull various data points about Alert Logic customers directly from Hipchat.

Installation

Add lita-alertlogic to your Lita instance's Gemfile:

gem 'lita-alertlogic'

Usage

Run 'lita help alertlogic' to get detailed usage:

 [You] lita help alertlogic
[Lita Bot] 
Lita: alertlogic customerinfo <customer_id or customer_name> - Displays customer and child list.
Lita: alertlogic appliance agent counts <customer_id> - Displays count of agents assigned to each appliance
Lita: alertlogic policies agent counts <customer_id> - Displays count of agents assigned to each policy
Lita: alertlogic agent ip counts <customer_id> - Display count of IP's assigned to agents
Lita: alertlogic lm appliances <customer_id> - Displays customer LM appliance list.
Lita: alertlogic lm applianceinfo <customer_id> <applaince_uuid> - Displays LM appliance details.
Lita: alertlogic lm policies <customer_id> - Displays customer log assignment policies.
Lita: alertlogic lm sources <customer_id> - Displays customer log sources.
Lita: alertlogic lm hosts <customer_id> - Displays customer log hosts.
Lita: alertlogic tm appliances <customer_id> - Displays customer TM appliance list.
Lita: alertlogic tm applianceinfo <customer_id> <applaince_uuid> - Displays TM appliance details.
Lita: alertlogic tm policies <customer_id> - Displays customer threat assignment policies.
Lita: alertlogic tm hosts <customer_id> - Displays customer threat hosts hosts.
Lita: alertlogic protectedhosts status <customer_id> - Displays protected hosts summary.
Lita: alertlogic protectedhosts list <customer_id> - Displays complete protected hosts lists.
Lita: alertlogic protectedhosts search <customer_id> <protected host name or uuid>- Search protected hosts by name or uuid.

Example:

 [You] lita alertlogic customerinfo Alert
[Lita Bot]
Information for parent customer: Alert Logic Inc.
Customer ID |  Customer Name 
------------+----------------
XXXXX       | Alert Logic 

Config

Lita.configure do |config|
  # Alert Logic API Settings
  config.handlers.alertlogic.customer_id = 'your-alertlogic-customer-id'
  config.handlers.alertlogic.api_auth = 'your-api-key-obtained-from-alert-logic:'
  config.handlers.alertlogic.lm_api_url = 'https://publicapi.alertlogic.net/api/lm/v1'
  config.handlers.alertlogic.tm_api_url = 'https://publicapi.alertlogic.net/api/tm/v1'
  config.handlers.alertlogic.customer_api_url = 'https://api.alertlogic.net/api/customer/v1'
  config.handlers.alertlogic.monitoring_api_url = 'https://api.alertlogic.net/api/monitoring/v1'
  config.handlers.alertlogic.incident_api_url = 'https://api.alertlogic.net/api/incident'
end

Sample config with Hipchat plugin

Lita.configure do |config|
  # Logging level
  config.robot.log_level = :info
  
  # Hipchat adapter
  config.robot.adapter = :hipchat
  
  # Bot name
  config.robot.name = "Lita Bot"

  # Bot admins Type: String or Array of Jabber ID(s)
  config.robot.admins = ['some_jabber_id@chat.hipchat.com']
  config.adapters.hipchat.jid = 'bots-hipchat-jabber-id@chat.hipchat.com'
  config.adapters.hipchat.password = 'bots-password'

  # Hipchat room(s) Type: String or Array
  config.adapters.hipchat.rooms = :all
  
  # Debugging mode
  #config.adapters.hipchat.debug = false

  # Alert Logic Settings
  config.handlers.alertlogic.customer_id = 'your-alertlogic-customer-id'
  config.handlers.alertlogic.api_auth = 'your-api-key-obtained-from-alert-logic:'
  config.handlers.alertlogic.lm_api_url = 'https://publicapi.alertlogic.net/api/lm/v1'
  config.handlers.alertlogic.tm_api_url = 'https://publicapi.alertlogic.net/api/tm/v1'
  config.handlers.alertlogic.customer_api_url = 'https://api.alertlogic.net/api/customer/v1'
  config.handlers.alertlogic.monitoring_api_url = 'https://api.alertlogic.net/api/monitoring/v1'
  config.handlers.alertlogic.incident_api_url = 'https://api.alertlogic.net/api/incident'
end

License

MIT