logstash-input-okta_enterprise 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ce6c6e85bc6e41ec22d49a462c890c236cd849d9
-  data.tar.gz: 35076593da897161c67f167c7e69c6cc7086bac3
+  metadata.gz: 708e0a1e3ec39df8e00c9a2ff2f69252d5c81a01
+  data.tar.gz: 98853df25b862caa6e2495fdcdaec72501b7dc8b
 SHA512:
-  metadata.gz: c66d8cd501e49cef03cc7c2f4f0c48983717a420cecd8e0265a81f605c27a2026703192d2c61605de6b044d08f58d26366e920d194f63ef8b9386bd416978a2b
-  data.tar.gz: ed20984c1ffad649c57e46b694234c3ccf77c53423240a61b7b8185bc12cbf53d6aab1e1a20ff4553535860cf8386baba68b4abf9157537e2f1eec6b216ed8c3
+  metadata.gz: 1864cc1d245aa02145ded297b30ba724fb746c029f2a8ed0e050173b227564887c19cf6fc0c169b45510fe5488221e8abdd8e682b0676bde56d8ef6c8a3f6356
+  data.tar.gz: 4243c10ec44ef47a7d42af1050ea17f861ebc3e7e3d346bfa830c52ab2a26a546e02375dff9748cc5b4d5abd6c563f0778159af24c440d49834093a66fe8c662

data/CHANGELOG.md

@@ -1,2 +1,4 @@
+## 0.6.1
+  - Added deprecation notice
 ## 0.1.0
   - Plugin created

data/README.md

@@ -1,3 +1,9 @@
+## Migration Notice
+
+This plugin in deprecated. For new implementations, please use [okta_system_log](https://github.com/SecurityRiskAdvisors/logstash-input-okta_system_log) instead.
+
+You can find more information in the [migration documentation](docs/Migration.md).
+
 # Logstash Plugin
 
 This is a plugin for [Logstash](https://github.com/elastic/logstash).

data/docs/Migration.md

@@ -0,0 +1,23 @@
+## Okta migration to System Log API
+
+Okta is currently migrating away from the Events API and instead to their System Log API, which provides more information.
+Migration information can be found on the [migration website](https://developer.okta.com/use_cases/events-api-migration/).
+
+As such, this plugin will be deprecated and in favor of the [okta_system_log](https://github.com/SecurityRiskAdvisors/logstash-input-okta_system_log) plugin.
+
+You will have to set `accept_deprecation_notice` to true in order to continue using this plugin, understanding that the Events API is deprecated.
+```ruby
+input {
+  okta_enterprise {
+        url => "..."
+        chunk_size  => 1000
+        accept_deprecation_notice => true
+        ...snip...
+  }
+
+}
+
+output {
+  ...snip...
+}
+```

data/lib/logstash/inputs/okta_enterprise.rb

@@ -177,10 +177,25 @@ class LogStash::Inputs::OktaEnterprise < LogStash::Inputs::Base
   # Format: Integer
   config :log_throttle, :validate => :number, :required => false
 
+  # Force a user to agree to the deprecation notice.# 
+  # Deprecation info can be found here: 
+  # https://github.com/SecurityRiskAdvisors/logstash-input-okta_enterprise/blob/master/docs/Migration.md
+  #
+  # Format: Boolean
+  config :accept_deprecation_notice, :validate => :boolean, :default => false
+
   public
   Schedule_types = %w(cron every at in)
   def register
 
+    unless (@accept_deprecation_notice)
+      msg = "The Okta Events API (and this plugin) have been deprecated. For more info: " +
+      "https://github.com/SecurityRiskAdvisors/logstash-input-okta_enterprise/blob/master/docs/Migration.md. " + 
+      "Instructions to proceed can be found there."
+      @logger.fatal(msg)
+      raise LogStash::ConfigurationError, msg
+    end
+
     if (@auth_token_env and @auth_token_file)
       raise LogStash::ConfigurationError, "auth_token_file and auth_token_env" +
       "cannot be set. Please select one for use."

data/logstash-input-okta_enterprise.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name          = 'logstash-input-okta_enterprise'
-  s.version       = '0.6.0'
+  s.version       = '0.6.1'
   s.licenses      = ['Apache License (2.0)']
   s.summary       = 'This plugin fetches log events from Okta'
   s.description   = 'This plugin fetches log events from Okta'

data/spec/inputs/okta_enterprise_spec.rb

@@ -22,6 +22,7 @@ describe LogStash::Inputs::OktaEnterprise do
       "url" => default_url,
       "auth_token_env" => default_auth_token_env,
       "metadata_target" => metadata_target,
+      "accept_deprecation_notice" => true,
       "codec" => "json"
     }
   }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: logstash-input-okta_enterprise
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Security Risk Advisors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-11-17 00:00:00.000000000 Z
+date: 2019-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -202,6 +202,7 @@ files:
 - Gemfile
 - LICENSE
 - README.md
+- docs/Migration.md
 - lib/logstash/inputs/okta_enterprise.rb
 - logstash-input-okta_enterprise.gemspec
 - spec/inputs/okta_enterprise_spec.rb