https://github.com/djmoore711/awsauth
An intuitive CLI tool for managing AWS IAM user credentials. Features include health checks for profiles, access key rotation, and password change utilities, streamlining AWS security practices.
https://github.com/djmoore711/awsauth
access-control aws cli credentials iam password-management re security
Last synced: 3 months ago
JSON representation
An intuitive CLI tool for managing AWS IAM user credentials. Features include health checks for profiles, access key rotation, and password change utilities, streamlining AWS security practices.
- Host: GitHub
- URL: https://github.com/djmoore711/awsauth
- Owner: djmoore711
- Created: 2025-07-18T20:33:22.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-18T21:25:33.000Z (3 months ago)
- Last Synced: 2025-07-19T02:02:47.118Z (3 months ago)
- Topics: access-control, aws, cli, credentials, iam, password-management, re, security
- Language: Python
- Homepage:
- Size: 11.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AWS Auth CLI
A command-line tool to manage AWS IAM user credentials.
## Quick Start
### Download Standalone Executable
For macOS, download the executable directly from our GitHub Releases:
[**Download awsauth for macOS (v0.1.0)**](https://github.com/djmoore711/awsauth/releases/download/v0.1.0/awsauth)
Once downloaded, move the `awsauth` executable to a directory included in your system's `PATH` (e.g., `/usr/local/bin`).
### Installation (Building from Source)
To use the `awsauth` CLI by building it from source (an alternative to downloading the standalone executable):
1. **Clone the repository:**
```bash
git clone https://github.com/djmoore711/awsauth.git
cd awsauth
```
2. **Create and activate a virtual environment:**
```bash
python3 -m venv .venv
source .venv/bin/activate
```
3. **Install dependencies:**
```bash
.venv/bin/pip install .
```
### Usage
Once installed, open your terminal and run:
```bash
awsauth --help
```
This will display the available commands. For detailed help on any command, use `awsauth --help`.
**Examples:**
* **Check all profiles:**
```bash
awsauth check
```
or
```bash
awsauth check all
```
* **Check a specific profile:**
```bash
awsauth check default
```
* **Get status of all profiles:**
```bash
awsauth status
```
* **Get status of a specific profile:**
```bash
awsauth status default
```
### Uninstallation
To uninstall `awsauth` when installed from source, deactivate your virtual environment and remove the project directory:
```bash
deactivate # if your virtual environment is active
rm -rf ~/Code/awsauth
```
If you installed a standalone executable, simply remove the executable file from your system.
1. **Locate the executable:** Find where you placed the `awsauth` executable (e.g., `/usr/local/bin/awsauth`).
2. **Delete the file:**
* **macOS/Linux:**
```bash
rm /path/to/awsauth
```
* **Windows:** Delete the `awsauth.exe` file from File Explorer, or use the `del` command in Command Prompt:
```cmd
del C:\path\to\awsauth.exe
```
**Caution:** Be careful when using `rm` or `del` as they permanently delete files. Ensure you are deleting the correct file.