https://github.com/cyberfantics/remote-service

https://github.com/cyberfantics/remote-service

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/cyberfantics/remote-service
• Owner: cyberfantics
• Created: 2024-07-17T15:45:03.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2024-07-17T15:49:39.000Z (6 months ago)
• Last Synced: 2024-07-17T19:30:17.050Z (6 months ago)
• Language: Python
• Size: 5.86 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Remote Service Utility

## Overview

The Remote Service Utility is a Python script designed by Syed Mansoor ul Hassan Bukhari to enable administrative shares on a remote Windows computer, execute a specified script remotely, and manage network connections. This script leverages Python's **`winreg`** and **`os`** modules to interact with the Windows registry and manage network connections.

## Features

- **Enable Admin Share**: Modifies the registry on the remote computer to enable administrative shares.

- **Access Admin Share**: Copies a specified executable script to the administrative share (`C$` by default), executes it remotely, and then removes the network connection.

- **Administrative Privileges Check**: Ensures the script is run with administrative privileges (`IsUserAnAdmin()` function).

- **Logging**: Uses Python's `logging` module to record events and errors.

## Usage

### Prerequisites

- Python 3.x installed on the local machine.

- Administrative privileges on the local machine and remote computer.

### Setup

1. Clone the repository:

```bash

  git clone https://github.com/cyberfantics/remote-service.git

  cd remote-service

```

2. Run:

```bash

    python remoteService.py  

```

**Replace  with the name or IP address of the remote computer and  with the name of the Python script to be executed remotely.**

## Notes

- Ensure both the local and remote machines are on the same network and accessible.

- Administrative privileges are required to modify the registry and manage network connections.

## Example

```bash

  python remote_service.py RemotePC my_script.py

```