view release on metacpan or  search on metacpan

README.md  view on Meta::CPAN

perl API for eboks.dk
=====================

This is perl interface for http://eboks.dk/, Danish national email system. 

Included a simple POP server for proxying e-boks for read-only mail access
and a simple downloader.

You shall need your CPR# and password.  You can get the password from the
e-Boks website.  For the POP3 login, the username is be your CPR code, such as
f.ex: 0123456-7890.  The password is your mobile pincode.

How it works
============

The module need to be authenticated using MitID as all other clients to the
danish services.  The only difference is that this module is not an official
client, (I'd love to make it official but I guess that costs an arm and a leg,
plus bureaucratic hassles, so this is not planned so far). You would need to
run the authentication (see below) where you would provide your Eboks password
and confirm the Eboks login using your MitID app. After this is done, the
module stores the RSA public key on the eboks server, and this is the same
hardcoded public key used for all accesses. You may supply your own RSA keypair
by generating it yourself and inserting it in the code.

After the public key is uploaded, the module can login and fetch mails using
the public key authentication. It would still need to ask for your CPR and
Eboks password though. You most probably want to either read these mails on the
same machine that fetches them, or forward them to your email. See below how to
do that.

Installation
============

Unix/Linux
----------

* Install this module by opening command line and typing `cpan Net::Eboks` (with `sudo` if needed)

Windows
-------

* You'll need `perl`. Go to [strawberry perl](http://strawberryperl.com/) and fetch one.

* Install this module by opening command line and typing `cpan Net::Eboks`

* Open command line and run

  `eboks-install-win32`

that will fire up a browser-based install wizard. Click "Install", then login witn eBoks
password and MitID.

* Set up your favourite desktop mail reader so it connects to a POP3 server
running on server localhost, port 8110. Username and password are your CPR# and
eBoks mobile password.

* Optionally, if you want to forward the mails, you can choose from numerous
programs that can forward mails from a POP3 server to another mail account
[(list of
examples)](https://blogs.technet.microsoft.com/brucecowper/2005/03/18/pop-connectors-pullers-for-exchange/).
If you use Outlook it [can do that
too](https://www.laptopmag.com/articles/how-to-set-up-auto-forwarding-in-outlook-2013).