Carddavmate

From ArchWiki
Jump to: navigation, search

Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: please use the first argument of the template to provide a brief explanation. (Discuss in Talk:Carddavmate#)

Carddavmate is a carddav client that runs in a web browser using javascript. It is useful when you have a carddav server and want to access the contacts on this server with only a web browser.

This guide shows you how to install carddavmate to use with davical

Installation

Install the carddavmateAUR package.

After that, config.js needs to be configured, as well as httpd-carddavmate.conf. Then, httpd-carddavmate.conf needs to be included in the Apache configuration, and Apache needs to be restarted.

Configuration

Password Protection

Password protection is implemented using apache's htpasswd facility. The relevant file that includes the authentification credentials is at /srv/http/carddavmate/htpasswd.

You may delete the file or remove the "test" account by deleting the line from the file.

To add your own user, run:

# htpasswd /srv/http/carddavmate/htpasswd

add -c after htpasswd if you deleted the htpasswd file.

Carddav server

Add the carddav server to your config by editing /srv/http/carddavmate/config.js, for example:

var globalSettings=[{href: 'https://carddav.example.com:443/caldav.php/joe/', userAuth: {userName: 'joe', userPassword: 'secret', serverPassword: false}, timeOut: 14000}];

A better example, without insecure user clear passwords:

var globalSettings=[{href: 'https://carddav.example.com:443/caldav.php/USER'}];

Apache

To "serve" the /srv/http/carddavmate directory properly, include /etc/httpd/conf/extra/httpd-carddavmate.conf in your apache configuration. To do this, add the following line to /etc/httpd/conf/httpd.conf:

Include conf/extra/httpd-carddavmate.conf

Also, edit httpd-carddavmate.conf to reflect the url where carddavmate is installed, for example:

Header always set Access-Control-Allow-Origin "https://carddavmate.example.com"

Save this file and restart Apache with httpd.service.

Testing

To test your installation, browse to https://127.0.0.1/carddavmate and see if your carddav data shows up.

Security

Since the client is a javascript program that runs in your browser, the username/password that is configured in config.js on the server is also in the browser and can be easily seen. To avoid issues, clear your browser cache to delete the compromising files after you are done.

Troubleshooting

Troubleshooting is best done using chrome's built-in javascript console.