logstash-filter-panfinder 0.0.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/CHANGELOG.md +2 -0
- data/CONTRIBUTORS +10 -0
- data/DEVELOPER.md +91 -0
- data/Gemfile +11 -0
- data/LICENSE +202 -0
- data/NOTICE.TXT +5 -0
- data/README.md +98 -0
- data/lib/logstash/filters/panfinder.rb +107 -0
- data/logstash-filter-panfinder.gemspec +23 -0
- data/spec/filters/panfinder_spec.rb +175 -0
- data/spec/spec_helper.rb +2 -0
- metadata +88 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: '026826e70335a20a7b26beb8dd24d5cb140c2e13a65379de1b985de00ab8c6af'
|
4
|
+
data.tar.gz: 43d4e16dd316d64ca905e5382c2b1bc0c461b6b35e9fa8b4e53b6548294d7795
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: 2f1722a9066f6f5141f21d330d7619d37783c621ac158cf6ef2ab35d866e57b6d0c1048b551c029980ab2e522f327a4fce54a2be6ac534a23f0424aa23a1ad44
|
7
|
+
data.tar.gz: c9b3f56d54657a895bd7265660c4bb702266a2642cb399e2f391a6d827c5d265a6ca1a3fca30627e068628db9727e169c1df8f1113e56b01657cf3b5af0c4d45
|
data/CHANGELOG.md
ADDED
data/CONTRIBUTORS
ADDED
@@ -0,0 +1,10 @@
|
|
1
|
+
The following is a list of people who have contributed ideas, code, bug
|
2
|
+
reports, or in general have helped logstash along its way.
|
3
|
+
|
4
|
+
Contributors:
|
5
|
+
* Daniel Niecke
|
6
|
+
|
7
|
+
Note: If you've sent us patches, bug reports, or otherwise contributed to
|
8
|
+
Logstash, and you aren't on the list above and want to be, please let us know
|
9
|
+
and we'll make sure you're here. Contributions from folks like you are what make
|
10
|
+
open source awesome.
|
data/DEVELOPER.md
ADDED
@@ -0,0 +1,91 @@
|
|
1
|
+
# logstash-filter-panfinder
|
2
|
+
Panfinder filter plugin.
|
3
|
+
|
4
|
+
## Docker Dev Environment
|
5
|
+
|
6
|
+
This plugin is developed within a docker container but you could also install jruby directly on your machine or within another VM.
|
7
|
+
To run a docker container use the following command (maybe change the path to this repo):
|
8
|
+
|
9
|
+
```sh
|
10
|
+
docker build -t ruby_dev -f Dockerfile.dev .
|
11
|
+
docker run -it --name panfinder --rm -v $HOME/git/logstash-filter-panfinder:/logstash-filter-panfinder ruby_dev bash
|
12
|
+
```
|
13
|
+
|
14
|
+
Within the container execute the follwing command to set everything up:
|
15
|
+
|
16
|
+
```sh
|
17
|
+
cd /logstash-filter-panfinder && bundle install
|
18
|
+
```
|
19
|
+
|
20
|
+
## Testing
|
21
|
+
|
22
|
+
To execute all tests execute the following command:
|
23
|
+
|
24
|
+
```sh
|
25
|
+
bundle exec rspec
|
26
|
+
```
|
27
|
+
|
28
|
+
### Test in Logstash
|
29
|
+
|
30
|
+
Run a logstash container with
|
31
|
+
|
32
|
+
```sh
|
33
|
+
docker run -it -v $HOME/git/logstash-filter-panfinder:/logstash-filter-panfinder --rm --name logstash7 logstash:7.10.2 bash
|
34
|
+
```
|
35
|
+
|
36
|
+
And add a filter under /usr/share/logstash/pipeline/logstash.conf
|
37
|
+
|
38
|
+
```
|
39
|
+
input {
|
40
|
+
file {
|
41
|
+
path => "/tmp/logs"
|
42
|
+
start_position => "beginning"
|
43
|
+
}
|
44
|
+
}
|
45
|
+
|
46
|
+
filter {
|
47
|
+
panfinder { }
|
48
|
+
}
|
49
|
+
|
50
|
+
output {
|
51
|
+
file {
|
52
|
+
path => "/tmp/out"
|
53
|
+
}
|
54
|
+
}
|
55
|
+
```
|
56
|
+
|
57
|
+
Install the Plugin
|
58
|
+
|
59
|
+
```sh
|
60
|
+
bin/logstash-plugin install /logstash-filter-panfinder/logstash-filter-panfinder-0.0.1.gem
|
61
|
+
```
|
62
|
+
|
63
|
+
Run Logstash
|
64
|
+
|
65
|
+
```sh
|
66
|
+
bin/logstash
|
67
|
+
```
|
68
|
+
|
69
|
+
## Build
|
70
|
+
|
71
|
+
```sh
|
72
|
+
gem build logstash-filter-panfinder.gemspec
|
73
|
+
```
|
74
|
+
|
75
|
+
## Publish
|
76
|
+
|
77
|
+
Add rubygems to container
|
78
|
+
|
79
|
+
```sh
|
80
|
+
echo "---
|
81
|
+
:rubygems_api_key: rubygems_xxxx
|
82
|
+
:status: :ok" > /root/.gem/credentials
|
83
|
+
chmod 0600 ~/.gem/credentials
|
84
|
+
```
|
85
|
+
|
86
|
+
```sh
|
87
|
+
bundle install
|
88
|
+
bundle exec rake vendor
|
89
|
+
bundle exec rspec
|
90
|
+
bundle exec rake publish_gem
|
91
|
+
```
|
data/Gemfile
ADDED
@@ -0,0 +1,11 @@
|
|
1
|
+
source 'https://rubygems.org'
|
2
|
+
|
3
|
+
gemspec
|
4
|
+
|
5
|
+
logstash_path = ENV["LOGSTASH_PATH"] || "../../logstash"
|
6
|
+
use_logstash_source = ENV["LOGSTASH_SOURCE"] && ENV["LOGSTASH_SOURCE"].to_s == "1"
|
7
|
+
|
8
|
+
if Dir.exist?(logstash_path) && use_logstash_source
|
9
|
+
gem 'logstash-core', :path => "#{logstash_path}/logstash-core"
|
10
|
+
gem 'logstash-core-plugin-api', :path => "#{logstash_path}/logstash-core-plugin-api"
|
11
|
+
end
|
data/LICENSE
ADDED
@@ -0,0 +1,202 @@
|
|
1
|
+
|
2
|
+
Apache License
|
3
|
+
Version 2.0, January 2004
|
4
|
+
http://www.apache.org/licenses/
|
5
|
+
|
6
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
7
|
+
|
8
|
+
1. Definitions.
|
9
|
+
|
10
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
11
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
12
|
+
|
13
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
14
|
+
the copyright owner that is granting the License.
|
15
|
+
|
16
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
17
|
+
other entities that control, are controlled by, or are under common
|
18
|
+
control with that entity. For the purposes of this definition,
|
19
|
+
"control" means (i) the power, direct or indirect, to cause the
|
20
|
+
direction or management of such entity, whether by contract or
|
21
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
22
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
23
|
+
|
24
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
25
|
+
exercising permissions granted by this License.
|
26
|
+
|
27
|
+
"Source" form shall mean the preferred form for making modifications,
|
28
|
+
including but not limited to software source code, documentation
|
29
|
+
source, and configuration files.
|
30
|
+
|
31
|
+
"Object" form shall mean any form resulting from mechanical
|
32
|
+
transformation or translation of a Source form, including but
|
33
|
+
not limited to compiled object code, generated documentation,
|
34
|
+
and conversions to other media types.
|
35
|
+
|
36
|
+
"Work" shall mean the work of authorship, whether in Source or
|
37
|
+
Object form, made available under the License, as indicated by a
|
38
|
+
copyright notice that is included in or attached to the work
|
39
|
+
(an example is provided in the Appendix below).
|
40
|
+
|
41
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
42
|
+
form, that is based on (or derived from) the Work and for which the
|
43
|
+
editorial revisions, annotations, elaborations, or other modifications
|
44
|
+
represent, as a whole, an original work of authorship. For the purposes
|
45
|
+
of this License, Derivative Works shall not include works that remain
|
46
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
47
|
+
the Work and Derivative Works thereof.
|
48
|
+
|
49
|
+
"Contribution" shall mean any work of authorship, including
|
50
|
+
the original version of the Work and any modifications or additions
|
51
|
+
to that Work or Derivative Works thereof, that is intentionally
|
52
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
53
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
54
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
55
|
+
means any form of electronic, verbal, or written communication sent
|
56
|
+
to the Licensor or its representatives, including but not limited to
|
57
|
+
communication on electronic mailing lists, source code control systems,
|
58
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
59
|
+
Licensor for the purpose of discussing and improving the Work, but
|
60
|
+
excluding communication that is conspicuously marked or otherwise
|
61
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
62
|
+
|
63
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
64
|
+
on behalf of whom a Contribution has been received by Licensor and
|
65
|
+
subsequently incorporated within the Work.
|
66
|
+
|
67
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
68
|
+
this License, each Contributor hereby grants to You a perpetual,
|
69
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
70
|
+
copyright license to reproduce, prepare Derivative Works of,
|
71
|
+
publicly display, publicly perform, sublicense, and distribute the
|
72
|
+
Work and such Derivative Works in Source or Object form.
|
73
|
+
|
74
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
75
|
+
this License, each Contributor hereby grants to You a perpetual,
|
76
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
77
|
+
(except as stated in this section) patent license to make, have made,
|
78
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
79
|
+
where such license applies only to those patent claims licensable
|
80
|
+
by such Contributor that are necessarily infringed by their
|
81
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
82
|
+
with the Work to which such Contribution(s) was submitted. If You
|
83
|
+
institute patent litigation against any entity (including a
|
84
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
85
|
+
or a Contribution incorporated within the Work constitutes direct
|
86
|
+
or contributory patent infringement, then any patent licenses
|
87
|
+
granted to You under this License for that Work shall terminate
|
88
|
+
as of the date such litigation is filed.
|
89
|
+
|
90
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
91
|
+
Work or Derivative Works thereof in any medium, with or without
|
92
|
+
modifications, and in Source or Object form, provided that You
|
93
|
+
meet the following conditions:
|
94
|
+
|
95
|
+
(a) You must give any other recipients of the Work or
|
96
|
+
Derivative Works a copy of this License; and
|
97
|
+
|
98
|
+
(b) You must cause any modified files to carry prominent notices
|
99
|
+
stating that You changed the files; and
|
100
|
+
|
101
|
+
(c) You must retain, in the Source form of any Derivative Works
|
102
|
+
that You distribute, all copyright, patent, trademark, and
|
103
|
+
attribution notices from the Source form of the Work,
|
104
|
+
excluding those notices that do not pertain to any part of
|
105
|
+
the Derivative Works; and
|
106
|
+
|
107
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
108
|
+
distribution, then any Derivative Works that You distribute must
|
109
|
+
include a readable copy of the attribution notices contained
|
110
|
+
within such NOTICE file, excluding those notices that do not
|
111
|
+
pertain to any part of the Derivative Works, in at least one
|
112
|
+
of the following places: within a NOTICE text file distributed
|
113
|
+
as part of the Derivative Works; within the Source form or
|
114
|
+
documentation, if provided along with the Derivative Works; or,
|
115
|
+
within a display generated by the Derivative Works, if and
|
116
|
+
wherever such third-party notices normally appear. The contents
|
117
|
+
of the NOTICE file are for informational purposes only and
|
118
|
+
do not modify the License. You may add Your own attribution
|
119
|
+
notices within Derivative Works that You distribute, alongside
|
120
|
+
or as an addendum to the NOTICE text from the Work, provided
|
121
|
+
that such additional attribution notices cannot be construed
|
122
|
+
as modifying the License.
|
123
|
+
|
124
|
+
You may add Your own copyright statement to Your modifications and
|
125
|
+
may provide additional or different license terms and conditions
|
126
|
+
for use, reproduction, or distribution of Your modifications, or
|
127
|
+
for any such Derivative Works as a whole, provided Your use,
|
128
|
+
reproduction, and distribution of the Work otherwise complies with
|
129
|
+
the conditions stated in this License.
|
130
|
+
|
131
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
132
|
+
any Contribution intentionally submitted for inclusion in the Work
|
133
|
+
by You to the Licensor shall be under the terms and conditions of
|
134
|
+
this License, without any additional terms or conditions.
|
135
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
136
|
+
the terms of any separate license agreement you may have executed
|
137
|
+
with Licensor regarding such Contributions.
|
138
|
+
|
139
|
+
6. Trademarks. This License does not grant permission to use the trade
|
140
|
+
names, trademarks, service marks, or product names of the Licensor,
|
141
|
+
except as required for reasonable and customary use in describing the
|
142
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
143
|
+
|
144
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
145
|
+
agreed to in writing, Licensor provides the Work (and each
|
146
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
147
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
148
|
+
implied, including, without limitation, any warranties or conditions
|
149
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
150
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
151
|
+
appropriateness of using or redistributing the Work and assume any
|
152
|
+
risks associated with Your exercise of permissions under this License.
|
153
|
+
|
154
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
155
|
+
whether in tort (including negligence), contract, or otherwise,
|
156
|
+
unless required by applicable law (such as deliberate and grossly
|
157
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
158
|
+
liable to You for damages, including any direct, indirect, special,
|
159
|
+
incidental, or consequential damages of any character arising as a
|
160
|
+
result of this License or out of the use or inability to use the
|
161
|
+
Work (including but not limited to damages for loss of goodwill,
|
162
|
+
work stoppage, computer failure or malfunction, or any and all
|
163
|
+
other commercial damages or losses), even if such Contributor
|
164
|
+
has been advised of the possibility of such damages.
|
165
|
+
|
166
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
167
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
168
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
169
|
+
or other liability obligations and/or rights consistent with this
|
170
|
+
License. However, in accepting such obligations, You may act only
|
171
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
172
|
+
of any other Contributor, and only if You agree to indemnify,
|
173
|
+
defend, and hold each Contributor harmless for any liability
|
174
|
+
incurred by, or claims asserted against, such Contributor by reason
|
175
|
+
of your accepting any such warranty or additional liability.
|
176
|
+
|
177
|
+
END OF TERMS AND CONDITIONS
|
178
|
+
|
179
|
+
APPENDIX: How to apply the Apache License to your work.
|
180
|
+
|
181
|
+
To apply the Apache License to your work, attach the following
|
182
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
183
|
+
replaced with your own identifying information. (Don't include
|
184
|
+
the brackets!) The text should be enclosed in the appropriate
|
185
|
+
comment syntax for the file format. We also recommend that a
|
186
|
+
file or class name and description of purpose be included on the
|
187
|
+
same "printed page" as the copyright notice for easier
|
188
|
+
identification within third-party archives.
|
189
|
+
|
190
|
+
Copyright 2020 Elastic and contributors
|
191
|
+
|
192
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
193
|
+
you may not use this file except in compliance with the License.
|
194
|
+
You may obtain a copy of the License at
|
195
|
+
|
196
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
197
|
+
|
198
|
+
Unless required by applicable law or agreed to in writing, software
|
199
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
200
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
201
|
+
See the License for the specific language governing permissions and
|
202
|
+
limitations under the License.
|
data/NOTICE.TXT
ADDED
data/README.md
ADDED
@@ -0,0 +1,98 @@
|
|
1
|
+
# Logstash Plugin
|
2
|
+
|
3
|
+
[![Travis Build Status](https://travis-ci.com/logstash-plugins/logstash-filter-example.svg)](https://travis-ci.com/logstash-plugins/logstash-filter-example)
|
4
|
+
|
5
|
+
This is a plugin for [Logstash](https://github.com/elastic/logstash).
|
6
|
+
|
7
|
+
It is fully free and fully open source. The license is Apache 2.0, meaning you are pretty much free to use it however you want in whatever way.
|
8
|
+
|
9
|
+
## Documentation
|
10
|
+
|
11
|
+
Logstash provides infrastructure to automatically build documentation for this plugin. We provide a template file, index.asciidoc, where you can add documentation. The contents of this file will be converted into html and then placed with other plugin documentation in a [central location](http://www.elastic.co/guide/en/logstash/current/).
|
12
|
+
|
13
|
+
- For formatting config examples, you can use the asciidoc `[source,json]` directive
|
14
|
+
- For more asciidoc formatting tips, see the excellent reference here https://github.com/elastic/docs#asciidoc-guide
|
15
|
+
|
16
|
+
## Need Help?
|
17
|
+
|
18
|
+
Need help? Try #logstash on freenode IRC or the https://discuss.elastic.co/c/logstash discussion forum.
|
19
|
+
|
20
|
+
## Developing
|
21
|
+
|
22
|
+
### 1. Plugin Developement and Testing
|
23
|
+
|
24
|
+
#### Code
|
25
|
+
- To get started, you'll need JRuby with the Bundler gem installed.
|
26
|
+
|
27
|
+
- Create a new plugin or clone and existing from the GitHub [logstash-plugins](https://github.com/logstash-plugins) organization. We also provide [example plugins](https://github.com/logstash-plugins?query=example).
|
28
|
+
|
29
|
+
- Install dependencies
|
30
|
+
```sh
|
31
|
+
bundle install
|
32
|
+
```
|
33
|
+
|
34
|
+
#### Test
|
35
|
+
|
36
|
+
- Update your dependencies
|
37
|
+
|
38
|
+
```sh
|
39
|
+
bundle install
|
40
|
+
```
|
41
|
+
|
42
|
+
- Run tests
|
43
|
+
|
44
|
+
```sh
|
45
|
+
bundle exec rspec
|
46
|
+
```
|
47
|
+
|
48
|
+
### 2. Running your unpublished Plugin in Logstash
|
49
|
+
|
50
|
+
#### 2.1 Run in a local Logstash clone
|
51
|
+
|
52
|
+
- Edit Logstash `Gemfile` and add the local plugin path, for example:
|
53
|
+
```ruby
|
54
|
+
gem "logstash-filter-awesome", :path => "/your/local/logstash-filter-awesome"
|
55
|
+
```
|
56
|
+
- Install plugin
|
57
|
+
```sh
|
58
|
+
# Logstash 2.3 and higher
|
59
|
+
bin/logstash-plugin install --no-verify
|
60
|
+
|
61
|
+
# Prior to Logstash 2.3
|
62
|
+
bin/plugin install --no-verify
|
63
|
+
|
64
|
+
```
|
65
|
+
- Run Logstash with your plugin
|
66
|
+
```sh
|
67
|
+
bin/logstash -e 'filter {awesome {}}'
|
68
|
+
```
|
69
|
+
At this point any modifications to the plugin code will be applied to this local Logstash setup. After modifying the plugin, simply rerun Logstash.
|
70
|
+
|
71
|
+
#### 2.2 Run in an installed Logstash
|
72
|
+
|
73
|
+
You can use the same **2.1** method to run your plugin in an installed Logstash by editing its `Gemfile` and pointing the `:path` to your local plugin development directory or you can build the gem and install it using:
|
74
|
+
|
75
|
+
- Build your plugin gem
|
76
|
+
```sh
|
77
|
+
gem build logstash-filter-awesome.gemspec
|
78
|
+
```
|
79
|
+
- Install the plugin from the Logstash home
|
80
|
+
```sh
|
81
|
+
# Logstash 2.3 and higher
|
82
|
+
bin/logstash-plugin install --no-verify
|
83
|
+
|
84
|
+
# Prior to Logstash 2.3
|
85
|
+
bin/plugin install --no-verify
|
86
|
+
|
87
|
+
```
|
88
|
+
- Start Logstash and proceed to test the plugin
|
89
|
+
|
90
|
+
## Contributing
|
91
|
+
|
92
|
+
All contributions are welcome: ideas, patches, documentation, bug reports, complaints, and even something you drew up on a napkin.
|
93
|
+
|
94
|
+
Programming is not a required skill. Whatever you've seen about open source and maintainers or community members saying "send patches or die" - you will not see that here.
|
95
|
+
|
96
|
+
It is more important to the community that you are able to contribute.
|
97
|
+
|
98
|
+
For more information about contributing, see the [CONTRIBUTING](https://github.com/elastic/logstash/blob/master/CONTRIBUTING.md) file.
|
@@ -0,0 +1,107 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
require "logstash/filters/base"
|
3
|
+
require "logstash/namespace"
|
4
|
+
|
5
|
+
class LogStash::Filters::Panfinder < LogStash::Filters::Base
|
6
|
+
|
7
|
+
# Setting the config_name here is required. This is how you
|
8
|
+
# configure this filter from your Logstash config.
|
9
|
+
#
|
10
|
+
# filter {
|
11
|
+
# panfinder {
|
12
|
+
# source => "message"
|
13
|
+
# luhn => true
|
14
|
+
# sanitize => false
|
15
|
+
# }
|
16
|
+
# }
|
17
|
+
#
|
18
|
+
config_name "panfinder"
|
19
|
+
|
20
|
+
config :source, :validate => :string, :default => 'message'
|
21
|
+
config :luhn, :validate => :boolean, :default => true
|
22
|
+
config :sanitize, :validate => :boolean, :default => false
|
23
|
+
|
24
|
+
public
|
25
|
+
def register
|
26
|
+
end # def register
|
27
|
+
|
28
|
+
public
|
29
|
+
def filter(event)
|
30
|
+
|
31
|
+
# this array will contain all numbers that satisfy the regex
|
32
|
+
pans_maybe = []
|
33
|
+
# this array will contain all pans which will be added to event
|
34
|
+
pans_valid = []
|
35
|
+
|
36
|
+
msg = event.get(@source)
|
37
|
+
|
38
|
+
unless msg
|
39
|
+
return
|
40
|
+
end
|
41
|
+
|
42
|
+
# match all elements from 14-19 numbers
|
43
|
+
# https://baymard.com/checkout-usability/credit-card-patterns
|
44
|
+
# https://regex101.com/r/nDQwVZ/1
|
45
|
+
# following patterns match
|
46
|
+
# 4-4-4-4
|
47
|
+
# 4-4-4-4-3
|
48
|
+
# 4-4-5
|
49
|
+
# 4-5-6
|
50
|
+
# 4-6-4
|
51
|
+
# 4-6-5
|
52
|
+
# and everythin with 13-19 digits without any special characters
|
53
|
+
pans_maybe = msg.scan(/(\D|^)((\d{13,19})|(\d{4}\D{0,1}((\d{4}\D{0,1}\d{4}\D{0,1}\d{4}(\D{0,1}\d{3}|))|(\d{4}\D{0,1}\d{5})|(\d{5}\D{0,1}\d{6})|\d{6}\D{0,1}(\d{5}|\d{4}))))(\D|$)/)
|
54
|
+
|
55
|
+
unless pans_maybe.empty?
|
56
|
+
pans_maybe.each do |pan_number_match|
|
57
|
+
pan_number = pan_number_match[1]
|
58
|
+
# if luhn is enabled check the pan_number otherwise always add the pan_number
|
59
|
+
if (not @luhn) || luhn_valid?(pan_number)
|
60
|
+
pans_valid.append(pan_number)
|
61
|
+
if @sanitize
|
62
|
+
msg = msg.gsub(pan_number, "###! sanitizeD PAN !###")
|
63
|
+
end
|
64
|
+
end
|
65
|
+
end
|
66
|
+
# if any pans where valid add them to the event
|
67
|
+
unless pans_valid.empty?
|
68
|
+
event.set("pans", pans_valid)
|
69
|
+
if @sanitize
|
70
|
+
event.set(@source, msg)
|
71
|
+
end
|
72
|
+
end
|
73
|
+
end
|
74
|
+
|
75
|
+
@logger.debug? && @logger.debug("PANs found: #{event.get("pans")}")
|
76
|
+
|
77
|
+
# filter_matched should go in the last line of our successful code
|
78
|
+
filter_matched(event)
|
79
|
+
end # def filter
|
80
|
+
|
81
|
+
private
|
82
|
+
# https://stackoverflow.com/questions/9188360/implementing-the-luhn-algorithm-in-ruby
|
83
|
+
def luhn_valid?(cc_number)
|
84
|
+
number = cc_number.
|
85
|
+
gsub(/\D/, ''). # remove non-digits
|
86
|
+
reverse # read from right to left
|
87
|
+
|
88
|
+
sum, i = 0, 0
|
89
|
+
|
90
|
+
number.each_char do |ch|
|
91
|
+
n = ch.to_i
|
92
|
+
|
93
|
+
# Step 1
|
94
|
+
n *= 2 if i.odd?
|
95
|
+
|
96
|
+
# Step 2
|
97
|
+
n = 1 + (n - 10) if n >= 10
|
98
|
+
|
99
|
+
sum += n
|
100
|
+
i += 1
|
101
|
+
end
|
102
|
+
|
103
|
+
# Step 3
|
104
|
+
(sum % 10).zero?
|
105
|
+
end
|
106
|
+
|
107
|
+
end # class LogStash::Filters::Panfinder
|
@@ -0,0 +1,23 @@
|
|
1
|
+
Gem::Specification.new do |s|
|
2
|
+
s.name = 'logstash-filter-panfinder'
|
3
|
+
s.version = '0.0.2'
|
4
|
+
s.licenses = ['Apache License (2.0)']
|
5
|
+
s.summary = "This panfinder filter looks for PANs in your log files and can also remove them from the logs."
|
6
|
+
s.description = "This gem is a Logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/logstash-plugin install gemname. This gem is not a stand-alone program"
|
7
|
+
s.authors = ["Daniel Niecke"]
|
8
|
+
s.email = 'daniel@niecke-it.de'
|
9
|
+
s.homepage = "http://www.elastic.co/guide/en/logstash/current/index.html"
|
10
|
+
s.require_paths = ["lib"]
|
11
|
+
|
12
|
+
# Files
|
13
|
+
s.files = Dir['lib/**/*','spec/**/*','vendor/**/*','*.gemspec','*.md','CONTRIBUTORS','Gemfile','LICENSE','NOTICE.TXT']
|
14
|
+
# Tests
|
15
|
+
s.test_files = s.files.grep(%r{^(test|spec|features)/})
|
16
|
+
|
17
|
+
# Special flag to let us know this is actually a logstash plugin
|
18
|
+
s.metadata = { "logstash_plugin" => "true", "logstash_group" => "filter" }
|
19
|
+
|
20
|
+
# Gem dependencies
|
21
|
+
s.add_runtime_dependency "logstash-core-plugin-api", "~> 2.0"
|
22
|
+
s.add_development_dependency 'logstash-devutils'
|
23
|
+
end
|
@@ -0,0 +1,175 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
require 'spec_helper'
|
3
|
+
require "logstash/filters/panfinder"
|
4
|
+
|
5
|
+
describe LogStash::Filters::Panfinder do
|
6
|
+
describe "Panfinder tests" do
|
7
|
+
let(:config) do <<-CONFIG
|
8
|
+
filter {
|
9
|
+
panfinder {
|
10
|
+
}
|
11
|
+
}
|
12
|
+
CONFIG
|
13
|
+
end
|
14
|
+
|
15
|
+
sample("message" => "some text") do
|
16
|
+
expect(subject.get("pans")).to be_nil
|
17
|
+
end
|
18
|
+
|
19
|
+
pans = {
|
20
|
+
# Visa
|
21
|
+
"text 4111111111111111 some more text" => "4111111111111111",
|
22
|
+
"text 4111141011111111116 some more text" => "4111141011111111116",
|
23
|
+
|
24
|
+
# Mastercard
|
25
|
+
"text 5500000000000004 some more text" => "5500000000000004",
|
26
|
+
"text 2720990000000015 some more text" => "2720990000000015",
|
27
|
+
|
28
|
+
# Maestro
|
29
|
+
"text 67012345678901236 some more text" => "67012345678901236",
|
30
|
+
|
31
|
+
# AMEX
|
32
|
+
"text 340000000000009 some more text" => "340000000000009",
|
33
|
+
"text 370000000000002 some more text" => "370000000000002",
|
34
|
+
|
35
|
+
# JCB
|
36
|
+
"text 3528000000000007 some more text" => "3528000000000007",
|
37
|
+
|
38
|
+
# Diners/Discover
|
39
|
+
"text 30000000000004 some more text" => "30000000000004",
|
40
|
+
"text 6011111111111117 some more text" => "6011111111111117",
|
41
|
+
}
|
42
|
+
|
43
|
+
pans.each do |input, output|
|
44
|
+
sample("message" => input) do
|
45
|
+
expect(subject.get("pans")).to eq([output])
|
46
|
+
end
|
47
|
+
end
|
48
|
+
|
49
|
+
# test data which are not luhn compatible
|
50
|
+
pans_no_lun = [
|
51
|
+
"text 4111111112111111 some more text",
|
52
|
+
"text 4111141011111211116 some more text",
|
53
|
+
"text 5500000010000004 some more text",
|
54
|
+
"text 2720990001000015 some more text",
|
55
|
+
"text 67012345679901236 some more text",
|
56
|
+
"text 340000010000009 some more text",
|
57
|
+
"text 370000010000002 some more text",
|
58
|
+
"text 3528000100000007 some more text",
|
59
|
+
"text 30000001000004 some more text",
|
60
|
+
"text 6011111211111117 some more text",
|
61
|
+
]
|
62
|
+
pans_no_lun.each do |input|
|
63
|
+
sample("message" => input) do
|
64
|
+
expect(subject.get("pans")).to be_nil
|
65
|
+
end
|
66
|
+
end
|
67
|
+
|
68
|
+
# formated pans
|
69
|
+
pans_formated = {
|
70
|
+
# Visa
|
71
|
+
"text 4111 1111 1111 1111 some more text" => "4111 1111 1111 1111",
|
72
|
+
"text 4111.1111.1111.1111 some more text" => "4111.1111.1111.1111",
|
73
|
+
|
74
|
+
# Mastercard
|
75
|
+
"text 5500 0000 0000 0004 some more text" => "5500 0000 0000 0004",
|
76
|
+
"text 2720#9900#0000#0015 some more text" => "2720#9900#0000#0015",
|
77
|
+
|
78
|
+
# AMEX
|
79
|
+
"text 3400 000000 00009 some more text" => "3400 000000 00009",
|
80
|
+
"text 3700-000000-00002 some more text" => "3700-000000-00002",
|
81
|
+
|
82
|
+
# JCB
|
83
|
+
"text 3528 0000 0000 0007 some more text" => "3528 0000 0000 0007",
|
84
|
+
|
85
|
+
# Diners/Discover
|
86
|
+
"text 3000 000000 0004 some more text" => "3000 000000 0004",
|
87
|
+
"text 6011 1111 1111 1117 some more text" => "6011 1111 1111 1117",
|
88
|
+
}
|
89
|
+
pans_formated.each do |input, output|
|
90
|
+
sample("message" => input) do
|
91
|
+
expect(subject.get("pans")).to eq([output])
|
92
|
+
end
|
93
|
+
end
|
94
|
+
|
95
|
+
# multiple pan
|
96
|
+
pans_formated = {
|
97
|
+
"text 4111 1111 1111 1111 some more text 2720#9900#0000#0015 and not luhn 67012345679901236" => ["4111 1111 1111 1111", "2720#9900#0000#0015"],
|
98
|
+
}
|
99
|
+
pans_formated.each do |input, output|
|
100
|
+
sample("message" => input) do
|
101
|
+
expect(subject.get("pans")).to eq(output)
|
102
|
+
end
|
103
|
+
end
|
104
|
+
|
105
|
+
end
|
106
|
+
|
107
|
+
describe "Panfinder tests without luhn check" do
|
108
|
+
let(:config) do <<-CONFIG
|
109
|
+
filter {
|
110
|
+
panfinder {
|
111
|
+
luhn => false
|
112
|
+
}
|
113
|
+
}
|
114
|
+
CONFIG
|
115
|
+
end
|
116
|
+
|
117
|
+
# multiple pan
|
118
|
+
pans_formated = {
|
119
|
+
"text 4111 1111 1111 1111 some more text 2720#9900#0000#0015 and not luhn 67012345679901236" => ["4111 1111 1111 1111", "2720#9900#0000#0015", "67012345679901236"],
|
120
|
+
}
|
121
|
+
pans_formated.each do |input, output|
|
122
|
+
sample("message" => input) do
|
123
|
+
expect(subject.get("pans")).to eq(output)
|
124
|
+
end
|
125
|
+
end
|
126
|
+
end
|
127
|
+
|
128
|
+
describe "Panfinder with sanitize" do
|
129
|
+
let(:config) do <<-CONFIG
|
130
|
+
filter {
|
131
|
+
panfinder {
|
132
|
+
luhn => true
|
133
|
+
sanitize => true
|
134
|
+
}
|
135
|
+
}
|
136
|
+
CONFIG
|
137
|
+
end
|
138
|
+
|
139
|
+
# multiple pan
|
140
|
+
pans_formated = {
|
141
|
+
"text 4111 1111 1111 1111 some more text 2720#9900#0000#0015 and not luhn 67012345679901236" => "text ###! sanitizeD PAN !### some more text ###! sanitizeD PAN !### and not luhn 67012345679901236",
|
142
|
+
}
|
143
|
+
pans_formated.each do |input, output|
|
144
|
+
sample("message" => input) do
|
145
|
+
expect(subject.get("message")).to eq(output)
|
146
|
+
end
|
147
|
+
end
|
148
|
+
end
|
149
|
+
|
150
|
+
describe "Panfinder with sanitize" do
|
151
|
+
let(:config) do <<-CONFIG
|
152
|
+
filter {
|
153
|
+
panfinder {
|
154
|
+
luhn => false
|
155
|
+
sanitize => true
|
156
|
+
}
|
157
|
+
}
|
158
|
+
CONFIG
|
159
|
+
end
|
160
|
+
|
161
|
+
# multiple pan
|
162
|
+
pans_formated = {
|
163
|
+
"text 4111 1111 1111 1111 some more text 2720#9900#0000#0015 and not luhn 67012345679901236" => "text ###! sanitizeD PAN !### some more text ###! sanitizeD PAN !### and not luhn ###! sanitizeD PAN !###",
|
164
|
+
}
|
165
|
+
pans_formated.each do |input, output|
|
166
|
+
sample("message" => input) do
|
167
|
+
expect(subject.get("message")).to eq(output)
|
168
|
+
end
|
169
|
+
end
|
170
|
+
end
|
171
|
+
|
172
|
+
end
|
173
|
+
|
174
|
+
|
175
|
+
|
data/spec/spec_helper.rb
ADDED
metadata
ADDED
@@ -0,0 +1,88 @@
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
|
+
name: logstash-filter-panfinder
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
version: 0.0.2
|
5
|
+
platform: ruby
|
6
|
+
authors:
|
7
|
+
- Daniel Niecke
|
8
|
+
autorequire:
|
9
|
+
bindir: bin
|
10
|
+
cert_chain: []
|
11
|
+
date: 2021-05-10 00:00:00.000000000 Z
|
12
|
+
dependencies:
|
13
|
+
- !ruby/object:Gem::Dependency
|
14
|
+
requirement: !ruby/object:Gem::Requirement
|
15
|
+
requirements:
|
16
|
+
- - "~>"
|
17
|
+
- !ruby/object:Gem::Version
|
18
|
+
version: '2.0'
|
19
|
+
name: logstash-core-plugin-api
|
20
|
+
prerelease: false
|
21
|
+
type: :runtime
|
22
|
+
version_requirements: !ruby/object:Gem::Requirement
|
23
|
+
requirements:
|
24
|
+
- - "~>"
|
25
|
+
- !ruby/object:Gem::Version
|
26
|
+
version: '2.0'
|
27
|
+
- !ruby/object:Gem::Dependency
|
28
|
+
requirement: !ruby/object:Gem::Requirement
|
29
|
+
requirements:
|
30
|
+
- - ">="
|
31
|
+
- !ruby/object:Gem::Version
|
32
|
+
version: '0'
|
33
|
+
name: logstash-devutils
|
34
|
+
prerelease: false
|
35
|
+
type: :development
|
36
|
+
version_requirements: !ruby/object:Gem::Requirement
|
37
|
+
requirements:
|
38
|
+
- - ">="
|
39
|
+
- !ruby/object:Gem::Version
|
40
|
+
version: '0'
|
41
|
+
description: This gem is a Logstash plugin required to be installed on top of the
|
42
|
+
Logstash core pipeline using $LS_HOME/bin/logstash-plugin install gemname. This
|
43
|
+
gem is not a stand-alone program
|
44
|
+
email: daniel@niecke-it.de
|
45
|
+
executables: []
|
46
|
+
extensions: []
|
47
|
+
extra_rdoc_files: []
|
48
|
+
files:
|
49
|
+
- CHANGELOG.md
|
50
|
+
- CONTRIBUTORS
|
51
|
+
- DEVELOPER.md
|
52
|
+
- Gemfile
|
53
|
+
- LICENSE
|
54
|
+
- NOTICE.TXT
|
55
|
+
- README.md
|
56
|
+
- lib/logstash/filters/panfinder.rb
|
57
|
+
- logstash-filter-panfinder.gemspec
|
58
|
+
- spec/filters/panfinder_spec.rb
|
59
|
+
- spec/spec_helper.rb
|
60
|
+
homepage: http://www.elastic.co/guide/en/logstash/current/index.html
|
61
|
+
licenses:
|
62
|
+
- Apache License (2.0)
|
63
|
+
metadata:
|
64
|
+
logstash_plugin: 'true'
|
65
|
+
logstash_group: filter
|
66
|
+
post_install_message:
|
67
|
+
rdoc_options: []
|
68
|
+
require_paths:
|
69
|
+
- lib
|
70
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
71
|
+
requirements:
|
72
|
+
- - ">="
|
73
|
+
- !ruby/object:Gem::Version
|
74
|
+
version: '0'
|
75
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
76
|
+
requirements:
|
77
|
+
- - ">="
|
78
|
+
- !ruby/object:Gem::Version
|
79
|
+
version: '0'
|
80
|
+
requirements: []
|
81
|
+
rubygems_version: 3.1.6
|
82
|
+
signing_key:
|
83
|
+
specification_version: 4
|
84
|
+
summary: This panfinder filter looks for PANs in your log files and can also remove
|
85
|
+
them from the logs.
|
86
|
+
test_files:
|
87
|
+
- spec/filters/panfinder_spec.rb
|
88
|
+
- spec/spec_helper.rb
|