Skip to content
This repository has been archived by the owner on Jun 10, 2024. It is now read-only.

Commit

Permalink
Update README.md (#183)
Browse files Browse the repository at this point in the history
- Make troubleshooting topics linkable.
- Add note that the internal decryption mechanism is currently broken.
  • Loading branch information
AndreasNasman authored Nov 17, 2023
1 parent 805639f commit 30541fb
Showing 1 changed file with 18 additions and 7 deletions.
25 changes: 18 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,12 @@
- [Contributors](#contributors)
- [Source that helped me to get started](#source-that-helped-me-to-get-started)
- [Troubleshooting](#troubleshooting)
- ["bitwarden-alfred-workflow" cannot be opened because the developer cannot be verified.](#bitwarden-alfred-workflow-cannot-be-opened-because-the-developer-cannot-be-verified)
- [Workaround](#workaround)
- [Unexpected error. Exit code -1.](#unexpected-error-exit-code--1)
- [Workaround](#workaround-1)
- [Getting a secret still takes very much time](#getting-a-secret-still-takes-very-much-time)
- [Workaround](#workaround-2)

## Features

Expand Down Expand Up @@ -245,31 +251,36 @@ A big thanks to all code contributors but also to everyone who creates issues an

# Troubleshooting

- "I'm seeing the following dialog when running the workflow"
## "bitwarden-alfred-workflow" cannot be opened because the developer cannot be verified.

The following dialog can appear when running the workflow:

![image](./assets/catalina-warning.png)

**Workaround:**
### Workaround

Per [the installation steps](https://github.com/blacs30/bitwarden-alfred-workflow#installation), you **_MUST_** add Alfred to the list of Developer Tool exceptions for Alfred to run any workflow that contains an executable (like this one)

- Using `bw` cli and this workflow in parallel can possibly cause this error occurs `Unexpected error. Exit code -1.`
## Unexpected error. Exit code -1.

Using `bw` cli and this workflow in parallel can possibly cause this error occurs `Unexpected error. Exit code -1.`
The reason for that is when the `bw` cli is used in the terminal and the password is entered that a new session is initiated and the workflow's session invalidated.

**Workaround:**
### Workaround

You can use the bash functions created by @luckman212 and located [here in github](https://github.com/luckman212/bitwarden-cli-helpers)<br>
Download the bash file and source it in your own `.bash_profile` or `.zshrc`

- Getting a secret still takes very much time
## Getting a secret still takes very much time

**NB: The workflow's internal decryption mechanism is currently not working. Follow [issue 171](https://github.com/blacs30/bitwarden-alfred-workflow/issues/171) for progress on this issue.**

With version 2.2.0 this workflow decrypts the secrets without using the `bw` cli. This is much faster but it might possibly can fail.<br>
If it fails it falls back and uses the `bw` cli to get the secret. The decryption takes then more time again, was in the previous versions.<br>

**Workaround:**
### Workaround

To use the workflows faster decryption you can [follow this instruction by Bitwarden](https://bitwarden.com/help/article/update-encryption-key/)) <br>
To use the workflows faster decryption you can [follow this instruction by Bitwarden](https://bitwarden.com/help/kdf-algorithms/#low-kdf-iterations) <br>
to update the encryption keys to the new mechanism.

The linked doc doesn't specify how to force creation of a new key. It's easy though:
Expand Down

0 comments on commit 30541fb

Please sign in to comment.