Troubleshooting
If you're prompted to authorize every SSH request
If your experience with authorization prompts in the SSH agent doesn't match the authorization model, and you're prompted to authorize for every SSH request, you can send us an SSH diagnostics report.
You must use a beta or nightly release of the 1Password app to create an SSH diagnostics report.
Step 1: Set up SSH diagnostics recording
To start recording SSH diagnostics, create a directory named ssh-diagnostics
in the 1Password data directory:
- Mac
- Windows
- Linux
Create the new directory at %LOCALAPPDATA%\1Password\ssh-diagnostics
.
After you create the ssh-diagnostics
directory, you can record SSH diagnostics.
Step 2: Run some SSH requests
Run a few SSH requests using your preferred setup and tooling, where you expect to be prompted to authorize once, but are instead prompted for each request.
Each SSH request you run will be logged as a pair of JSON files in the ssh-diagnostics
directory, located at:
- Mac
- Windows
- Linux
Step 3: Create a ZIP file of your ssh-diagnostics
directory
After you've run some SSH requests and recorded some diagnostics information, create a ZIP file of your ssh-diagnostics
directory and then delete the directory:
- Mac
- Windows
- Linux
- Create a ZIP file called
1password-ssh-diagnostics.zip
from the%LOCALAPPDATA%\1Password\ssh-diagnostics
folder. - Delete the original directory to stop recording.
When you delete the ssh-diagnostics
directory, SSH diagnostics recording is disabled.
Step 4: Remove personally identifiable information (PII) from the diagnostics files
The files generated during the SSH diagnostics recording may contain PII, like your OS username, Git repo names, and SSH hosts.
The 1Password app attempts to redact as much of this data as possible and you'll see things like <redacted:username>
, <redacted:git-repo>
, and <redacted:host>
in the generated JSON files.
However, there could still be some PII contained in your diagnostics files. Make sure to check for any information you don't want to include, like a company name that appears as part of a path, and redact it. Then recreate your ZIP file.