FalcoSecurity.Plugin.Sdk

falcosecurity.plugin.sdk

المكون الإضافي غير الرسمي Falco SDK لـ .NET ، مدعوم من صادرات DNNE الأصلية وإدارة الذاكرة الأصلية Net6+.

ويكي

للحصول على مثال كامل ومعلومات إضافة حول كيفية عمل هذا ، تحقق من الويكي!

حزم nuget

		DESC	Changelog
falcosecurity.plugin.sdk		أنواع المكون الإضافي الأساسي SDK	Changelog.MD
falcosecurity.plugin.sdk.generators		مولدات المصدر للصادرات الأصلية	Changelog.MD
falcosecurity.plugin.sdk.template		قالب المشروع dotnet new falcoplugin

المكون الإضافي وهمية Sneak-Peek

 [ 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@somplace: ~ $ 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@somplace: ~ $ falco-able-source dummy_source
السبت 5 نوفمبر 18:08:52 2022: Valco الإصدار: 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 قيمة = 42
الأحداث المكتشفة: 1
تهم القاعدة من خلال الشدة:
   تصحيح: 1
القواعد التي تم تشغيلها حسب اسم القاعدة:
   قاعدة العداد الوهمية: 1

admin@somplace: ~ $ █

ملحوظة

هذا SDK غير رسمي ولا يرتبط به ولا يؤيده من قبل Sysdig و Falcosecurity/Falco