AsyncRemoteShell/PKG-INFO at main · mauricelambert/AsyncRemoteShell · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
Metadata-Version: 2.1
Name: AsyncRemoteShell
Version: 0.1.1
Summary: This package implement 4 asynchronous tools to execute remote commands
Home-page: https://github.com/mauricelambert/AsyncRemoteShell
Author: Maurice Lambert
Author-email: mauricelambert434@gmail.com
License: UNKNOWN
Description: # AsyncRemoteShell

        ## Description
        This package implement 4 tools for asynchronous remote commands :
        - ReverseShellClient
        - ReverseShellServer
        - ShellClient
        - ShellServer

        ## Requirements
        This package require :
        - python3
        - python3 Standard Library

        ## Installation

        ```bash
        pip install AsyncRemoteShell
        ```

        ## Usages

        ### Commands

        #### ReverseShell

        ```bash
        ReverseShellClient
        ReverseShellClient --interface=127.0.0.1 --port=45678
        ReverseShellServer
        ReverseShellServer -i=localhost -p=45678
        ```

        #### Shell

        ```bash
        ShellClient
        ShellClient -i=10.0.0.2 --port=56789
        ShellServer
        ShellServer --interface= -p=56789
        ```

        ### Python package commands

        ```bash
        python3 -m AsyncRemoteShell ShellServer
        python3 -m AsyncRemoteShell ShellClient

        python3 -m AsyncRemoteShell ShellServer -i=localhost -p=3456
        python3 -m AsyncRemoteShell ShellClient --interface=localhost --port=3456

        python3 -m AsyncRemoteShell.ShellServer
        python3 -m AsyncRemoteShell.ShellClient

        python3 -m AsyncRemoteShell.ShellServer --interface=localhost --port=3456
        python3 -m AsyncRemoteShell.ShellClient -i=localhost -p=3456

        python3 -m AsyncRemoteShell ReverseShellServer
        python3 -m AsyncRemoteShell ReverseShellClient

        python3 -m AsyncRemoteShell ReverseShellServer -i=localhost -p=3456
        python3 -m AsyncRemoteShell ReverseShellClient --interface=localhost --port=3456

        python3 -m AsyncRemoteShell.ReverseShellServer
        python3 -m AsyncRemoteShell.ReverseShellClient

        python3 -m AsyncRemoteShell.ReverseShellServer --interface=localhost --port=3456
        python3 -m AsyncRemoteShell.ReverseShellClient -i=localhost -p=3456
        ```

        ### Python executable

        Same commands than python package `python3 -m AsyncRemoteShell <MODULE> [OPTIONS]`.

        ```bash
        python3 AsyncRemoteShell.pyz ShellServer

        chmod u+x AsyncRemoteShell.pyz
        ./AsyncRemoteShell.pyz ShellClient -i=localhost --port=45678
        ```

        ### Python3

        #### ReverseShell

        Client:
        ```python
        from AsyncRemoteShell import ReverseShellClient
        import asyncore
        ReverseShellClient("10.0.0.2", 45678) # host and port is required
        asyncore.loop()
        ```

        Server:
        ```python
        from AsyncRemoteShell import ReverseShellServer
        import asyncore
        ReverseShellServer("", 45678) # interface and port is required
        asyncore.loop()
        ```

        #### Shell

        Client:
        ```python
        from AsyncRemoteShell import ShellClient
        import asyncore
        ShellClient("10.0.0.2", 45678) # host and port is required
        asyncore.loop()
        ```

        Server:
        ```python
        from AsyncRemoteShell import ShellServer
        import asyncore
        ShellServer("", 45678) # interface and port is required
        asyncore.loop()
        ```

        ## Why Asynchronous Shell

        You can install this package on Windows and execute this script:
        ```python
        from time import perf_counter
        from os import system
        t1 = perf_counter(); system('powershell -c "Get-PSDrive" & netstat & systeminfo'); t2 = perf_counter()
        print(f"Execution time : {t2 - t1} s")
        ```

        Launch `ShellServer` with command line and launch `ShellClient -i=localhost -p=45678` and write: `powershell -c "Get-PSDrive" & netstat & systeminfo`.

        Compare execution time.

        ## Links
         - [AsyncRemoteShell Github Page](https://github.com/mauricelambert/AsyncRemoteShell)
         - [ReverseShellServer Documentation](https://mauricelambert.github.io/info/python/security/AsyncRemoteShell/ReverseShellServer.html)
         - [ReverseShellClient Documentation](https://mauricelambert.github.io/info/python/security/AsyncRemoteShell/ReverseShellClient.html)
         - [ShellServer Documentation](https://mauricelambert.github.io/info/python/security/AsyncRemoteShell/ShellServer.html)
         - [ShellClient Documentation](https://mauricelambert.github.io/info/python/security/AsyncRemoteShell/ShellClient.html)
         - [commons Documentation](https://mauricelambert.github.io/info/python/security/AsyncRemoteShell/commons.html)
         - [Download as python executable](https://mauricelambert.github.io/info/python/security/AsyncRemoteShell.pyz)
         - [Pypi package](https://pypi.org/project/AsyncRemoteShell/)

        ## Licence
        Licensed under the [GPL, version 3](https://www.gnu.org/licenses/).

Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Security
Classifier: Topic :: System :: Shells
Classifier: Topic :: System :: Networking
Requires-Python: >=3.6
Description-Content-Type: text/markdown