https://github.com/kanchishimono/assam-rs
https://github.com/kanchishimono/assam-rs
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/kanchishimono/assam-rs
- Owner: KanchiShimono
- Created: 2025-08-05T18:08:06.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-08-06T05:49:22.000Z (2 months ago)
- Last Synced: 2025-08-06T07:26:58.835Z (2 months ago)
- Language: Rust
- Size: 47.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# assam-rs
[](https://doc.rust-lang.org/edition-guide/)
[](https://github.com/KanchiShimono/assam-rs/actions/workflows/release.yml)
[](https://github.com/KanchiShimono/assam-rs/actions/workflows/test.yml)
[](https://github.com/KanchiShimono/homebrew-tap)
A CLI tool for AWS SAML authentication via Azure Entra ID.
Rust implementation of the archived [cybozu/assam](https://github.com/cybozu/assam) project.
## Installation
### Homebrew
```bash
brew install kanchishimono/tap/assam
```
### Manual
Download the binary from the [releases page](https://github.com/KanchiShimono/assam-rs/releases)
## Usage
### 1. Initial Setup (first time only)
```bash
assam config
```
Configure your Azure Tenant ID and other settings interactively.
### 2. AWS Authentication
```bash
# Authenticate with default profile
assam
# Authenticate with a different profile (to preserve existing default)
assam -p myprofile
```
> ⚠️ **Important**: This will **overwrite** the specified profile in `~/.aws/credentials`.
> If no profile is specified, `default` will be overwritten.
### 3. Open AWS Console
```bash
assam web
```
## Commands
| Command | Description | Example |
|---------|------|-----|
| `auth` | AWS authentication (default) | `assam` or `assam auth` |
| `config` | Configure profile | `assam config -p prod` |
| `web` | Open AWS console | `assam web -p prod` |
| `completion` | Shell completion | `assam completion bash` |
### Global Options
- `-p, --profile`: Profile name (default: `default`)
- `-v, --verbose`: Verbose logging (`-vv` for debug, `-vvv` for trace)
## Multiple Profiles
```bash
# Create profiles for each environment
assam config -p dev
assam config -p prod
# Authenticate with specific profiles
assam -p dev
assam -p prod
# Use with AWS CLI
aws s3 ls --profile dev
```
## Troubleshooting
### Profile not found
```bash
assam config -p
```
### Authentication fails
- Verify Chrome/Chromium is installed
- Complete authentication within 5 minutes
- Check that your SAML app is correctly configured in Azure Entra ID
### Debugging
```bash
assam -vv auth # Show detailed logs
```
## Configuration File
Stored in `~/.aws/config`:
```ini
[default]
azure_tenant_id = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
app_id_uri = https://signin.aws.amazon.com/saml
default_session_duration_hours = 1
chrome_user_data_dir = ~/.config/assam/chrome-user-data
```