Before you start
KeySigner macOS build with password-manager import enabled
- Use a local 1Password 8 1PUX export no larger than 16 MiB from a separate 1Password account containing only test data.
- Use a local KeePass 2 XML export no larger than 16 MiB from a test database.
- Use a local KeePassXC 2.8.0 command-line XML export no larger than 16 MiB and choose KeePass XML in KeySigner.
- Check the KeePassXC version
Data and access
Setup steps
Prepare a test code
Save a time-based one-time password (TOTP) for a test service you can still access if the import fails. Use a separate 1Password 8 account containing only test data, or a dedicated test database in KeePass 2 or KeePassXC 2.8.
Check. The source shows a current code for the chosen issuer and test account. The independent recovery option is available.
Export the test data
Save the export in a private folder outside synced storage. A 1Password 8 1PUX can include items from multiple vaults in the selected account. Export files can contain unencrypted passwords and codes.
Choose your export instructions
Check. The export came from your test-only account or database, uses the chosen format, and is stored outside synced folders.
Review and import one code
In KeySigner for Mac, open Accounts, choose Add (+), then Sign-in codes and backup. Unlock and choose Import from a password manager. Choose 1Password 1PUX or KeePass XML. Use KeePass XML for a KeePassXC export too. Select your file, review the test item, then choose Import this code.
1Password test import example - 1Password
- A test login has a one-time password. Its original code stays available.
- KeySigner
- The import review shows the same issuer and account. Stop if either differs.
- Original service
- A fresh code works on that test login. This confirms the copy.
Check. The review shows the expected test account. After import, the account appears in KeySigner’s sign-in code list.
Check the copy and clean up
Use the new KeySigner code on the test service while keeping the original code available. When the test is finished, remove the temporary export. Keep the source account until you have verified access.
Check. The service accepts a fresh KeySigner code and the original copy remains available. Remove the temporary export from the test computer.
Check your result
The test service accepts a KeySigner code for the same account. KeySigner copies supported code fields and leaves the source copy available. Passwords, passkeys and attachments stay with the source password manager.
If you get stuck
The import option or test item is unavailable
Check that you’re using a KeySigner macOS build with Sign-in codes and backup available. Unlock the authenticator, check that the export is a local file no larger than 16 MiB, and confirm the source item has a time-based code. Use 1PUX or XML. For KeePassXC, Steam codes and older code field formats are outside this flow.