https://github.com/passbolt/passbolt-windows
Windows desktop application for Passbolt, the open source password manager for teams!
https://github.com/passbolt/passbolt-windows
credentials passbolt password-manager passwords uwp webview2 windows
Last synced: 6 months ago
JSON representation
Windows desktop application for Passbolt, the open source password manager for teams!
- Host: GitHub
- URL: https://github.com/passbolt/passbolt-windows
- Owner: passbolt
- Created: 2023-04-27T09:41:08.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-27T09:00:54.000Z (8 months ago)
- Last Synced: 2024-08-28T07:38:23.607Z (8 months ago)
- Topics: credentials, passbolt, password-manager, passwords, uwp, webview2, windows
- Language: JavaScript
- Homepage: https://passbolt.com
- Size: 76.5 MB
- Stars: 45
- Watchers: 7
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
The open source password manager for teams.
[](LICENSE.txt)
[](LICENSE.txt)
# Introducing Passbolt
Passbolt is a security-first, open source password manager for teams. It helps organizations centralize, organize and share passwords and secrets securely.
What makes passbolt different?
- **Security:** Passbolt security model features user-owned secret keys and end-to-end encryption. It is audited multiple times annually, and [findings](https://help.passbolt.com/faq/security/code-review) are made public.
- **Collaboration:** Securely share and audit credentials, with powerful and dependable policies for power users.
- **Privacy:** Passbolt is headquartered in the EU,:european_union: specifically in Luxembourg. Passbolt doesn't collect personal data or telemetry, and can be deployed in an air-gapped environment.
# About the desktop app
Passbolt Desktop App is a UWP (Universal Windows Platform) application that provides a modern and flexible way to manage your passwords securely. With Passbolt Desktop App, you can store your passwords and other sensitive information in a centralized location, and you can access them from any Windows 10 device.
The app is built using the UWP platform and it leverages the power of Webview2 to provide a rich and engaging user interface. With Webview2, Passbolt Desktop App can display web-based content within the app, such as the Passbolt web interface, and it can interact with the content programmatically.
By using UWP and Webview2, Passbolt Desktop App provides a consistent and seamless user experience across all Windows 10 devices. The app can adapt to the device it's running on, providing a user interface that's optimized for the screen size and input method of the device. With Passbolt Desktop App, you can manage your passwords securely, and you can do it in a way that's flexible and convenient for you.
# Get Started
## How to install the Windows app
Access the application by clicking on the button below :
## Import an existing passbolt account
After installing the application, you will see instructions on how to download your account kit via the web application. By clicking the ‘Next’ button, you will be guided to the process for uploading your account kit.
Once the account kit is successfully uploaded, your account information, including your username and the URL of the Passbolt server, will be displayed on the screen.
Please review this information carefully before proceeding. Once your passphrase is validated, the setup of your account will be complete, and you will be able to access the password workspace.
# Development
## Requirements
- Visual Studio >= 2019 ([download](https://visualstudio.microsoft.com/downloads/))
- Visual Studio UWP workload
- Edge ([download](https://developer.microsoft.com/en-us/microsoft-edge/webview2/))
- Passbolt API >= v4.2.0
## Clone the project
```bash
git clone [email protected]:passbolt/passbolt-windows
```
## Configure the API
Enable the desktop application support in the API.
If you are running passbolt with docker, set to `true` the environment variable `PASSBOLT_PLUGINS_DESKTOP_ENABLED`
Otherwise, edit your `/etc/passbolt/passbolt.php` to add the following:
```php
return [
"passbolt" => [
"plugins" => [
"desktop" => [
"enabled" => true
]
]
]
]
```
## Start the application with Visual Studio
Start Visual studio and open the project folder.
Click to the start button in the top menu, et voilà.
## Trouble shooting
- I have started the application, visual studio failed when calling API.
In case you the API is using a self signed certificate, you need Windows to trust it. Checkout this [documentation](https://learn.microsoft.com/en-us/skype-sdk/sdn/articles/installing-the-trusted-root-certificate).
## Running tests
### Running tests with Visual code
Passbolt Desktop App includes a suite of unit tests to ensure that the app functions correctly. To run the unit tests, follow these steps:
1. Open the solution in Visual Studio.
2. In the Solution Explorer, right-click on the `PassboltDesktopApp.UnitTests` project and select "Run Tests".
3. The unit tests will run, and the results will be displayed in the Test Explorer.
### Running tests with command lines
To run the Passbolt Desktop App unit tests using the command line, you can use the dotnet test command. Follow these steps to run the tests using the command line:
1. Open a command prompt and navigate to the project directory.
2. Run the following command to restore the NuGet packages:
``MSBuild /t:Restore``
3. Run the following command to build the solution:
``MSBuild /t:Build /p:Configuration=Release``
4. Run the following command to run the unit tests:
``MSBuild /t:VSTest /p:VSTestPath= /p:VSTestArguments="/Settings: /Logger:trx" /p:Configuration=Release``
This command runs the unit tests in Release mode and generates a test results file named PassboltDesktopApp.UnitTests.trx.
After the tests complete, you can view the results in Visual Studio or any other tool that supports TRX format.
## Checking for Outdated .NET NuGet Dependencies in Visual Studio
1. Open your project in Visual Studio.
2. In the Solution Explorer, right-click on the project and select "Manage NuGet Packages".
3. In the NuGet Package Manager, click on the "Updates" tab to see a list of all available updates for your NuGet packages.
4. You can use this information to determine if any of your NuGet packages need to be updated.