Fixed Support Center Header - Freshdesk Template
Troubleshooting Octopus Issues - Secret Double Octopus
?

Support Specialist – Troubleshooting Octopus components

This page will list main components with troubleshooting steps.

Use this list for resolving user issues, authentication problems, and client-side troubleshooting.

Systematic Troubleshooting Process

  1. Identify Issue – Start by clearly defining the problem.
  2. Gather Information – Collect logs, population effected, error codes, and user reports and audit.
  3. Isolate Cause – Narrow down to the root cause (network, directory, service, authenticator).
  4. Apply Solution – Implement corrective actions based on findings.
  5. Verify & Document – Confirm resolution and record steps for future reference. 

Device & Access Troubleshooting

  • Authenticator Not Responding: Check device status, app version, re-enroll if needed.
  • FIDO Key Issues: Verify registration, browser support, and hardware integrity.
  • Workstation Blocked: Authentication logs, unblock device, educate user for workstation protection, push fatigue.
  • Access Problems: Confirm service assignment, directory association, user status, and published changes. 

Organizational Best Practices

  • Use Groups for efficient management.
  • Maintain accurate user info (emails, phone numbers).
  • Standardize naming conventions.
  • Perform weekly reviews and monthly audits

Security Best Practices

  • Conduct regular access reviews.
  • Block and Disable users immediately upon departure.
  • Document all bypass reasons, timeline and other information around it.
  • Monitor shared account activity.
  • Maintain detailed audit logs. 

Enrollment Best Practices

  • Streamline enrollment process.
  • Enable multiple options (Authenticator, FIDO2, Voice PIN, OTP).
  • Monitor progress and maintain audit logs. 

Critical Reminders

  • Always publish changes after modifications.
  • Only active users can authenticate.
  • Groups save time.
  • Document everything. 

General Points of Failure

  • Network: Latency or blocks affect authentication.
  • Active Directory: Ensure stability and proper sync.
  • Services: Must use agreed protocols (SAML, OIDC, WS-FED).
  • RADIUS/LDAP: Agents must communicate properly.
  • Authenticators: Plugins must be connected and functional. 

Essential Services & Health Checks

  • Regularly monitor service health via Management Console.
  • Validate configurations and sanity checks.
  • Collect logs from servers and clients (Windows Agent, Remote AD, RADIUS Agent, LDAP Proxy).
  • For networking issues, gather firewall and DNS logs. 
Footer - Secret Double Octopus