keepassxc-proxy-access

KO | EN

gitlite — search

#react #llm #golang #go #android #rust #deep-learning #linux #docker #macos #windows #security #ios #open-source

keepassxc-proxy-access

(★ 23)

A Java library to access KeePassXC via its build-in proxy

keepassxc-proxy-access Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# keepassxc-proxy-access
![keepassxc-proxy-access](https://raw.githubusercontent.com/purejava/keepassxc-proxy-access/develop/keepassxc-proxy-access.png)

[![Publish to Maven Central](https://github.com/purejava/keepassxc-proxy-access/workflows/Publish%20to%20Maven%20Central/badge.svg)](https://github.com/purejava/keepassxc-proxy-access/actions?query=workflow%3A%22Publish+to+Maven+Central%22)
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/f8c426863d4c46578ef2b7ae8c32e99f)](https://app.codacy.com/gh/purejava/keepassxc-proxy-access?utm_source=github.com&utm_medium=referral&utm_content=purejava/keepassxc-proxy-access&utm_campaign=Badge_Grade)
[![Maven Central](https://img.shields.io/maven-central/v/org.purejava/keepassxc-proxy-access.svg?label=Maven%20Central)](https://central.sonatype.com/search?q=keepassxc-proxy-access&smo=true&namespace=org.purejava)
[![License](https://img.shields.io/github/license/purejava/keepassxc-proxy-access.svg)](https://github.com/purejava/keepassxc-proxy-access/blob/master/LICENSE)
<a href="#supported-platforms"><img alt="Windows" src="https://img.shields.io/badge/Windows-supported-blue.svg" /></a>
<a href="#supported-platforms"><img alt="macOS" src="https://img.shields.io/badge/macOS-supported-blue.svg" /></a>
<a href="#supported-platforms"><img alt="Linux" src="https://img.shields.io/badge/Linux-supported-blue.svg" /></a>
[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/donate?hosted_button_id=XVX9ZM7WE4ANL)

A Java library to access KeePassXC via its build-in proxy. Requires KeePassXC 2.6.0 or newer.

# Dependency
Add `keepassxc-proxy-access` as a dependency to your project.

## Gradle
```gradle
implementation group: 'org.purejava', name: 'keepassxc-proxy-access', version: '1.3.2'
```
## Maven

```maven
<dependency>
    <groupId>org.purejava</groupId>
    <artifactId>keepassxc-proxy-access</artifactId>
    <version>1.3.2</version>
</dependency>
```

# Usage
The library uses the JSON data format to communicate with KeePassXC. The underlying TweetNaCL crypto library provides the crypto_box functionality that is used to set up an encrypted and secure channel for the components to communicate with each other.

It's fast, easy to use and cross-platform.

Examples on how to use the library can be found in the Maven test classes.

You need to establish a connection to KeePassXC first:
```java
var kpa = new KeepassProxyAccess();
kpa.connect();
kpa.associate();
```
You'll get an AssociateID and the public key of an IDKeypair created during the initial connection.
Both pieces of data combined are needed for further connections. As both are public data, there is no need to store them securely.

Next steps:
```java
    var id = kpa.getAssociateId();
    var keyPair = kpa.getIdKeyPairPublicKey();

var idKeyMap = List.of(Map.of("id", id, "key", keyPair)); // java 21
    var logins = kpa.getLogins("https://login.url.com/", "", true, idKeyMap);
    // System.out.println(logins) // nested map with credentials
```

# keepassxc-protocol
Communication with KeePassXC happens via the KeePassXC protocol. Currently, the following functionality is implemented:
*   `change-public-keys`: Request for passing public keys from client to server and back.
*   `get-databasehash`: Request for receiving the database hash (SHA256) of the current active database.
*   `associate`: Request for associating a new client with KeePassXC.
*   `test-associate`: Request for testing if the client has been associated with KeePassXC.
*   `generate-password`: Request for generating a password. KeePassXC's settings are used.
*   `get-logins`: Requests for receiving credentials for the current URL match.
*   `set-login`: Request for adding or updating credentials to the database.
*   `lock-database`: Request for locking the database from client.
*   `get-database-groups`: Request to retrieve all database groups together with their groupUuids.
*   `create-new-group`: Request to create a new group for the given name or path.
*   `get-totp`: Request for receiving the current TOTP.
*   `delete-entry`: Request for deleting an entry in the database, identified by its uuid (KeePassXC 2.7.0 and newer).
*   `request-autotype`: Request autotype from the KeePassXC database (KeePassXC 2.7.0 and newer).
*   `passkeys-get`: Request for Passkeys authentication (KeePassXC 2.7.7 and newer).
*   `passkeys-register`: Request for Passkeys credential registration (KeePassXC 2.7.7 and newer).
*   `database-locked`: A signal from KeePassXC, the current active database is locked.
*   `database-unlocked`: A signal from KeePassXC, the current active database is unlocked.

# Donation
If you like this project, why not buy me a cup of coffee?

[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/donate?hosted_button_id=XVX9ZM7WE4ANL)

The keepassxc-proxy-access logo is based on an [ICONFINDER logo](https://www.iconfinder.com/icons/4484570/hosting_link_proxy_server_url_window_icon) that is published under the [Creative Commons Attribution 3.0 Unported licence](https://creativecommons.org/licenses/by/3.0/) (CC BY 3.0). I modified the icon to my needs by changing the interior and adding the KeePassXC logo.

The KeePassXC logo is Copyright (C) of https://keepassxc.org/

keepassxc-proxy-access

keepassxc-proxy-access Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

keepassxc-proxy-access

keepassxc-proxy-access Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README