Awesome
<picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/passbolt/passbolt_styleguide/blob/master/src/img/logo/logo_white.svg"> <source media="(prefers-color-scheme: light)" srcset="https://github.com/passbolt/passbolt_styleguide/blob/master/src/img/logo/logo.svg"> <img alt="passbolt-logo" src="https://github.com/passbolt/passbolt_styleguide/blob/master/src/img/logo/logo.svg"> </picture> <br> <br>The open source password manager for teams.
<br>
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 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 :
<a href="https://apps.microsoft.com/detail/9PFXS2WVKVPB">
</a>
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.
<div style="text-align: center;"> <img src="./images/desktop-app-get-started.webp" alt="How to export the account kit" style="display: block; margin: 0 auto; width: 75%;"> </div>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
Clone the project
git clone git@github.com: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:
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.
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:
- Open the solution in Visual Studio.
- In the Solution Explorer, right-click on the
PassboltDesktopApp.UnitTestsproject and select "Run Tests". - 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:
- Open a command prompt and navigate to the project directory.
- Run the following command to restore the NuGet packages:
MSBuild /t:Restore
- Run the following command to build the solution:
MSBuild /t:Build /p:Configuration=Release
- Run the following command to run the unit tests:
MSBuild /t:VSTest /p:VSTestPath=<Path to vstest.console.exe> /p:VSTestArguments="/Settings:<Path to appsettings.json> /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
- Open your project in Visual Studio.
- In the Solution Explorer, right-click on the project and select "Manage NuGet Packages".
- In the NuGet Package Manager, click on the "Updates" tab to see a list of all available updates for your NuGet packages.
- You can use this information to determine if any of your NuGet packages need to be updated.