online-auth
Secure online authentication client for Kodachi OS
Version: 9.0.1 | Size: 7.7MB | Author: Warith Al Maawali
License: Proprietary | Website: https://digi77.com
File Information
| Property | Value |
|---|---|
| Binary Name | online-auth |
| Version | 9.0.1 |
| Build Date | 2025-09-23T19:20:03.458488875Z |
| Rust Version | 1.82.0 |
| File Size | 7.7MB |
| JSON Data | View Raw JSON |
SHA256 Checksum
Features
| Feature | Description |
|---|---|
| Feature | Secure authentication with certificate pinning |
| Feature | Session management with automatic heartbeat |
| Feature | API key synchronization |
| Feature | User group and status checking |
| Feature | Comprehensive logging and error handling |
| Feature | Multi-language architecture integration |
| Feature | TLS 1.3 encrypted communications |
| Feature | Real-time status monitoring |
| Feature | Automatic retry mechanisms |
Security Features
| Feature | Description |
|---|---|
| Authentication | Secure authentication with certificate pinning |
| Encryption | TLS 1.3 for all network communications |
| Inputvalidation | All inputs are validated and sanitized |
| Ratelimiting | Built-in rate limiting for network operations |
System Requirements
| Requirement | Value |
|---|---|
| OS | Linux (Debian-based) |
| Privileges | root/sudo for system operations |
| Dependencies | OpenSSL, libcurl |
Global Options
| Flag | Description |
|---|---|
-h, --help |
Print help information |
-v, --version |
Print version information |
-n, --info |
Display detailed information |
-e, --examples |
Show usage examples |
--json |
Output in JSON format |
--json-pretty |
Pretty-print JSON output with indentation |
--json-human |
Enhanced JSON output with improved formatting (like jq) |
--verbose |
Enable verbose output |
--quiet |
Suppress non-essential output |
--no-color |
Disable colored output |
--config <FILE> |
Use custom configuration file |
--timeout <SECS> |
Set timeout (default: 30) |
--retry <COUNT> |
Retry attempts (default: 3) |
Commands
API Management
sync-api-key
Manually sync API key with server
Usage:
Examples:
Authentication
authenticate
Authenticate with the server
Usage:
Examples:
check-login
Check if currently logged in
Usage:
Examples:
logout
End the current session
Usage:
Examples:
check-if-blocked
Check if user ID is blocked
Usage:
Examples:
get-ids
Show user and session IDs
Usage:
Examples:
check-all-status
Show all status information at once
Usage:
Examples:
Heartbeat
send-heartbeat
Send a single heartbeat
Usage:
Examples:
send-heartbeat-with-retry
Send heartbeat with retry
Usage:
Examples:
start-heartbeat
Start automatic heartbeat service
Usage:
Examples:
stop-heartbeat
Stop automatic heartbeat service
Usage:
Examples:
check-heartbeat
Check if heartbeat service is running
Usage:
Examples:
Information
get-card
Get user card URL
Usage:
Examples:
which-group
Check which user group you belong to (VIP = premium)
Usage:
Examples:
Permission Guard
enable-permission-guard
Enable permission guard daemon to monitor and fix file permissions
Usage:
Examples:
disable-permission-guard
Disable permission guard daemon
Usage:
Examples:
permission-guard-status
Check permission guard daemon status
Usage:
Examples:
Examples
Authentication Management
Basic authentication operations
Authenticate with the server
Expected Output: Authentication successfulAuthenticate with JSON output
Expected Output: JSON response with authentication statusAuthenticate and enable auto-heartbeat
Expected Output: Authentication successful with heartbeat enabledCheck if currently logged in
Expected Output: Login status displayedEnd the current session
Expected Output: Successfully logged outCheck if user ID is blocked
Expected Output: Block status displayedShow all status information
Expected Output: Complete status information displayedUser Information
Identity and account information
Show user and session IDs
Expected Output: User ID and session ID displayedGet IDs in JSON format
Expected Output: JSON with user and session IDsCheck user group (VIP = premium)
Expected Output: User group displayedGet user card URL
Expected Output: User card URL displayedHeartbeat Management
Session keepalive and heartbeat operations
Send a single heartbeat
Expected Output: Heartbeat sent successfullySend heartbeat with retry logic
Expected Output: Heartbeat sent with retry if neededStart automatic heartbeat service
Expected Output: Heartbeat service startedStop automatic heartbeat service
Expected Output: Heartbeat service stoppedCheck if heartbeat service is running
Expected Output: Heartbeat service status displayedPermission Guard Management
Control permission guard daemon for file permission monitoring
Start permission guard daemon to monitor file permissions
Expected Output: Permission guard daemon enabled successfullyNote
Ensures files maintain correct ownership and prevents root-owned files in user directories
Stop permission guard daemon
Expected Output: Permission guard daemon disabled successfullyNote
Stops automatic permission monitoring and correction
Check if permission guard daemon is running
Expected Output: Permission guard daemon is running/not runningEnable permission guard with JSON output
Expected Output: {"status": "success", "message": "Permission guard daemon enabled", "is_running": true}Note
Useful for automation scripts and monitoring
Get permission guard status in JSON format
Expected Output: {"status": "success", "message": "Permission guard daemon is running", "is_running": true}API Management
API key synchronization and management
Manually sync API key with server
Expected Output: API key synchronized successfullySync API key with JSON output
Expected Output: JSON response with sync statusProgram Information
Version and program details
Show version number
Expected Output: online-auth version 9.0.1Show detailed program information
Expected Output: Detailed information about online-authShow help information
Expected Output: Help text with all commandsShow usage examples
Expected Output: This examples outputWorkflow Combinations
Complete authentication workflows
Authenticate and check group
Expected Output: Authentication followed by group infoNote
Useful for setup scripts
Auth with heartbeat and get card
Expected Output: Authentication with heartbeat, then card URLCheck login or authenticate if needed
Expected Output: Login status or authenticationNote
Ensures authenticated state
Troubleshooting
Debug and error resolution
Check connection status
Expected Output: JSON with detailed connection infoRefresh API credentials
Expected Output: API key refreshedNote
Use when authentication fails
Reset authentication
Expected Output: Fresh authentication sessionRestart heartbeat service
Expected Output: Heartbeat service restartedAdvanced Options
Global configuration options (provided by cli-core)
Set 30 second timeout
Expected Output: Authentication with custom timeoutNote
Global option - applies to network operations
Use custom port
Expected Output: Note: Port configuration may not apply to all operationsNote
Global option - for services that support custom ports
Enable debug logging
Expected Output: Authentication with debug outputNote
Global option - useful for diagnosing issues
JSON Output
Working with JSON formatted responses
Extract status from JSON
Expected Output: "success" or "error"Extract user ID from JSON
Expected Output: User ID valueGet all status data as JSON
Expected Output: Complete status objectNote
Useful for monitoring scripts
Environment Variables
| Variable | Description | Default | Values |
|---|---|---|---|
RUST_LOG |
Set logging level | info | error |
NO_COLOR |
Disable all colored output when set | unset | 1 |
Exit Codes
| Code | Description |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Invalid arguments |
| 3 | Permission denied |
| 4 | Network error |
| 5 | File not found |