/roundcube-jmap

JMAP API for Roundcube Webmail

Primary LanguagePHPGNU General Public License v3.0GPL-3.0

Roundcube JMAP

⚠️ This version is still in its early stages. This API exposes user data. It is not recommended to expose this API to untrusted networks for now. Please consider contacting us before using this in production.

The JMAP plugin for Roundcube provides JMAP support for Roundcube by exposing a RESTful API Endpoint which speaks the JMAP Protocol.

The following data types are currently supported by the JMAP Plugin for Roundcube:

This plugin allows Roundcube to function as an address book sync server. It makes use of the JMAP for Contacts protocol for that. JMAP for Contacts is a successor to CardDAV.

Installation

  1. Run make to initialize the project for the default PHP version (8.1). Use other build targets (e.g. make php56_mode or make php70_mode) instead, in case you are using a different version.
  2. (optional) there are build targets that enable logging to graylog instead of a file, e.g. run make graylog56_mode
  3. Run make zip to create a zipped package under build/
  4. Extract the resulting package into the plugins folder of your Roundcube (Make sure the folder is named jmap).
  5. 🎉 Partytime! Help fix some issues and send us some pull requests 👍

Usage

Set up your favorite client to talk to Roundcube's JMAP API.

Development

Installation

  1. Run step 1) from above.
  2. Run make update to update depdendencies and make devtools available

Tests

To run all tests run make fulltest. This requires Podman (for Static Anaylsis) and Ansible (for Integration Tests).

You can also run them separately:

  • Static Analysis via make lint
  • Unit Tests via make unit_test

Tested against

PHP: 5.6, 7.0, 8.1 and 8.2

Roundcube: 1.2, 1.3, 1.4 and 1.6

Debug

For debugging purposes it makes sense to throw some cURL calls at the API. For example, this is how you tell the JMAP API to return all Contacts:

curl <roundcube-address>plugins/jmap/jmap.php -u <username>:<password> -d '{"using":["https://www.audriga.eu/jmap/jscontact/"],"methodCalls":[["Card/get", {"accountId":"<username>"}, "0"]]}'