Metadata-Version: 2.4
Name: runas-netonly
Version: 1.1.1
Summary: Launch Windows processes with domain credentials using /netonly authentication
Author: Serhii Shtokal
License-Expression: MIT
Project-URL: Repository, https://github.com/sshtokal/runas_netonly
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# runas_netonly

Windows utility to launch processes with domain credentials using `/netonly` authentication.
Passwords are securely stored in Windows Credential Manager (DPAPI-encrypted) -- enter your password once, then never again.

## Features

- Launch any process with alternate domain credentials (netonly mode)
- Credentials stored securely in Windows Credential Manager
- GUI prompt for password entry (tkinter)
- Pure Python, no external dependencies

## Requirements

- Windows 10/11
- Python 3.10+ (for pip install method)
- No external packages required

## Installation

### Option 1: Standalone .exe (no Python required)

Download `runas-netonly.exe` from the [Releases](https://github.com/sshtokal/runas_netonly/releases) page.

### Option 2: pip install from GitHub

```
pip install git+https://github.com/sshtokal/runas_netonly.git
```

### Option 3: pip install from wheel

```
pip install runas_netonly-1.0.0-py3-none-any.whl
```

### Option 4: Development install

```
git clone https://github.com/sshtokal/runas_netonly.git
cd runas_netonly
pip install -e .
```

## Usage

After installation, the `runas-netonly` command is available.

### Launch a process

```
runas-netonly --domain CORP --user jsmith --exe "C:\Windows\System32\mmc.exe"
```

### Store credentials (GUI prompt)

```
runas-netonly --domain CORP --user jsmith --init
```

### Check stored credential

```
runas-netonly --domain CORP --user jsmith --check
runas-netonly --domain CORP --user jsmith --check --reveal
```

### Update stored password

```
runas-netonly --domain CORP --user jsmith --reset
```

### Delete stored credential

```
runas-netonly --domain CORP --user jsmith --delete
```

### Keep window open after launch

```
runas-netonly --domain CORP --user jsmith --exe "ipconfig /all" --pause
```

### Run as a Python module

```
python -m runas_netonly --domain CORP --user jsmith --exe "notepad.exe"
```

## Building the standalone .exe

```
pip install pyinstaller
python build_exe.py
```

Output: `dist/runas-netonly.exe`

## License

MIT
