Skip to main content

signaloid-cli users

Manage user account and settings.

Synopsis​

signaloid-cli users <command> [options]

Description​

The users command group provides commands to view and manage your Signaloid user account, update profile information, view activity logs, and manage active sessions.

Subcommands​

  • me - Display current user information
  • update - Update user profile information
  • logs - View account activity logs
  • logout-all - Logout from all active sessions

Account Information​

View Account Summary​

#!/bin/bash

echo "=== Account Summary ==="
USER_INFO=$(signaloid-cli users me)

echo "Name: $(echo $USER_INFO | jq -r '.name')"
echo "Email: $(echo $USER_INFO | jq -r '.email')"
echo "Plan: $(echo $USER_INFO | jq -r '.plan')"
echo "Member since: $(echo $USER_INFO | jq -r '.createdAt')"
echo ""

echo "=== Recent Activity ==="
signaloid-cli users logs --limit 5 | \
  jq -r '.logs[] | "\(.timestamp)\t\(.action)"'

Monitor Login Activity​

#!/bin/bash
# Check for suspicious login activity

signaloid-cli users logs --limit 50 | \
  jq -r '.logs[] | select(.action == "auth.login") | "\(.timestamp)\t\(.ipAddress)"' | \
  sort -u | \
while read TIMESTAMP IP; do
  echo "Login from $IP at $TIMESTAMP"
done

Security Features​

Activity Monitoring​

#!/bin/bash
# Daily activity summary

echo "Activity for $(date -d 'yesterday' +%Y-%m-%d):"

FROM=$(date -d 'yesterday' -u +"%Y-%m-%dT00:00:00Z")
TO=$(date -d 'yesterday' -u +"%Y-%m-%dT23:59:59Z")

signaloid-cli users logs --from $FROM --to $TO | \
  jq -r '.logs[] | .eventType' | \
  sort | uniq -c | sort -rn

Exit Codes​

CodeDescription
0Success
1Error (authentication failed, invalid parameters)

Tips & Tricks​

Export Activity Report​

#!/bin/bash
# Generate monthly activity report

MONTH=$(date +%Y-%m)
FROM="${MONTH}-01T00:00:00Z"
TO="$(date -d "$(date +%Y-%m-01) +1 month -1 day" -u +%Y-%m-%dT23:59:59Z)"

signaloid-cli users logs --from $FROM --to $TO > "activity-${MONTH}.json"

echo "Activity report saved to activity-${MONTH}.json"

# Generate summary
jq -r '.logs[] | .action' "activity-${MONTH}.json" | \
  sort | uniq -c | sort -rn > "summary-${MONTH}.txt"

echo "Summary saved to summary-${MONTH}.txt"

Troubleshooting​

"Not authenticated" Error​

Problem: Cannot access user information.

Solutions:

  1. Login first: signaloid-cli auth login
  2. Verify authentication: signaloid-cli auth whoami
  3. Check API key is valid
  4. Ensure not logged out

Empty Logs​

Problem: No activity logs returned.

Solutions:

  1. Expand date range
  2. Remove limit parameter
  3. Check if account is new
  4. Verify authentication

See Also​

Learn More​

Last updated on