From 8e29aaaed23ebb08d50382f134a3d8c426450428 Mon Sep 17 00:00:00 2001 From: Curle Date: Wed, 1 Mar 2023 23:48:59 +0000 Subject: [PATCH] Initial Commit. --- .gitattributes | 6 + .gitignore | 5 + .vscode/launch.json | 21 ++ .vscode/settings.json | 3 + app/bin/main/butler/App$WebhookHandler.class | Bin 0 -> 2225 bytes app/bin/main/butler/App.class | Bin 0 -> 9180 bytes app/bin/main/butler/action/Action.class | Bin 0 -> 168 bytes .../main/butler/action/ForwardAction.class | Bin 0 -> 6339 bytes app/bin/main/butler/action/RejectAction.class | Bin 0 -> 957 bytes app/bin/main/butler/filter/Filter.class | Bin 0 -> 165 bytes .../main/butler/filter/FilterContent.class | Bin 0 -> 2170 bytes app/bin/main/butler/filter/FilterGithub.class | Bin 0 -> 4872 bytes app/bin/main/butler/filter/FilterSource.class | Bin 0 -> 2457 bytes app/bin/main/butler/rule/Rule.class | Bin 0 -> 9439 bytes app/bin/main/butler/source/SourceData.class | Bin 0 -> 5313 bytes app/bin/test/butler/AppTest.class | Bin 0 -> 406 bytes app/build.gradle | 50 +++ app/src/main/java/butler/App.java | 321 ++++++++++++++++++ app/src/main/java/butler/action/Action.java | 10 + .../java/butler/action/ForwardAction.java | 109 ++++++ .../main/java/butler/action/RejectAction.java | 23 ++ app/src/main/java/butler/filter/Filter.java | 13 + .../java/butler/filter/FilterContent.java | 32 ++ .../main/java/butler/filter/FilterGithub.java | 107 ++++++ .../main/java/butler/filter/FilterSource.java | 51 +++ app/src/main/java/butler/rule/Rule.java | 190 +++++++++++ .../main/java/butler/source/SourceData.java | 74 ++++ app/src/test/java/butler/AppTest.java | 12 + config.gddl | 23 ++ gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 59536 bytes gradle/wrapper/gradle-wrapper.properties | 5 + gradlew | 234 +++++++++++++ gradlew.bat | 89 +++++ settings.gradle | 11 + 34 files changed, 1389 insertions(+) create mode 100644 .gitattributes create mode 100644 .gitignore create mode 100644 .vscode/launch.json create mode 100644 .vscode/settings.json create mode 100644 app/bin/main/butler/App$WebhookHandler.class create mode 100644 app/bin/main/butler/App.class create mode 100644 app/bin/main/butler/action/Action.class create mode 100644 app/bin/main/butler/action/ForwardAction.class create mode 100644 app/bin/main/butler/action/RejectAction.class create mode 100644 app/bin/main/butler/filter/Filter.class create mode 100644 app/bin/main/butler/filter/FilterContent.class create mode 100644 app/bin/main/butler/filter/FilterGithub.class create mode 100644 app/bin/main/butler/filter/FilterSource.class create mode 100644 app/bin/main/butler/rule/Rule.class create mode 100644 app/bin/main/butler/source/SourceData.class create mode 100644 app/bin/test/butler/AppTest.class create mode 100644 app/build.gradle create mode 100644 app/src/main/java/butler/App.java create mode 100644 app/src/main/java/butler/action/Action.java create mode 100644 app/src/main/java/butler/action/ForwardAction.java create mode 100644 app/src/main/java/butler/action/RejectAction.java create mode 100644 app/src/main/java/butler/filter/Filter.java create mode 100644 app/src/main/java/butler/filter/FilterContent.java create mode 100644 app/src/main/java/butler/filter/FilterGithub.java create mode 100644 app/src/main/java/butler/filter/FilterSource.java create mode 100644 app/src/main/java/butler/rule/Rule.java create mode 100644 app/src/main/java/butler/source/SourceData.java create mode 100644 app/src/test/java/butler/AppTest.java create mode 100644 config.gddl create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 settings.gradle diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..00a51af --- /dev/null +++ b/.gitattributes @@ -0,0 +1,6 @@ +# +# https://help.github.com/articles/dealing-with-line-endings/ +# +# These are explicitly windows files and should use crlf +*.bat text eol=crlf + diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..1b6985c --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +# Ignore Gradle project-specific cache directory +.gradle + +# Ignore Gradle build output directory +build diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 0000000..25658c4 --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,21 @@ +{ + // Use IntelliSense to learn about possible attributes. + // Hover to view descriptions of existing attributes. + // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387 + "version": "0.2.0", + "configurations": [ + { + "type": "java", + "name": "Current File", + "request": "launch", + "mainClass": "${file}" + }, + { + "type": "java", + "name": "App", + "request": "launch", + "mainClass": "butler.App", + "projectName": "app" + } + ] +} \ No newline at end of file diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..c5f3f6b --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,3 @@ +{ + "java.configuration.updateBuildConfiguration": "interactive" +} \ No newline at end of file diff --git a/app/bin/main/butler/App$WebhookHandler.class b/app/bin/main/butler/App$WebhookHandler.class new file mode 100644 index 0000000000000000000000000000000000000000..e22f47fb78d944fe716ea5946a0f8605e5f21d2e GIT binary patch literal 2225 zcma)7TXz#x6#h<|GHDo~6hyfQp%h8l(kW7|;bOr;18ItBDF{WKB&W%=$xN6zK@h9* z=(7(lc+oeOkGP<&`k+3#{88d}CesVx(mu@0p1t?kw{P!#{`&jZ-vFG&BLi&$JBv+K zlfE_5X!PEY#j5AckJ)aSECVrtt~vXjZPjeIVoen1WJwv=Akb6t>Q>NnEmtb5s#GJ8 z{yiEQBN?3**r2LT&^shx=2m@V$Uoz_jyfl>CAC(No)(B*^vbdm0-H=2h$qmFEhakA zCD5MI3R`lHEA!2IQTkJMu_gt&b6&}=P20Ys|08BhyB65J#{O%`={Txko&u>m#WgzOotWbcX-aqg({gi_A|8G`O&Excam9`5mF^tkawFhP=m>b3#T703?yfL zuTFX}fde>bpjY6)I&v}b9u5)Qid2!oajB|aSzvoAom+)`Qu%b6(ZD^h)zmMe@u>9Klfo?+fhvp8}Z} z#xa48vMe?$0#{RS#=VBqYTnFxIO*v)PO#xFk4`0U3K;{ZUzvkeQB0h{SprHt>>BfW zYpwstTl!WU=LLEr5DRj)8E6n`IqA26TmeugK4RhmE^-VUch(a)wAN$<#hVGFr!_pI zCNAMJ8#0h?xgdiEJ5-KIyDWVM*OAIz(PL@JDSP4Tn@3@IPCV0wk z)+A4NwVXDUQ?qhTpa{}Om^4rj*c|rCip0bet_#E+C4F0Y?DHMVaEChCh))YQ@UelL zoZnRo%Tg1!aGR03^1gb#BcsY1xWl-j@zP;h1-|0=RAAtC;d*ZLPI8K4qKmDioRFkl zu^l&1$yd@%U)kr+p_)KC%1WoHv#HyPo1;9KZcGIM?OY`G) zBihi3Nw4XbB&(r)F^NIl2aGuDy3)T`vx7jl-sV@YB&y~K>zEfPBzaA=^XY)->e9Cb zFSRy4ok)8%H7C*6{{m*;FWCGn)Y;1S2I@eh&`sLZG*4~Ac78d^*uiselaBH4 z9c@e8q@Nf$i$7ymcd~yGJ$zDp29_|?0nO+>zKD~Lu}5p1Ye_z6NB>swUFRY`e2Rro zX)IK_tCg;-DD^#u`5d_=TocGY#ks>v;AQg%X2!MNCj*Q4tfgCuVSrTSF?MOmyp}A1 zZZx<41hHp4+7Nj1^7sC&_)|NkKz5!FmnpW{BO<#Bi(;0xC8A>}=Y sWnLnUm;qt1$qcq2PQPTG+aivR>q~03VF6$9tFhz7jju_66Y_We1GLUUjsO4v literal 0 HcmV?d00001 diff --git a/app/bin/main/butler/App.class b/app/bin/main/butler/App.class new file mode 100644 index 0000000000000000000000000000000000000000..8c3fe077168a5484c8abe8885f85e099d9386cb9 GIT binary patch literal 9180 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 literal 0 HcmV?d00001 diff --git a/app/bin/main/butler/action/ForwardAction.class b/app/bin/main/butler/action/ForwardAction.class new file mode 100644 index 0000000000000000000000000000000000000000..4ad11fcc6da1d2ee67016d8d4ac98886e7d9f28c GIT binary patch literal 6339 zcmbVR349dQ8UKIDCbQX0Bt!uh6;=gFII@C(nh2OcBEdkAa0sY%vO7r@HaqL=EQd#F z>D}5|Yj1j>t)&O8#p(vcDpIP|T5B(~r#-B_Y^$~Qups@vnc3_viAeh+JM-qf?|t|6 z9*@0x-va>VNvno3!5KYSCu!PIBjzNmRJ7f)Hyd`m#r@I{5Y%okHW|^Rk?M zj)qFXX{FmdctK^->gzLY!P%Xb-4`{|My%hAs>uZR^F4b*w9^G?7L;f0q@b>|K%m>P z3CE?%OA@JsGhfhH-x)VIMf(zcM!#uaAI&<6WVA0HPtJ;F96K9xvbGt$jNeO*baTUM zL13X3H$y1LC>_3F;fX4e;SxiD#D zGR+OID`6D`r|ZxV3}HOZ)NqEN;iRR}aTX>}6Pt`=*31x7eS^n?tAd4AGD%y|WX;ux z;2aHS(PhvZ-jwbfW!^ zlg^m-CdTMu4%@cG`WcI6bHlnIS_N~~FKb)5=IY1_GoG-ON2K~9ws{?0#)9`DwnF)wvg*jk3W=lM7n;B|iLf&+W(+)nm zt=LA>@z?1COVFv|a>01l2S$X_u~b>ChS(Qd8OO7ZVz5icaz%F(S6plOXcg8KI=Wpu z`@5DI17Z&0UD>v=wJYnSvr05ZSqSSeN(@x5am#RVn4> z$~zRukO%dUW`u4zG~v5cW2B|WvX!$nDy^qxjZ*707vPcXXRSc_?K(`GcEL)Kp_9e6O!b!;8puj5vHfF;F<#mqDl_&i^~O5$Nc zu~52pam!L~Hs$phtqJNSlN~T^dhQ4DVGSQ*HaRhI9Us9*87B0{Hue>Y-`7E{JnZA# zapjEVwzXxehEL=xTaoj$W)n%uAH=5!+3I#fkq~y^`YPOx&uF+q5c2bVOFFINv#MZd z%*PozhXVYZj$Qb?(np$>VtmaQ$={0dhv&3DUCO@$UsRqyR~c`&jxXaYtUm?gk#`mc zhr$0kapebtlKQKK%1{Vxq8tk30oNlMBTLxbMG~1vk8N!h#8Mdp&FY~2)gHwSLVK^@;v9h~NSzJ_nI4a#S?MTTRPrq%6uM8~)As8=zH z*NVC)rp@9NYX1i?0Tc~~50=p2mWe0657_3QGm1f$_8_EmXFTeH2rrftSoxG|{V$K*7>R+QttWu@nz z>iAi{coYGI@HBp*M14l-!}G`Es)&;GFn*Kt!&ctP>U9{u)$yFFz(E=> zuG*&{elM8pORaK|m!>E$oAi_!k7V4wOQllfWPjB0Cp=G;Ikpj_*)JX;Xo_OyHLI}4 z@?UiPRryLqENNxf|G$WrH2f`J4Bcp7*>78$Rh856cf8Do!-&Vbv+1)skUsA$$#RIBaPVYupO@KaUEDtww?{Ebnr)e zj~UumBr~B^v^(tPS^I||P9!|HlryAQi9K+?>~cDw@`m8d!u;^!B#0E2M^qdU6=4{r zH$~pclH2h^+#a8qJPw&IP9Fj(4QT?DWqKIZ-um#`M1Vk&Ax5X|c8u6Y9(LUmi6$&X z!K5+J6E`NE&u-3-p^*#mFzkL$>sIE@M8=`7SIapvNt1J_PS>A?)_7u*$*Ps=C~m*} zs3dzSHsDkRPpkBIkJ8XyvOl);IJGsMKT=IP4)&7aT+ZkIP`8z}V`e*pkF~MA_?Dtk zF-oGXmgO+T7-_HB$%G^-Gc}=F&T&O?)tX3cVx5b2x+)`}(aVbu%igNXEV+Pnj%6`F zC3w6zCHXr&O6X6A6gy|{3Xi|S%N>k!~`0-t9P)kM_uwxx+P zV~LUo(Tq#@R-<{CPjZ3xq3D8hNcY*QL|QYmg|e!ug~&oAl;jBUf(1g`_&4bQkcHb}4qE zh1Ad1oErm;lGeyr%B)ew+x^jOA1+9l zJLPl<^W2x<<>z=g1J#s2C})x@U2eoUfApl!b5PEr1|G$@SJe&ZI!z|XE6}dcaCFQP z4abgPjE22kn#d8t7Q>^^wp<}#`t&-Na7eBqxy9>D1kS1&8JgQ2~*2)yA=l?r2aICVkH#3zyl*=@JmC1BbPR}*E WUAfGai=|mqidE%ko-B|Sg#Qbi%J8HB literal 0 HcmV?d00001 diff --git a/app/bin/main/butler/action/RejectAction.class b/app/bin/main/butler/action/RejectAction.class new file mode 100644 index 0000000000000000000000000000000000000000..326deffcdc2dd65f036f074c663c6215113b53c4 GIT binary patch literal 957 zcmb7DO>fgc5PjPub(@B?4QYW=+LTi2G>}DzTL7s-5p2;?X-`kg@SKWY=O2BeRb?hDwqxPlcXDpbBtT42Lb+L!LY^|~YzW57i7 zd9Np(G^8Gxj&;a053jYzeIYqv`^-Ve?dj=vWDC+auI; zi&{o={f!CBXs>t;k~VefG^d|C$>)^K`wF>IIGBcB`i&#m;a)daSOLo^m>{n{{RrJ B@>Bo- literal 0 HcmV?d00001 diff --git a/app/bin/main/butler/filter/Filter.class b/app/bin/main/butler/filter/Filter.class new file mode 100644 index 0000000000000000000000000000000000000000..d5aadbcc6e6e9f6997f01618a11a40fa5f5e81e9 GIT binary patch literal 165 zcmXAjJr06E5QX0$fq zZ{4vyOPL95{|~V1g~mndeiW3XxgIw+t;&~tV7LQtwWgf1 z+`Nt~CN$(2>K0aW)xadC$dxS#aHM#IfO({Gt6)4`+u2mD5 z{13uqJ|wat`e0jdV-=IwPG=s~nhs4JvHeGp3Ur53#VMODl>A+@9(krGL$ex&wYm)U znAEq~UHZCIWe&@HZo3cfVnM@ubgCi#AabR-#-D*j+@zRX-?n8SFkbKj+q7y{sVYr1 zNn%xdb;m5kCiz}0GmiJy?iH3EWH#ssEi#QNknt;-Kt80r!;EEHj>q=f?`HaO8}Dnl zBXI6t&<%Wmf|JYTb+Kv%>*^|AiBf6P;ZdBpmN*7>@MT=~<8mc%xd9dz zslV-M0Cv^^)~vQShQXj$I$Zb$YIrEntJI{#qiS1QxI10lrlD+TT;Rg7Qh}*cjN_#z zWuK3qsu3M;;EbXY<1Fqz%`DDi#PEW zPgcFRF~`&L>>JN!uE&1ez&vM^Ki|`5<@_&eTYTE2!svB_Govc9oU^&@6L+D zcAUhy;~Y3n9I)dgP8@QO!--jtoj8YcI&p62K7aNfkoOY5kgt1YS1TbDy%+7%ba!=i zb#>KO)zvTm=lK@_+=_o_s1R5>lJ`F*iFFH8W;BX+yBY;uPo zFH1(wRp%@xA!kEbE8}u(#y#701hly8c$VXlw9$5KuTP+_HI}f(qht1%nY6N}qj}Fx zMaL3}RChGzW%F?_pS7YpIo@k#di~85OU%xBy=}t+^M>p($CPXWhyM>@8)Jc0a&A5w zx1vL;*=BlXZ=c#IwAD>mHK@d51J|Kmpt7}XxCTqGR6~P6(`+`|YdR)PYv2u7MwQ1b z&o`vNy4EraZcUlFTyNX|H2*vZ+-N|9t|KAd*J@zC-)lFp z05v-1)u0nm4P63lbM}CNo3TcqR{GJjo!lPll)&QhBLpC5J1oVoHLwnEq@{RZfvq#~ z&C&bYQ&yV5>8-(=utCEu0-bYHI#_6+2SjEqF-43Ho2fkEQrFs6X8b^N9kn_P9rJZ8 z5V$U8JJvuxJz`}Km?J4J3dh{InHn~;wj2kj< zbTpTDqK@T7lb)AhA{b}#*~RYmlkp^zjnymtzYqI0+|J0D!vX_CIKW*Al>OFyd2Y4E zO%Pi*6kTMy(cMla@6k(^nI;Z~afgOOwE4AguyfnCn1MTSSfFM!>!$sc0y_g3PLtR+ zN4IQq<9P)|9d`-rKeGQ|Z2Qs3K}Vt?;<*v3mx%Na4Gu(tWEUBAvk^ZhNBjgGaUHU$ zQ%0m_k^3L)ifkTnvmUY8B@K7CfqQT-eXi`0c0FrzB9XOngu#tPi%9eD=4Z%_AGf?< zzPA=5NN9))te7n!sbpkfRG`YrW?km$mKmb6EIRz_gNd*PNgUH)3v^w}@(i-F#9cI) zf#XOK(DF#GODL`3N#-V^Jo+62E*M5tW{!Ym9+X#@A;0V?NZ%{Y_AjHz*0 z$D0L2RO<2;18>FKxFDBF*|f<_UT8Z~=7&<2dOJm|uEid_)4;p%Zh;Dy-fV6yXD&Kz zS~lp_@m@x9aI7KA%*K=QU=paN6C8-3lsF|c<-s122YbK3hB=|6Oy8mk!&21`8u$>- z2+e#&P#MP19aXXWd(I*f4ggor1RN>ccvo5m-M>58Kzm%w$rhq}`b{d=O1lMaOww=2wG{ z#a#(}vI^_!((!phh!vXc==h>QELb!RseV}|9b2+Q+VtYdNG@Z=Z5ksHk@BW$LE&E# zXrEmTS?A?!I`ouO<}1v&lN24#N?)02OUKs*24~i7l7CkHB->Q|bX;UbHJVSQ?vZ9{Nc1{pJ}$}wH^Tp5IekgGuf-;|}_1G4um1K-AX zWNn+tu-cV*=;|d`mluH|%tHmdWZ-+UDA7IF-$KU^CU2B!zPpBfMy!iE$l z2!oqwt6zyT1mw#hLP+MFTt1WGC1fSKB17fz@UnrQ$gCDRVP+i-uLyKsD{osT<5or% z`?=^oGfObBBJc?selBpma*Vur2TK#ov|Pp1HK)RYTFBRdz|C{KJBrs24J~9wF7r}J z1AW(23YFr z)$rG%In?v4qzhxme|oT1;0}xYlEL>{moy(5S>spozY5i;kdFX92rFdquUeM=s%7D? zT9*B)Wznx%*0fki{zYmO#`S>cr@Tsz&$VAdU3*wu#tj#-ygj_)A{y1VNqw8uw?%#1 zI>H?VtUil{?W)&Zzg3phtsKz?*oN)2uI%l=PFiXg`$mbfo0NW1>QQxt0xC5K4V@ZqH!S8K z`SxOfU)r^DkXq6^VuGd`yo`f;&tvgG`*TU(RZm25YljrDJsp)4LsuU*&O-j2> ziu_rnU8i(6m!!j=^OyF78l-mQq=0(G`30Y%l&iczQnM0sMonG_#C$mr^VKP0$XOEe zH6^BbQcR-~)882`u6-_8TlE48cT#%eWn8|5Z%FIC*bw5UfbRxJt5chQzd;(WQHf-y zO$l6}rhYhqA6FoBfzAe9Sc{(q?au-jK1xV|uVEc)2##)oZ!MN%JwbL0qS(OaW)B9@ zi@UIqb#EVGcN<~1iLl#@CpdnFAS)1HFA+?y5Iny}46hM7|HOdMF(_&#j+%2AFseb_pafxNQg!5@?L%{eis@b;{t6 zs^>7={-pSdf#S>fGiAs?>Bqc18vgP+7HLRc;e$+9A+wJoKX5eO${LF;G+kkAhRSDw Xe`Ck%*g=+mVP753@i$7Wz~BE1NtaXg literal 0 HcmV?d00001 diff --git a/app/bin/main/butler/filter/FilterSource.class b/app/bin/main/butler/filter/FilterSource.class new file mode 100644 index 0000000000000000000000000000000000000000..f0b437464de4e675d5aa433e0e4445eb0d075460 GIT binary patch literal 2457 zcmbtWTT>KA7(ERO1IwsL5J5o^Z@XNaMA0NJAt5M2vSMTnNyv5BZFdJ|XK-c~(U|+K zlGl_E@ekz1msG_~k%yGedCUK?VouNOvI_yrR0`R%%J2+f#EIUv2;aU1YktwT`&VPHO{Ne zW0qqD;{xM}bWW}sc`I)gq<7m0@$gBVd!`k&k3~AYR2QdB5$h(K30WlD+JEy(9oi0XLYn9F0dzUIdZmCT$J85bJ6DI zj#Q|rn?SZ3RB9R&?}a#G7YB~c)jdhbl7l+?di-CEXRgEgYXVwW%j z*V~%iGnIW-3KusttZd5es#J%kvODI;H8v8)X!lN)Jq{nMI&LbGV}+0qAGdUj+c7dZ@%L*Ldk^lOHphA-&ttw;Kuo$n^Wd3&p64;dq z%vT7s=T3hFh8OT6SA@lRq^MZU#%N9h|49J!jh)D>alFhOnjQaTX_VmF*~lB#Icq9X5*ZIscKpLQynIFY$pJ6y3#V_?*vg!w>XE3km2)i9y;z wT}A5n5?_(#uX*PrnjWEB!`vhEa_oCdE1ES34HI1Qm!5akF@bM*yaC_-1D`UE5C8xG literal 0 HcmV?d00001 diff --git a/app/bin/main/butler/rule/Rule.class b/app/bin/main/butler/rule/Rule.class new file mode 100644 index 0000000000000000000000000000000000000000..bae75b84c8fa75a6d416d34f195f2f6e6f6d89a1 GIT binary patch literal 9439 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 berm$#L8mnTNBxHkenEKE8ltev(E!tL>sL?- literal 0 HcmV?d00001 diff --git a/app/build.gradle b/app/build.gradle new file mode 100644 index 0000000..24e894e --- /dev/null +++ b/app/build.gradle @@ -0,0 +1,50 @@ +/* + * This file was generated by the Gradle 'init' task. + * + * This generated file contains a sample Java application project to get you started. + * For more details take a look at the 'Building Java & JVM projects' chapter in the Gradle + * User Manual available at https://docs.gradle.org/7.3/userguide/building_java_projects.html + */ + +plugins { + // Apply the application plugin to add support for building a CLI application in Java. + id 'application' +} + +java { + toolchain { + languageVersion = JavaLanguageVersion.of(17) + } +} + +repositories { + // Use Maven Central for resolving dependencies. + mavenCentral() + maven { + url 'https://dogforce-games.com/maven' + } +} + +dependencies { + // Use JUnit Jupiter for testing. + testImplementation 'org.junit.jupiter:junit-jupiter:5.7.2' + + // This dependency is used by the application. + implementation 'net.sf.jopt-simple:jopt-simple:5.0.4' + implementation 'org.apache.logging.log4j:log4j-api:2.20.0' + implementation 'org.apache.logging.log4j:log4j-core:2.20.0' + + implementation 'com.github.jgonian:commons-ip-math:1.32' + + implementation 'dev.gigaherz.util.gddl:gddl2:2.0.0-alpha.2' +} + +application { + // Define the main class for the application. + mainClass = 'butler.App' +} + +tasks.named('test') { + // Use JUnit Platform for unit tests. + useJUnitPlatform() +} diff --git a/app/src/main/java/butler/App.java b/app/src/main/java/butler/App.java new file mode 100644 index 0000000..1dd6f5c --- /dev/null +++ b/app/src/main/java/butler/App.java @@ -0,0 +1,321 @@ +package butler; + +import java.io.IOException; +import java.net.InetSocketAddress; +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.Executors; +import java.util.concurrent.ThreadPoolExecutor; + +import com.sun.net.httpserver.HttpServer; + +import butler.rule.Rule; +import butler.source.SourceData; +import joptsimple.OptionParser; +import joptsimple.OptionSet; + +import com.sun.net.httpserver.HttpExchange; +import com.sun.net.httpserver.HttpHandler; + +import org.apache.logging.log4j.Logger; +import org.apache.logging.log4j.core.config.Configurator; +import org.apache.logging.log4j.Level; +import org.apache.logging.log4j.LogManager; + +import dev.gigaherz.util.gddl2.GDDL; +import dev.gigaherz.util.gddl2.exceptions.ParserException; +import dev.gigaherz.util.gddl2.structure.GddlDocument; +import dev.gigaherz.util.gddl2.structure.GddlElement; +import dev.gigaherz.util.gddl2.structure.GddlList; +import dev.gigaherz.util.gddl2.structure.GddlMap; + +/**************** + * + * Butler + * A webhook filtering and forwarding tool + * + **************** + * + * Behaviour is completely configuration-driven. + * + * The configuration allows you to specify the listening port and URL, as well as an array of rules. + * Rules determine what to do when an incoming webhook is received. + * + * Rules have two components; a list of filters, and a list of actions. + * Filters: + * - Allow you to narrow rules down to their source + * - Allow you to narrow rules down by webhook content + * - Allow you to narrow rules down by (optionally) the context sent by a Github Hookshot. + * + * Actions: + * - Allow you to rewrite webhook content + * - Allow you to forward a webhook via a different URL + * - Allow you to block a webhook so that it is not sent on + * + * Combined, this means that you can create rules that separate organization-wide Github webhooks to multiple Discord channels + * (the reason this project exists) + * or to simply not allow certain webhooks to be sent. + * + **************** + * + * An example rule is provided that redirects Github Webhooks for the TheCurle/butler repository to example.com: + * ``` + * { + * rules: [ + * rule { + * name: "TheCurle/Butler to example.com", + * filters: [ + * source { origin: "github.com" } + * github { user: "TheCurle", repo: "butler" } + * ] + * actions: { + * forward { url: "example.com/" } + * } + * } + * ] + * } + * ``` + * + * An example rule is provided that prevents a custom webhook containing the word "milk" from being forwarded. + * ``` + * { + * rules: [ + * rule { + * name: "filter out milk", + * filters: [ + * content { str: "milk" } + * ] + * actions: [ + * reject {} + * ] + * } + * ] + * } + * ``` + * + **************** + * + * Rules and Names + * + * Rules are required to have names. + * This is an intentional decision designed to make it easier to navigate large configuration files with lots of rules. + * By string-searching the effect that a rule has, you can find the exact code that makes it happen. + * + * This is designed to put maintenance and longevity of the system first, though can seem like a strange and arbitrary decision at first. + * + **************** + * + * Filter and Action Types + * + * Since filters and actions can have different parameters depending on what the type is, the type must be specified before any further parsing. + * This allows for an interesting kind of "dynamic dispatch", where the rest of the rule is parsed based on the type given. + * + * Eventually this will allow for custom types to be specified in addon code, but this is a very far-future idea. + * + **************** + * + * Filtering Conditions + * + * Two "types" of filtering conditions are provided; source and content, with an extra GitHub integration provided. + * + * Source: + * - will attempt to match the URL where the webhook originated. + * the shortcut "github" is provided that matches a user-agent of "Github-Hookshot". + * other content is taken as a substring of the incoming URL. + * for example, if the remote IP has a R-DNS resolution, it will match that. + * Otherwise, the IP is matched directly. + * Content: + * - will attempt to match a substring of the webhook content. + * GitHub: + * github sources have a few shorthands: + * - "repository": matches the NAME of the repository that relates to this Github webhook + * - "user": matches the USER that OWNS THE REPOSITORY that relates to this Github webhook + * - "sender": matches the USER that TRIGGERED this Github webhook + * as an example, the user "octocat" pushing to "torvalds/linux" will have linux as the repository, torvalds as the user, and octocat as the sender. + * + **************** + * + * Actions + * + * There are three main types of action: rewrite, forward, reject. + * + * Rewrite: + * - will replace all instances of a string in the JSON body with another string. + * Forward: + * - will send the webhook as-is to another URL (with an X-Proxy header added) + * Reject: + * - will reject the webhook and close the connection with a 403. + * + */ + +public class App { + + public static String version = "1.0f"; + + private static int DEFAULT_PORT = 6000; + private static String DEFAULT_CONFIG_PATH = "./config.gddl"; + + // The Web server listening for incoming webhook requests + private HttpServer server; + private ThreadPoolExecutor executor; + + // The instance of the HttpHandler that actually redirects the webhooks. + private WebhookHandler handler; + + // The configuration file set by the user, read once at read. + private GddlDocument config; + // The list of rules that set how the program should react to an incoming webhook. + private List rules; + + // The logger for this class + private static Logger logger = LogManager.getLogger(App.class); + + public App(OptionSet options) { + int port = options.has("port") ? (int) options.valueOf("port") : + DEFAULT_PORT; + try { + server = HttpServer.create(new InetSocketAddress("localhost", port), 0); + } catch (IOException e) { + logger.error("[INIT] Failed to bind to port {}, aborting.", port); + System.exit(1); + } + + String path = options.has("config") ? (String) options.valueOf("config") : + DEFAULT_CONFIG_PATH; + try { + config = GDDL.fromFile(path); + parseConfig(); + } catch (ParserException | IOException e) { + logger.error("[INIT] Failed to load configuration file at path {}, aborting.", path); + System.exit(2); + } + + executor = (ThreadPoolExecutor) Executors.newFixedThreadPool(5); + handler = new WebhookHandler(); + + logger.info("[INIT] Registering handler for all incoming webhooks."); + server.createContext("/", handler); + server.setExecutor(executor); + } + + public void begin() { + server.start(); + } + + private void parseSources(List list, GddlElement entry) { + logger.info("[CONF] Reading Sources list.."); + if (!entry.isList()) { + logger.error("[CONF] Sources should be a list. Aborting.."); + System.exit(11); + } + + GddlList sources = entry.asList(); + sources.forEach(source -> { + if (!source.isMap() || source.asMap().hasTypeName() || source.asMap().getTypeName() != "source") { + logger.error("[CONF] Source entry should be a map with type \"source\". Aborting."); + System.exit(12); + } + + SourceData data = SourceData.from(source); + logger.info("[CONF] Adding source {} to list of known hosts.", data.host()); + list.add(data); + }); + } + + private void parseRules(List rules, List sources, GddlElement entry) { + logger.info("[CONF] Reading Rules list.."); + + if (!entry.isList()) { + logger.error("[CONF] Rules should be a list. Aborting..."); + System.exit(17); + } + + GddlList list = entry.asList(); + list.forEach(rule -> { + if (!rule.isMap() || !rule.asMap().hasTypeName() || !rule.asMap().getTypeName().equals("rule")) { + logger.error("[CONF] Rules entry should be a map with type \"rule\". Aborting."); + System.exit(18); + } + + Rule data = Rule.from(rule, sources); + logger.info("[CONF] Adding rule {} to list of active rules.", data.getName()); + rules.add(data); + }); + } + + private void parseConfig() { + GddlElement root = config.getRoot(); + if (!root.isMap() || !root.asMap().containsKey("rules") || !root.asMap().containsKey("sources")) { + logger.error("[INIT] Malformed configuration file! The root element should be a map of rules and sources."); + System.exit(3); + } + + GddlMap cfgList = root.asMap(); + rules = new ArrayList(); + + List sources = new ArrayList<>(); + cfgList.forEach((key, entry) -> { + if (key.equals("sources")) { + parseSources(sources, entry); + } else if (key.equals("rules")) { + parseRules(rules, sources, entry); + } else { + logger.error("[CONF] Unknown entry {} in configuration map. Aborting..", key); + System.exit(10); + } + }); + } + + public static void main(String[] args) { + Configurator.setAllLevels(LogManager.getRootLogger().getName(), Level.INFO); + logger.info("[INIT] Butler v{} starting.", version); + + OptionParser parser = new OptionParser(); + parser.accepts("port").withRequiredArg().ofType(Integer.class); + parser.accepts("config").withRequiredArg(); + + OptionSet opts = parser.parse(args); + + App app = new App(opts); + + int port = opts.has("port") ? (int) opts.valueOf("port") : + DEFAULT_PORT; + + logger.info("[CORE] Listening for webhooks on port {}.", port); + app.begin(); + } + + /** + * The class that actually handles redirecting the webhooks. + * When a new request is received, the handle method is called. + * If the request is a GET, a 403 is returned. + * If the request is a PUT, it is handled as per the config. + * Generally, the webhook is ignored unless a specific flag is set, in which case it is modified and redirected to another server. + * This allows for easy webhook filtering and querying. + */ + class WebhookHandler implements HttpHandler { + + @Override + public void handle(HttpExchange exchange) throws IOException { + logger.debug("[NETW] Incoming Request. {}:{}, from {}.", exchange.getRequestMethod(), exchange.getRequestURI(), exchange.getRemoteAddress()); + if (exchange.getRequestMethod().equals("GET")) { + logger.info("[NETW] Refusing GET request from {}.", exchange.getRemoteAddress()); + exchange.sendResponseHeaders(403, 0); + } else if (exchange.getRequestMethod().equals("POST")) { + logger.info("[NETW] POST from {}.", exchange.getRemoteAddress()); + + for (Rule rule : rules) { + logger.trace("[RULE] Testing rule {} against POST from {}.", rule.getName(), exchange.getRemoteAddress()); + if (rule.tryFilters(exchange)) { + logger.info("[RULE] Rule {} matched. Applying actions.", rule.getName()); + if (!rule.applyActions(exchange)) + return; + } + } + + exchange.sendResponseHeaders(200, 0); + exchange.close(); + } + } + } +} diff --git a/app/src/main/java/butler/action/Action.java b/app/src/main/java/butler/action/Action.java new file mode 100644 index 0000000..ea7b485 --- /dev/null +++ b/app/src/main/java/butler/action/Action.java @@ -0,0 +1,10 @@ +package butler.action; + +import com.sun.net.httpserver.HttpExchange; + +public interface Action { + /** + * Perform the given action against the given HttpExchange. + */ + boolean perform(HttpExchange exc); +} diff --git a/app/src/main/java/butler/action/ForwardAction.java b/app/src/main/java/butler/action/ForwardAction.java new file mode 100644 index 0000000..6b80715 --- /dev/null +++ b/app/src/main/java/butler/action/ForwardAction.java @@ -0,0 +1,109 @@ +package butler.action; + +import java.io.BufferedReader; +import java.io.ByteArrayOutputStream; +import java.io.DataOutputStream; +import java.io.IOException; +import java.io.InputStreamReader; +import java.io.UnsupportedEncodingException; +import java.net.HttpURLConnection; +import java.net.MalformedURLException; +import java.net.ProtocolException; +import java.net.URL; + +import org.apache.logging.log4j.LogManager; +import org.apache.logging.log4j.Logger; + +import com.sun.net.httpserver.HttpExchange; + +import butler.App; +import dev.gigaherz.util.gddl2.structure.GddlMap; + +/** + * Takes the webhook headers and content, and sends it on to another URL. + * An X-Proxy header is added with the value of "Butler" followed by the version number. + */ +public class ForwardAction implements Action { + private Logger logger = LogManager.getLogger(ForwardAction.class); + private String url; + + public ForwardAction(GddlMap map) { + url = map.values().stream().findFirst().get().stringValue(); + } + + @Override + public boolean perform(HttpExchange exc) { + + logger.info("[NETW] Redirecting request from {} (target {}) to {}.", exc.getRemoteAddress().getHostString(), exc.getLocalAddress().getHostName(), url); + + ByteArrayOutputStream result = new ByteArrayOutputStream(); + byte[] buffer = new byte[1024]; + + try { + for (int length; (length = exc.getRequestBody().read(buffer)) != -1; ) { + result.write(buffer, 0, length); + } + } catch (IOException e) { + logger.error("[NETW] Unable to read request body for request from {}. Aborting.", exc.getRemoteAddress().getHostString()); + return false; + } + String content; + try { + content = result.toString("UTF-8"); + } catch (UnsupportedEncodingException e) { + logger.error("[NETW] Unable to read request body for request from {}. Aborting.", exc.getRemoteAddress().getHostString()); + return false; + } + + URL req; + HttpURLConnection conn; + + try { + req = new URL(url); + } catch (MalformedURLException e) { + logger.error("[NETW] Unable to parse destination url {}. Aborting.", url); + return false; + } + + try { + conn = (HttpURLConnection) req.openConnection(); + } catch (IOException e) { + logger.error("[NETW] Unable to open a connection to {}. Aborting.", url); + return false; + } + + try { + conn.setRequestMethod("POST"); + exc.getRequestHeaders().forEach((name, val) -> conn.setRequestProperty(name, val.get(0))); + conn.setRequestProperty("X-Proxy", "Butler " + App.version); + } catch (ProtocolException e) { + logger.error("[NETW] Unable to set request method. Java is broken??"); + return false; + } + conn.setDoOutput(true); + + DataOutputStream out; + try { + conn.setFixedLengthStreamingMode(content.length()); + conn.connect(); + out = new DataOutputStream(conn.getOutputStream()); + out.write(content.getBytes()); + } catch (IOException e) { + logger.error("[NETW] Unable to send a request to target url {}. Aborting.", url); + return false; + } + + try (BufferedReader res = new BufferedReader(new InputStreamReader(conn.getInputStream()))) { + StringBuilder sb = new StringBuilder(); + String line; + while ((line = res.readLine()) != null) + sb.append(line); + + logger.trace("[NETW] POST to {} returned string {}.", url, sb.toString()); + } catch (IOException e) { + logger.error("[NETW] Failed to read response from {}. Aborting.", url); + System.exit(37); + } + return true; + } +} diff --git a/app/src/main/java/butler/action/RejectAction.java b/app/src/main/java/butler/action/RejectAction.java new file mode 100644 index 0000000..d83cdd6 --- /dev/null +++ b/app/src/main/java/butler/action/RejectAction.java @@ -0,0 +1,23 @@ +package butler.action; + +import com.sun.net.httpserver.HttpExchange; + +import butler.rule.Rule; +import dev.gigaherz.util.gddl2.structure.GddlMap; + +/** + * An action that rejects the given webhook. + * Allows active rejection (ie. block IP ranges from making otherwise valid requests). + */ +public class RejectAction implements Action { + + public RejectAction(GddlMap entry) { + } + + @Override + public boolean perform(HttpExchange exc) { + Rule.logger.info("[RULE] Rejecting POST from {}.", exc.getRemoteAddress()); + exc.close(); + return false; + } +} diff --git a/app/src/main/java/butler/filter/Filter.java b/app/src/main/java/butler/filter/Filter.java new file mode 100644 index 0000000..acf2ec9 --- /dev/null +++ b/app/src/main/java/butler/filter/Filter.java @@ -0,0 +1,13 @@ +package butler.filter; + +import com.sun.net.httpserver.HttpExchange; + +public interface Filter { + + /** + * Run the filter against the given HTTP request. + * @param exchange an in-progress HTTP request with all context given. + * @return whether or not the filter matched the request + */ + boolean test(HttpExchange exchange); +} diff --git a/app/src/main/java/butler/filter/FilterContent.java b/app/src/main/java/butler/filter/FilterContent.java new file mode 100644 index 0000000..a138831 --- /dev/null +++ b/app/src/main/java/butler/filter/FilterContent.java @@ -0,0 +1,32 @@ +package butler.filter; + +import java.io.BufferedReader; +import java.io.InputStreamReader; +import java.util.List; +import java.util.stream.Collectors; + +import com.sun.net.httpserver.HttpExchange; + +import butler.rule.Rule; +import butler.source.SourceData; +import dev.gigaherz.util.gddl2.structure.GddlMap; + +/** + * Matches the content of the request body against a given string. + */ +public class FilterContent implements Filter { + + private String content = ""; + + public FilterContent(GddlMap map, List sources) { + content = map.values().stream().findFirst().get().stringValue(); + } + + @Override + public boolean test(HttpExchange exchange) { + Rule.logger.trace("[RULE] Testing content of request against {}.", content); + String body = new BufferedReader(new InputStreamReader(exchange.getRequestBody())).lines().collect(Collectors.joining("\n")); + return body.contains(content); + } + +} diff --git a/app/src/main/java/butler/filter/FilterGithub.java b/app/src/main/java/butler/filter/FilterGithub.java new file mode 100644 index 0000000..7010397 --- /dev/null +++ b/app/src/main/java/butler/filter/FilterGithub.java @@ -0,0 +1,107 @@ +package butler.filter; + +import java.io.IOException; +import java.util.List; + +import org.apache.logging.log4j.LogManager; +import org.apache.logging.log4j.Logger; + +import com.sun.net.httpserver.HttpExchange; + +import butler.source.SourceData; +import dev.gigaherz.util.gddl2.GDDL; +import dev.gigaherz.util.gddl2.exceptions.ParserException; +import dev.gigaherz.util.gddl2.structure.GddlDocument; +import dev.gigaherz.util.gddl2.structure.GddlMap; + +/** + * A Github filter. + * Allows matching by user/repository, sender, and string content of the webhook. + */ +public class FilterGithub implements Filter { + private Logger logger = LogManager.getLogger(FilterGithub.class); + + private String user = ""; + private String sender = ""; + private String repo = ""; + private String action = ""; + private String content = ""; + + public FilterGithub(GddlMap map, List sources) { + if (map.containsKey("user")) + user = map.get("user").stringValue(); + if (map.containsKey("sender")) + sender = map.get("sender").stringValue(); + if (map.containsKey("repo")) + repo = map.get("repo").stringValue(); + if (map.containsKey("action")) + action = map.get("action").stringValue(); + if (map.containsKey("content")) + content = map.get("content").stringValue(); + } + + @Override + public boolean test(HttpExchange exc) { + GddlDocument gddl; + + try { + gddl = GDDL.fromStream(exc.getRequestBody()); + } catch (ParserException | IOException e) { + logger.error("[RULE] Unable to read JSON content for Github Filter on request from {}. Aborting.", exc.getRemoteAddress()); + return false; + } + + GddlMap map = gddl.getRoot().asMap(); + + if (action.length() > 0) { + logger.trace("[RULE] Testing GitHub webhook action.."); + List fields = List.of(action.split("/")[0].split(",")); + String ctx = action.split("/")[1]; + logger.trace("[RULE] Searching for an action {} on {}.", ctx, fields); + + for (String field : fields) { + if (!map.containsKey(field)) { + logger.trace("[RULE] Webhook does not contain field {}, skipping.", field); + return false; + } + } + + if (!map.get("action").stringValue().equals(ctx)) { + logger.trace("[RULE] Webhook is not applying to action {}, skipping.", ctx); + } + } + + if (sender.length() > 0) { + logger.trace("[RULE] Testing Github webhook user.."); + String senderLogin = map.get("sender").asMap().get("login").stringValue(); + if (!senderLogin.equals(sender)) { + logger.trace("[RULE] GitHub webhook sender {} does not match specified user {}, skipping..", senderLogin, sender); + return false; + } + } + + if (repo.length() > 0) { + logger.trace("[RULE] Testing Github webhook repository.."); + String repositoryName = map.get("repository").asMap().get("name").stringValue(); + if (!repositoryName.equals(repo)) { + logger.trace("[RULE] GitHub webhook repository {} does not match specified repo {}, skipping.", repositoryName, repo); + return false; + } + + if (user.length() > 0) { + String repositoryFullName = map.get("repository").asMap().get("full_name").stringValue(); + if (!(user + "/" + repositoryName).equals(repositoryFullName)) { + logger.trace("[RULE] GitHub webhook repository {} does not belong to specified user {}, skipping", repositoryFullName, user); + } + } + } + + if (content.length() > 0) { + logger.warn("[RULE] Github Content filter is unsupported. Skipping."); + } + + + return true; + } + +} diff --git a/app/src/main/java/butler/filter/FilterSource.java b/app/src/main/java/butler/filter/FilterSource.java new file mode 100644 index 0000000..c3d2a82 --- /dev/null +++ b/app/src/main/java/butler/filter/FilterSource.java @@ -0,0 +1,51 @@ +package butler.filter; + +import java.util.List; + +import com.sun.net.httpserver.HttpExchange; + +import butler.source.SourceData; +import dev.gigaherz.util.gddl2.structure.GddlMap; + +/** + * Filter by the source of the webhook. + * The remote address of the request is checked agains the content of the Source Filter. + * Optionally, if the source is a domain, then it is resolved and checked against the incoming URL. + * If a match is found, then the associated action is triggered. + */ +public class FilterSource implements Filter { + private String origin; + private List sources; + + public FilterSource(GddlMap data, List knownSources) { + // The origin can be under any name, but it must be the first (and only) entry in the filter. + origin = data.values().stream().findFirst().get().stringValue(); + sources = knownSources; + } + + public boolean test(HttpExchange exc) { + // Match the literal address, if given. + String addr = exc.getRemoteAddress().getAddress().getHostAddress(); + if (origin.equals(addr)) + return true; + + // If a Reverse DNS ip can be resolved, try that. + String host = exc.getRemoteAddress().getHostName(); + if (!host.equals(addr) && host.equals(origin)) + return true; + + // Also match the Host header. + if (exc.getRequestHeaders().get("Host").get(0).equals(origin)) + return true; + + for (SourceData source : sources) { + // If the literal address doesn't match, try it as a host/nickname in the list of known sources. + if (origin.equals(source.host())) { + return source.test(exc.getRemoteAddress().getHostName()); + } + } + + return false; + } + +} diff --git a/app/src/main/java/butler/rule/Rule.java b/app/src/main/java/butler/rule/Rule.java new file mode 100644 index 0000000..7e0434b --- /dev/null +++ b/app/src/main/java/butler/rule/Rule.java @@ -0,0 +1,190 @@ +package butler.rule; + +import java.lang.reflect.Constructor; +import java.lang.reflect.InvocationTargetException; +import java.util.ArrayList; +import java.util.List; + +import org.apache.logging.log4j.LogManager; +import org.apache.logging.log4j.Logger; + +import butler.action.Action; +import butler.filter.Filter; +import butler.source.SourceData; +import dev.gigaherz.util.gddl2.structure.GddlElement; +import dev.gigaherz.util.gddl2.structure.GddlList; +import dev.gigaherz.util.gddl2.structure.GddlMap; + +import com.sun.net.httpserver.HttpExchange; + +/** + * The core class that encodes the information of a redirect rule. + * A rule contains: + * - A name (for easy identification) + * - A set of conditions (if all are matched, the action is performed) + * - A set of actions + * + * Actions are performed in order; so if a request is dropped and then redirected, the redirect will fail. + * + */ +public class Rule { + // The name of this rule + private String name; + // The list of filters that specify whether the current rule should apply + private List filters; + // The list of actions that should be executed when the current rule applies + private List actions; + + public static Logger logger = LogManager.getLogger(Rule.class); + + public Rule(String name, List filters, List actions) { + this.name = name; + this.filters = filters; + this.actions = actions; + } + + public String getName() { + return name; + } + + /** + * Try all the filters in the rule against the given exchange. + * @param exc an active HttpExchange for an incoming webhook request. + * @return false if any filter failed, true if all filters matched. + */ + public boolean tryFilters(HttpExchange exc) { + for (Filter filter : filters) { + logger.trace("[RULE] ({}) Trying filter {} against {}.", name, filter.getClass().getSimpleName(), exc.getRemoteAddress()); + if (!filter.test(exc)) { + logger.trace("[RULE] Filter failed."); + return false; + } + } + + logger.trace("[RULE] All filters passed for rule {}.", name); + return true; + } + + /** + * Apply all relevant actions of the rule against the given exchange. + */ + public boolean applyActions(HttpExchange exc) { + for (Action action : actions) { + logger.trace("[RULE] ({}) Applying action {} for request from {}.", name, action.getClass().getSimpleName(), exc.getRemoteAddress().getHostName()); + // Terminal actions return false; stop processing if that happens. + if (!action.perform(exc)) + return false; + } + return true; + } + + public static Rule from(GddlElement entry, List sources) { + GddlMap map = entry.asMap(); + if (!map.containsKey("name")) { + Rule.logger.error("[CONF] Rules must have a name. Aborting.."); + System.exit(4); + } + + String name = map.get("name").asValue().stringValue(); + + if (!map.containsKey("filters") && !map.get("filters").isList() ) { + Rule.logger.error("[CONF] Rule {} must have a list of filters. Aborting..", name); + System.exit(5); + } + + List filters = new ArrayList<>(); + GddlList filterList = map.get("filters").asList(); + filterList.forEach(listEntry -> { + if (!listEntry.isMap()) { + Rule.logger.error("[CONF] Entry in the filters list is not a Map. Aborting.."); + System.exit(6); + } + + GddlMap eMap = listEntry.asMap(); + if (!eMap.hasTypeName()) { + Rule.logger.error("[CONF] Entry in the filters list does not have a type. Aborting.."); + System.exit(7); + } + + String filterType = eMap.getTypeName(); + String filterClassName = "butler.filter.Filter" + filterType.substring(0, 1).toUpperCase() + filterType.substring(1); + try { + Class filterClass = Class.forName(filterClassName); + Constructor filterCtor = filterClass.getConstructor(GddlMap.class, List.class); + filters.add((Filter) filterCtor.newInstance(eMap, (List) sources)); + } catch (ClassNotFoundException e) { + Rule.logger.error("[CONF] Filter type {} resolves to {}.class, which does not exist. Aborting..", filterType, filterClassName); + System.exit(8); + } catch (NoSuchMethodException e) { + Rule.logger.error("[CONF] Filter type {} resolves to {}.class, which does not have the correct constructor (String,List). Aborting..", filterType, filterClassName); + System.exit(20); + } catch (SecurityException e) { + Rule.logger.error("[CONF] Filter type {} resolves to {}.class, which could not be instantiated ({}). Aborting..", filterType, filterClassName, e.getMessage()); + System.exit(21); + } catch (InstantiationException e) { + Rule.logger.error("[CONF] Filter type {} resolves to {}.class, which could not be instantiated ({}). Aborting..", filterType, filterClassName, e.getMessage()); + System.exit(22); + } catch (IllegalAccessException e) { + Rule.logger.error("[CONF] Filter type {} resolves to {}.class, which could not be instantiated ({}). Aborting..", filterType, filterClassName, e.getMessage()); + System.exit(23); + } catch (IllegalArgumentException e) { + Rule.logger.error("[CONF] Filter type {} resolves to {}.class, which could not be instantiated ({}). Aborting..", filterType, filterClassName, e.getMessage()); + System.exit(24); + } catch (InvocationTargetException e) { + Rule.logger.error("[CONF] Filter type {} resolves to {}.class, which could not be instantiated ({}). Aborting..", filterType, filterClassName, e.getMessage()); + System.exit(25); + } + }); + + if (!map.containsKey("actions") && !map.get("actions").isList() ) { + Rule.logger.error("[CONF] Rule {} must have a list of actions. Aborting.."); + System.exit(26); + } + + List actions = new ArrayList<>(); + GddlList actionList = map.get("actions").asList(); + actionList.forEach(listEntry -> { + if (!listEntry.isMap()) { + Rule.logger.error("[CONF] Entry in the actions list is not a Map. Aborting.."); + System.exit(27); + } + + GddlMap aMap = listEntry.asMap(); + if (!aMap.hasTypeName()) { + Rule.logger.error("[CONF] Entry in the actions list does not have a type. Aborting.."); + System.exit(28); + } + + String actionType = aMap.getTypeName(); + String actionClassName = "butler.action." + actionType.substring(0, 1).toUpperCase() + actionType.substring(1) + "Action"; + try { + Class actionClass = Class.forName(actionClassName); + Constructor actionCtor = actionClass.getConstructor(GddlMap.class); + actions.add((Action) actionCtor.newInstance(aMap)); + } catch (ClassNotFoundException e) { + Rule.logger.error("[CONF] Action type {} resolves to {}.class, which does not exist. Aborting..", actionType, actionClassName); + System.exit(29); + } catch (NoSuchMethodException e) { + Rule.logger.error("[CONF] Action type {} resolves to {}.class, which does not have the correct constructor (String). Aborting..", actionType, actionClassName); + System.exit(30); + } catch (SecurityException e) { + Rule.logger.error("[CONF] Action type {} resolves to {}.class, which could not be instantiated. Aborting..", actionType, actionClassName); + System.exit(31); + } catch (InstantiationException e) { + Rule.logger.error("[CONF] Action type {} resolves to {}.class, which could not be instantiated. Aborting..", actionType, actionClassName); + System.exit(32); + } catch (IllegalAccessException e) { + Rule.logger.error("[CONF] Action type {} resolves to {}.class, which could not be instantiated. Aborting..", actionType, actionClassName); + System.exit(33); + } catch (IllegalArgumentException e) { + Rule.logger.error("[CONF] Action type {} resolves to {}.class, which could not be instantiated. Aborting..", actionType, actionClassName); + System.exit(34); + } catch (InvocationTargetException e) { + Rule.logger.error("[CONF] Action type {} resolves to {}.class, which could not be instantiated. Aborting..", actionType, actionClassName); + System.exit(35); + } + }); + + return new Rule(name, filters, actions); + } +} diff --git a/app/src/main/java/butler/source/SourceData.java b/app/src/main/java/butler/source/SourceData.java new file mode 100644 index 0000000..b1b4ec0 --- /dev/null +++ b/app/src/main/java/butler/source/SourceData.java @@ -0,0 +1,74 @@ +package butler.source; + +import java.util.ArrayList; +import java.util.List; + +import com.github.jgonian.ipmath.Ipv4; +import com.github.jgonian.ipmath.Ipv4Range; + +import butler.rule.Rule; +import dev.gigaherz.util.gddl2.structure.GddlElement; +import dev.gigaherz.util.gddl2.structure.GddlList; +import dev.gigaherz.util.gddl2.structure.GddlMap; + +/** + * Provides a list of data that can be used to identify webhook sources. + * They are provided in config by a list of strings of form x.y.z.w/a, which encodes a subnet. + * These are mapped to a single domain by name, or alternatively to a nickname. + * + */ +public record SourceData(String host, List subnets) { + + public boolean test(String ip) { + for (String subnet : subnets) { + if (Ipv4Range.from(subnet.split("/")[0]).andPrefixLength(subnet.split("/")[1]).contains(Ipv4.of(ip))) + return true; + } + + return false; + } + + /** + * Create a SourceData from the given GddlMap. + * @param source the GddlMap of a single entry in the "sources" list of the configuration file. + * @return the SourceData representing the single entry given. + */ + public static SourceData from(GddlElement entry) { + if (!entry.isMap()) { + Rule.logger.error("Sources list entry is not a map. Aborting.."); + System.exit(36); + } + + GddlMap source = entry.asMap(); + + if (!source.containsKey("host") || source.containsKey("ranges")) { + Rule.logger.error("Source map should contain a host string and a list of ranges. Aborting.."); + System.exit(13); + } + + if (!source.get("host").isString()) { + Rule.logger.error("Source host should be a string. Aborting.."); + System.exit(14); + } + + if (!source.get("ranges").isList() || source.get("ranges").asList().size() == 0 || !source.get("ranges").asList().get(0).isString()) { + Rule.logger.error("Source ranges should be a non-empty list of Strings. Aborting.."); + System.exit(15); + } + + String host = source.get("host").stringValue(); + List addresses = new ArrayList<>(); + GddlList ranges = source.get("ranges").asList(); + ranges.forEach(range -> { + if (!range.isString()) { + Rule.logger.error("Source range entry should be a string. Aborting.."); + System.exit(16); + } + + addresses.add(range.stringValue()); + }); + + return new SourceData(host, addresses); + } + +} diff --git a/app/src/test/java/butler/AppTest.java b/app/src/test/java/butler/AppTest.java new file mode 100644 index 0000000..dbb0e7e --- /dev/null +++ b/app/src/test/java/butler/AppTest.java @@ -0,0 +1,12 @@ +/* + * This Java source file was generated by the Gradle 'init' task. + */ +package butler; + +import org.junit.jupiter.api.Test; +import static org.junit.jupiter.api.Assertions.*; + +class AppTest { + @Test void appHasAGreeting() { + } +} diff --git a/config.gddl b/config.gddl new file mode 100644 index 0000000..0da256e --- /dev/null +++ b/config.gddl @@ -0,0 +1,23 @@ +{ + sources: [] + rules: [ + rule { + name: "Not in my Christian Minecraft server!", + filters: [ + content { str: "poo" } + ] + actions: [ + reject {} + ] + } + rule { + name: "Test", + filters: [ + source { url: "127.0.0.1" } + ] + actions: [ + forward { url: "https://webhook.site/bd2e20cf-6b52-4134-8387-8b6107455b77" } + ] + } + ] +} \ No newline at end of file diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..7454180f2ae8848c63b8b4dea2cb829da983f2fa GIT binary patch literal 59536 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 QuEJmfE|#`Dqx|px0L@K;Y5)KL literal 0 HcmV?d00001 diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..e750102 --- /dev/null +++ b/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,5 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-7.3-bin.zip +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/gradlew b/gradlew new file mode 100755 index 0000000..1b6c787 --- /dev/null +++ b/gradlew @@ -0,0 +1,234 @@ +#!/bin/sh + +# +# Copyright © 2015-2021 the original authors. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +############################################################################## +# +# Gradle start up script for POSIX generated by Gradle. +# +# Important for running: +# +# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is +# noncompliant, but you have some other compliant shell such as ksh or +# bash, then to run this script, type that shell name before the whole +# command line, like: +# +# ksh Gradle +# +# Busybox and similar reduced shells will NOT work, because this script +# requires all of these POSIX shell features: +# * functions; +# * expansions «$var», «${var}», «${var:-default}», «${var+SET}», +# «${var#prefix}», «${var%suffix}», and «$( cmd )»; +# * compound commands having a testable exit status, especially «case»; +# * various built-in commands including «command», «set», and «ulimit». +# +# Important for patching: +# +# (2) This script targets any POSIX shell, so it avoids extensions provided +# by Bash, Ksh, etc; in particular arrays are avoided. +# +# The "traditional" practice of packing multiple parameters into a +# space-separated string is a well documented source of bugs and security +# problems, so this is (mostly) avoided, by progressively accumulating +# options in "$@", and eventually passing that to Java. +# +# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS, +# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly; +# see the in-line comments for details. +# +# There are tweaks for specific operating systems such as AIX, CygWin, +# Darwin, MinGW, and NonStop. +# +# (3) This script is generated from the Groovy template +# https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt +# within the Gradle project. +# +# You can find Gradle at https://github.com/gradle/gradle/. +# +############################################################################## + +# Attempt to set APP_HOME + +# Resolve links: $0 may be a link +app_path=$0 + +# Need this for daisy-chained symlinks. +while + APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path + [ -h "$app_path" ] +do + ls=$( ls -ld "$app_path" ) + link=${ls#*' -> '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit + +APP_NAME="Gradle" +APP_BASE_NAME=${0##*/} + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + +# Collect all arguments for the java command; +# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of +# shell script including quotes and variable substitutions, so put them in +# double quotes to make sure that they get re-expanded; and +# * put everything else in single quotes, so that it's not re-expanded. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..107acd3 --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,89 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%" == "" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%" == "" set DIRNAME=. +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if "%ERRORLEVEL%" == "0" goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if "%ERRORLEVEL%"=="0" goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 +exit /b 1 + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/settings.gradle b/settings.gradle new file mode 100644 index 0000000..fc747da --- /dev/null +++ b/settings.gradle @@ -0,0 +1,11 @@ +/* + * This file was generated by the Gradle 'init' task. + * + * The settings file is used to specify which projects to include in your build. + * + * Detailed information about configuring a multi-project build in Gradle can be found + * in the user manual at https://docs.gradle.org/7.3/userguide/multi_project_builds.html + */ + +rootProject.name = 'butler' +include('app')