nushell-plugins/nu_plugin_auth/readme-mfa.md

# MFA Commands Quick Reference

## Installation

```nushell
bash
# Build plugin
cargo build --release

# Register with Nushell
plugin add ./target/release/nu_plugin_auth
plugin use auth
```

## Commands

### TOTP Enrollment

```nushell
bash
# Enroll with QR code
auth mfa enroll totp

# For specific user
auth mfa enroll totp --user alice

# Custom Control Center URL
auth mfa enroll totp --url http://control.example.com:8081
```

**Output**: QR code + secret + backup codes

### TOTP Verification

```nushell
bash
# Verify code
auth mfa verify --code 123456

# For specific user
auth mfa verify --code 123456 --user alice
```

**Output**: `{valid: true/false, message: "..."}

## Complete Workflow

```nushell
bash
# 1. Login
auth login admin --save

# 2. Enroll MFA
auth mfa enroll totp
# Scan QR code with Google Authenticator or Authy

# 3. Verify code from app
auth mfa verify --code 123456
```

## Documentation

- **Full Documentation**: `MFA_IMPLEMENTATION_SUMMARY.md`
- **Verification Report**: `VERIFICATION.md`
- **Examples**: `examples/mfa_workflow.nu`

## Status

✅ **Complete and Ready for Testing**

- Binary: `target/release/nu_plugin_auth` (11MB)
- Commands: 6 total (2 new MFA commands)
- Build: Success (28.58s)
- Dependencies: totp-rs 5.7, qrcode 0.14