FalcoSecurity.Plugin.Sdk
1.0.0
ปลั๊กอิน FALCO อย่างไม่เป็นทางการ SDK สำหรับ. NET ขับเคลื่อนโดย DNNE Native Exports และ Net6+ การจัดการหน่วยความจำดั้งเดิม
สำหรับตัวอย่างเต็มรูปแบบและข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานให้ลองดูวิกิ!
| แยกออกจากกัน | การเปลี่ยนแปลง | ||
|---|---|---|---|
| falcosecurity.plugin.sdk | ประเภทปลั๊กอินหลัก SDK | changelog.md | |
| falcosecurity.plugin.sdk.enerators | เครื่องกำเนิดแหล่งที่มาสำหรับการส่งออกดั้งเดิม | changelog.md | |
| falcosecurity.plugin.sdk.template | เทมเพลตโครงการ dotnet new falcoplugin |
[ FalcoPlugin (
Id = 999 ,
Name = "dummy_plugin" ,
Description = "A dummy plugin" ,
Contacts = "mvenditto" ,
RequiredApiVersion = "2.0.0" ,
Version = "1.0.0" ) ]
public class Plugin : PluginBase , IEventSource , IFieldExtractor {
public string EventSourceName => "dummy_source" ;
public IEnumerable < string > EventSourcesToExtract
=> Enumerable . Empty < string > ( ) ; // only consume ourselves event-source
public IEnumerable < OpenParam > OpenParameters =>
=> Enumerable . Empty < string > ( ) ; // no specific open-params
public IEnumerable < ExtractionField > Fields => new List < ExtractionField > {
new ( type : "uint64" ,
name : "dummy.counter" ,
display : "Counter value" ,
desc : "Current value of the internal counter" )
} ;
public IEventSourceInstance Open ( IEnumerable < OpenParam > ? openParams ) {
return new CounterInstance ( ) ;
}
public void Close ( IEventSourceInstance instance ) {
instance . Dispose ( ) ;
}
public void Extract ( IExtractionRequest extraction , IEventReader evt ) {
var counter = BitConverter . ToInt32 ( evt . Data ) ;
extraction . SetValue ( ( ulong ) counter ) ;
}
}
public class CounterInstance : PullEventSourceInstance {
public int Counter { get ; set ; }
public CounterInstance ( ) : base ( batchSize : 10 , eventSize : 8 ) {
Counter = 1 ;
}
protected override void PullEvent ( EventSourceInstanceContext ctx , IEventWriter evt ) {
var unixNano = ( ulong ) DateTimeOffset . Now . ToUnixTimeSeconds ( ) * 1000000000 ;
evt . Write ( BitConverter . GetBytes ( Counter ) ) ;
evt . SetTimestamp ( unixNano ) ;
if ( Counter >= 50 ) {
ctx . IsEof = true ;
}
Counter += 1 ;
}
} - rule : Dummy counter rule
desc : Dummy counter equals 42
condition : (dummy.counter=42)
output : dummy.counter is 42 value=%dummy.counter
priority : DEBUG
source : dummy_source
tags : [dummy] admin@someplace: ~ $ tree/usr/share/falco
/usr/share/falco/
ปลั๊กอิน
├── libjson.so
├── libk8saudit.so
└── dummy_plugin
├── plugin_native.so
├── falcosecurity.plugin.sdk.dll
├── falcosecurity.plugin.sdk.dummyplugin.dll
microsoft.extensions.objectpool.dll
└── falcosecurity.plugin.sdk.dummyplugin.runtimeconfig.json
admin@someplace: ~ $ falco-enable-source dummy_source
วันเสาร์ 5 พ.ย. 18:08:52 2022: เวอร์ชัน Falco: 0.33.0 (x86_64)
[... ถูกตัดทอน ... ]
วันเสาร์ 5 พ.ย. 18:08:52 2022: เปิดใช้งานแหล่งเหตุการณ์: dummy_source
วันเสาร์ 5 พ.ย. 18:08:52 2022: เปิดแหล่งเหตุการณ์ 'Dummy_Source'
วันเสาร์ที่ 5 พ.ย. 18:08:52 2022: เปิดการจับภาพด้วยปลั๊กอิน 'dummy_plugin'
วันเสาร์ 5 พ.ย. 18:08:52 2022: การปิดเหตุการณ์ที่มา 'dummy_source'
18: 08: 52.000000000: Debug dummy.Counter คือ 42 value = 42
ตรวจพบเหตุการณ์: 1
กฎนับด้วยความรุนแรง:
ดีบัก: 1
กฎที่ถูกเรียกใช้ตามชื่อกฎ:
กฎเคาน์เตอร์จำลอง: 1
admin@someplace: ~ $ █SDK นี้ ไม่เป็นทางการ และไม่เกี่ยวข้องหรือไม่รับรองโดย Sysdig และ Falcosecurity/Falco