- Add `show-arguments` recipe documenting all version update commands - Add `complete-update-interactive` recipe for manual confirmations - Maintain `complete-update` as automatic mode (no prompts) - Update `update-help` to reference new recipes and modes - Document 7-step workflow and step-by-step differences Changes: - complete-update: Automatic mode (recommended for CI/CD) - complete-update-interactive: Interactive mode (with confirmations) - show-arguments: Complete documentation of all commands and modes - Both modes share same 7-step workflow with different behavior in Step 4
71 lines
1.2 KiB
Markdown
71 lines
1.2 KiB
Markdown
# MFA Commands Quick Reference
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
# Build plugin
|
|
cargo build --release
|
|
|
|
# Register with Nushell
|
|
plugin add ./target/release/nu_plugin_auth
|
|
plugin use auth
|
|
```
|
|
|
|
## Commands
|
|
|
|
### TOTP Enrollment
|
|
|
|
```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
|
|
|
|
```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
|
|
|
|
```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
|