PM Code Works

RandTune

2020-01-22T10:33:00+01:00

Organise and practise your tunes!

You like to play Irish Traditional Folk and attend trad sessions? RandTune can be your handy assistant. You can create Tunebooklets that contain all of your tunes and RandTune rolls the dice for you to generate random sets of three tunes of the same type (e.g. reel). With this method, RandTune is able to support you in practising tunes and start sets. It is possible to save custom sets as well as to sort the tunes by name, type or key.

Clearas

2019-09-22T23:00:00+02:00

Clearas ist ein Reinigungsprogramm zum Editieren von Autostart-Programmen, Kontextmenüeinträgen, Diensten sowie geplanter Aufgaben unter Windows. Es begann als Neuimplementierung des msconfig Programms mit Inspirationen von CCleaner. Jetzt ist es ein Open-Source Reinigungsprogramm für fortgeschrittene Benutzer, die die Möglichkeit haben möchten, Autostart, Kontextmenü, Dienste und geplante Aufgaben flexibler und mit erweiterten Möglichkeiten zu bearbeiten.

Autostart

Unter dem Reiter Autostart werden alle Programme aufgelistet, die beim Start von Windows ausgeführt werden. Jedes dieser Programme kann prinzipiell deaktiviert werden, um den Startvorgang von Windows zu beschleunigen. Jedoch sollten nicht alle Programme deaktiviert, da es auch wichtige Hintergrund-Programme gibt, die bei jedem Windows-Start ausgeführt werden müssen. Meistens hilft es den Dateipfad zur Anwendung zu betrachten. Enthält dieser einen bekannten Hardware-Hersteller, wird davon abgeraten, diesen Eintrag zu deaktivieren.

Das Löschen von Autostart-Programmen ist auch möglich, jedoch wird davon dringend abgeraten, da es unwiderruflich ist. Stattdessen sollte Deaktivieren bevorzugt verwendet werden. Zur Sicherheit wird die Möglichkeit beim Löschen geboten, den Eintrag als Registrierungsdatei zu exportieren, die später wieder importiert werden kann. Der komplette Autostart kann übrigens auch als Registrierungsdatei über den Menüpunkt "Einträge exportieren" unterhalb des Menüs "Datei" exportiert werden. Über den Menüpunkt "Hinzufügen" können Programme sogar dem Autostart hinzugefügt werden. Weitere Funktionen, wie z.B. den Speicherort eines Eintrags herauszufinden, können über das Kontextmenü, dass durch einen Rechtsklick angezeigt wird, aufgerufen werden.

Kontextmenü

Unter dem Reiter Kontextmenü ist es möglich Kontextmenüeinträge im Windows Explorer, die sich in den Jahren angesammelt haben, mit wenigen Klicks zu entfernen. Standardmäßig werden nur häufig genutzte Kontextmenüeinträge angezeigt. Um z.B. speziellen Dateitypen zugeordnete Kontextmenüs zu finden, wurde ein Expertenmodus hinzugefügt. Mit ihm werden tiefe Strukturen der Registry nach diesen Einträgen durchsucht. Da dabei meist eine große Anzahl gefunden wird, wurde eine Schnellsuche hinzugefügt, mit der nach bestimmten Einträgen gesucht werden kann.

Über den Menüpunkt "Hinzufügen" können eigene Kontextmenüeinträge hinzugefügt werden.

ShellNew-Einträge

Clearas bietet die Möglichkeit, sog. ShellNew-Einträge zu bearbeiten, die im Hintergrund Kontextmenü des Windows Explorers unter "Neu" zu finden sind.

Falls beispielsweise der Eintrag "Kontakt" unerwünscht ist, kann dieser durch einen Klick auf "Deaktivieren" aus dem Menü entfernt werden:

Anschließend ist dieser Eintrag nicht mehr unter "Neu" zu finden:

Dienste

Auf dem Reiter Dienste ist es möglich, Windows-Dienste zu bearbeiten. Dieses wurde in Anlehnung an das msconfig Feature "Dienste" mit verbesserter Benutzbarkeit und mehr Funktionalität entwickelt. Standardmäßig werden nur automatisch gestartete Dienste mit geringer Priorität angezeigt. Wie auch unter dem Reiter Kontextmenü wurde ein Expertenmodus hinzugefügt, der alle Dienste (außer Treiber- oder Betriebssystem-Dienste) findet. Eine Schnellsuche bietet das Filtern von bestimmten Diensten.

Aufgaben

Unter dem Reiter Aufgaben ist es möglich, geplante Aufgaben (ab Windows Vista) zu bearbeiten. Der Expertenmodus findet versteckte Aufgaben. Eine Schnellsuche vereinfacht das Suchen nach bestimmten Aufgaben.

Clearas unterstützt mehrere Sprachen.

Installation

Clearas wird als Setup zum Download angeboten.

Clearas Setup herunterladen

Neben dem Setup kann Clearas auch als Portable Version (ohne Installation) heruntergeladen werden.

Clearas Portable 64-bit herunterladen

Clearas Portable 32-bit herunterladen

Clearas wurde digital signiert. Um diese Signatur zu verifizieren, wird das Zertifikat von PM Code Works benötigt.

Clearas

2019-09-22T23:00:00+02:00

Clearas is a cleansing program to edit autostart, context menu, service and scheduled task items. It started as reimplementation of the msconfig tool with inspirations from CCleaner. Now it is an open-source cleansing program for advanced users who want the ability to manage autostart, context menu, service and scheduled task items in a more flexible way with enhanced possibilities.

Autostart

The Autostart tab lists all the programs that are executed when Windows is started. Each of these programs can be disabled in principle to speed up the boot process of Windows. However, not all programs should be disabled, as there are also important background programs that need to be run every time Windows is started. Usually it helps to take a look at the file path to the application. If this contains a well-known hardware manufacturer, it is not recommended to disable this entry.

The deletion of startup programs is also possible, but it is strongly discouraged because it is irrevocable. Instead, deactivation should preferably be used. For safety reasons, the option to export the entry as a registration file, which can later be imported again, is offered when deleting. Incidentally, the complete autostart can also be exported as a registration file via the menu item "Export entries" below the "File" menu. Using the menu item "Add" programs can even be added to the autostart. Other functions can be accessed via the context menu that is displayed by a right-click.

Context menu

The context menu tab lists context menu entries seen in the Windows Explorer context menu, which have accumulated over the years. With a few clicks they can be hidden. By default, only frequently used context menu items are displayed. An expert mode was introduced to find special pop-up menus in deep structures of the registry. A quick search is provided to search for specific entries.

Custom context menu entries can be added via the menu item "Add".

ShellNew items

Clearas provides the possibility to edit so-called ShellNew entries which can be found under "New" in Windows Explorer background context menu.

If the entry "Contact" is e.g. unwanted, it can be removed from the menu by clicking on "Disable":

Finally this entry cannot be found anymore:

Services

On the Services tab it is possible to edit Windows services. This is comparable with the msconfig "services" feature but with improved usability and more functionality. Per default, only automatically started services with low priority are displayed. An expert mode has been added to find all services (except driver or operating system services). A quick search provides filtering of certain services.

Scheduled tasks

The Scheduled Tasks tab makes it possible to edit scheduled tasks of Windows (since Vista). The expert mode finds hidden tasks and the quick search makes it easy to search for specific tasks.

Clearas supports multiple languages.

Installation

Clearas is primary distributed as setup.

Download Clearas Setup

In addition to the setup, Clearas can also be downloaded as a portable version (without installation).

Download Clearas Portable 64-bit

Download Clearas Portable 32-bit

Clearas has been digitally signed. To verify the signature the certificate of PM Code Works must be installed.

PAM RFID

2019-05-25T13:09:00+02:00

PAM RFID ist ein Linux PAM Modul, womit sich ein Benutzer mit einer RFID Karte an seinem Rechner anmelden kann. PAM RFID benutzt dazu einen EM4100 kompatiblen RFID-Leser (z.B. RDM6300), der mittels USB-TTL Adapter an den Rechner angeschlossen wird. Mit ein wenig handwerklichem Geschick, kann der Sensor in einem kleinen Universalgehäuse untergebracht werden:

Für die Steuerung des RFID-Lesers wird die Python Bibliothek PyRfid verwendet. Falls kein RFID-Leser angeschlossen ist, wird die Standard-Passwortauthentisierung benutzt. Das Einrichten einer Zwei-Faktor-Authentifizierung ist zudem möglich. PAM RFID wird mit dem Programm pamrfid-conf konfiguriert.

Hardware

PAM RFID benötigt folgende Hardware:

EM4100 kompatibler 125kHz RFID-Leser (z.B. RDM6300)
Mindestens eine 125kHz RFID-Karte (sog. RFID-Tag)
USB-TTL Adapter
(optional) Universalgehäuse (75x55x25mm)

Anschluss der Hardware

Der RFID-Sensor wird wie folgt mit dem USB-TTL Adapter verbunden:

Installation

Nachdem das PM Code Works APT-Repository hinzugefügt wurde, kann das Paket einfach mit folgendem Befehl installiert werden:

$ sudo apt-get install libpam-rfid

Anschließend fehlende Pakete installieren:

$ sudo apt-get install -f

Einrichtung

Da PAM RFID über USB kommuniziert und dies standardmäßig nur "root" vorbehalten ist, muss jedem Benutzer, der PAM RFID benutzen will, dies zuerst erlaubt werden:

$ sudo usermod -a -G dialout username

Ein Neustart ist anschließend erforderlich. Danach können Benutzer zu PAM RFID hinzugefügt werden.

$ sudo reboot

PAM RFID besteht zum einen aus dem Linux PAM Modul selbst und einem konsolenbasierten Konfigurationsprogramm, um Benutzer hinzuzufügen. Die Authentisierung mittels RFID-Tag wird beispielsweise mit folgendem Befehl für einen Benutzer aktiviert:

$ sudo pamrfid-conf --add-user username

Um zu überprüfen, ob sich der gerade hinzufügte Benutzer mit dem RFID-Tag anmelden kann, wird der folgende Befehl benutzt:

$ pamrfid-conf --check-user username

Hier sollte das eben eingelesene RFID-Tag wieder benutzt werden. Währendessen werden einige Informationen in der Konsole ausgegeben. Steht am Ende "successful", war der Test erfolgreich und der Benutzer kann sich in Zukunft mit seinem RFID-Tag anmelden.

Die Anmeldedaten von PAM RFID werden in der Datei /etc/pamrfid.conf unterhalb der Sektion [users] gespeichert. Der Aufbau eines Eintrags ist dabei:

Benutzername = Salt, Salted-SHA256(RFID-Tag)

In der anderen Sektion [PyRfid] können Einstellungen des RFID-Lesers geändert werden.

Da PAM RFID komplett in Python implementiert wurde, ist es auf jeder Architektur verwendbar, für die eine Python Implementierung vorhanden ist. Somit kann auch der Raspberry Pi mit der ARM-HF Architektur unter Verwendung von beispielsweise Raspbian mit PAM RFID betrieben werden.

Eigenes PAM Modul

Wie genau PAM funktioniert und wie eigene PAM Module implementiert und in Linux integriert werden können, gibt es eine Anleitung unter Linux PAM.

PAM RFID

2019-05-25T13:09:00+02:00

PAM RFID is a Linux Pluggable Authentication Module (PAM) for RFID authentication. It uses an EM4100 compatible RFID reader (e.g. RDM6300) in conjunction with the PyRfid library. With a little manual skill, the reader can be build in a small universal housing:

Per default the password authentication is set as fallback in case no RFID reader is connected. Two-factor authentication is also possible. The module has to be configured by the pamrfid-conf program.

Hardware

PAM RFID requires some hardware:

EM4100 compatible 125kHz RFID reader (e.g. RDM6300)
At least one 125kHz RFID tag
USB-TTL converter
(optional) universal housing (75x55x25)

Connection of the RFID reader

RFID reader and the USB-TTL converter are connected like in the following image:

Installation

After adding the PM Code Works APT repository to the system package sources, the package can be installed using following command:

$ sudo apt-get install libpam-rfid

Install missing dependencies:

$ sudo apt-get install -f

Setup

Since PAM RFID communicates via USB and only root is allowed to do this, every user that wants to use PAM RFID must be granted access for using USB:

$ sudo usermod -a -G dialout username

A reboot is now required. After that users can be added to PAM RFID.

$ sudo reboot

PAM RFID consists of the Linux PAM module itself and a console-based configuration utility to add users. To enable RFID authentication for a user use e.g. the following command:

$ sudo pamrfid-conf --add-user username

Remind to replace username by a real user. Using this command a RFID tag is enrolled twice. To test if added user can login with the tag use e.g. the following command:

$ pamrfid-conf --check-user username

During the test some information are printed on the console. If output in last line is "successful" everything works as it should and user is able to use RFID authentication in the future.

Credendentials of PAM RFID are stored in the file /etc/pamrfid.conf inside the section [users]. The structure of an entry is:

username = salt, salted-SHA256(RFID tag)

The other section [PyRfid] contains settings of the RFID reader.

Since PAM RFID is purely written in Python it can also be run on ARM-HF based Raspberry Pi.

How to write your own PAM module

How PAM works and how PAM modules are written and added to Linux see Linux PAM.

PAM Fingerprint

2019-05-25T13:00:00+02:00

PAM Fingerprint ist ein Linux PAM Modul, womit sich ein Benutzer mit seinem Fingerabdruck an seinem Rechner anmelden kann. PAM Fingerprint benutzt dazu Hardware-seitig den ZFM-20 von Zhaintec (auch bekannt als "Arduino Fingerprint Sensor"), der mittels USB-TTL Adapter an den Rechner angeschlossen wird.

Für die Steuerung des Fingerabdrucksensors wird die Python Bibliothek PyFingerprint verwendet. Mit ein wenig handwerklichem Geschick, kann der Sensor in einem kleinen Universalgehäuse untergebracht werden:

Falls kein Fingerabdrucksensor angeschlossen ist, wird die Standard-Passwortauthentisierung benutzt. Das Einrichten einer Zwei-Faktor-Authentifizierung ist zudem möglich. PAM Fingerprint wird mit dem Programm pamfingerprint-conf konfiguriert.

Hardware

PAM Fingerprint benötigt folgende Hardware:

Zhaintec ZFM-20 (auch bekannt als "Arduino Fingerprint Sensor")
USB-TTL Adapter
(optional) Universalgehäuse (75x55x25)

Anschluss des Sensors

Der Fingerabdrucksensor wird wie folgt mit dem USB-TTL Adapter verbunden:

Installation

Nachdem das PM Code Works APT-Repository hinzugefügt wurde, kann das Paket einfach mit folgendem Befehl installiert werden:

$ sudo apt-get install libpam-fingerprint

Anschließend fehlende Pakete installieren:

$ sudo apt-get install -f

Einrichtung

Da PAM Fingerprint über USB kommuniziert und dies standardmäßig nur "root" vorbehalten ist, muss jedem Benutzer, der PAM Fingerprint benutzen will, dies zuerst erlaubt werden:

$ sudo usermod -a -G dialout username

Ein Neustart ist anschließend erforderlich. Danach können Benutzer zu PAM Fingerprint hinzugefügt werden.

$ sudo reboot

PAM Fingerprint besteht zum einen aus dem Linux PAM Modul selbst und einem konsolenbasierten Konfigurationsprogramm, um Benutzer hinzuzufügen. Die Fingerabdruckauthentisierung wird beispielsweise mit folgendem Befehl für einen Benutzer aktiviert:

$ sudo pamfingerprint-conf --add-user username

Dabei wird ein beliebiger Finger zweimal eingelesen. Um zu überprüfen, ob sich der gerade hinzufügte Benutzer mit seinem Fingerabdruck anmelden kann, wird der folgende Befehl benutzt:

$ pamfingerprint-conf --check-user username

Die LED des Sensors sollte anfangen zu leuchten und der eben eingelesene Finger sollte wieder benutzt werden. Währendessen werden einige Informationen in der Konsole ausgegeben. Steht am Ende "successful", war der Test erfolgreich und der Benutzer kann sich in Zukunft mit seinem Finger anmelden.

Die Anmeldedaten von PAM Fingerprint werden in der Datei /etc/pamfingerprint.conf unterhalb der Sektion [users] gespeichert. Der Aufbau eines Eintrags ist dabei:

Benutzername = Fingerabdruck-ID, SHA256(Fingerabdruck)

In der anderen Sektion [PyFingerprint] können Einstellungen des Fingerabdrucksensors geändert werden.

Da PAM Fingerprint komplett in Python implementiert wurde, ist es auf jeder Architektur verwendbar, für die eine Python Implementierung vorhanden ist. Somit kann auch der Raspberry Pi mit der ARM-HF Architektur unter Verwendung von Raspbian, mit PAM Fingerprint betrieben werden.

Eigenes PAM Modul

Wie genau PAM funktioniert und wie eigene PAM Module implementiert und in Linux integriert werden können, gibt es eine Anleitung unter Linux PAM.

PAM Fingerprint

2019-05-25T13:00:00+02:00

PAM Fingerprint is a Linux Pluggable Authentication Module (PAM) for password-less fingerprint authentication. It uses the ZhianTec ZFM-20 fingerprint sensor (a.k.a. "Arduino fingerprint sensor")

in conjunction with the PyFingerprint library. With a little manual skill, the sensor can be build in a small universal housing:

Per default the password authentication is set as fallback in case no fingerprint sensor is connected. Two-factor authentication is also possible. The module has to be configured by the pamfingerprint-conf program.

Hardware

PAM Fingerprint requires some hardware:

Zhaintec ZFM-20 (a.k.a. "Arduino fingerprint sensor")
USB-TTL converter
(optional) universal housing (75x55x25)

Connection of the sensor

The sensor and the USB-TTL converter are connected like in the following image:

Installation

After adding the PM Code Works APT repository to the system package sources, the package can be installed using following command:

$ sudo apt-get install libpam-fingerprint

Install missing dependencies:

$ sudo apt-get install -f

Setup

Since PAM Fingerprint communicates via USB and only root is allowed to do this, every user that wants to use PAM Fingerprint must be granted access for using USB:

$ sudo usermod -a -G dialout username

A reboot is now required. After that users can be added to PAM Fingerprint.

$ sudo reboot

PAM Fingerprint consists of the Linux PAM module itself and a console-based configuration utility to add users. To enable fingerprint authentication for a user use e.g. the following command:

$ sudo pamfingerprint-conf --add-user username

Remind to replace username by a real user. Using this command a finger is enrolled twice. To test if added user can login with the finger use e.g. the following command:

$ pamfingerprint-conf --check-user username

The sensor LED should light up and the enrolled finger should be used. During the test some information are printed on the console. If output in last line is "successful" everything works as it should and user is able to use fingerprint authentication in the future.

Credendentials of PAM Fingerprint are stored in the file /etc/pamfingerprint.conf inside the section [users]. The structure of an entry is:

username = Template-ID, SHA256(Fingerprint)

The other section [PyFingerprint] contains settings of the fingerprint sensor.

Since PAM Fingerprint is purely written in Python it can also be run on ARM-HF based Raspberry Pi.

How to write your own PAM module

How PAM works and how PAM modules are written and added to Linux see Linux PAM.

Game Wake

2018-03-11T18:15:00+01:00

Game Wake ist ein virtueller Wecker, den man sich stellen kann, um nicht, z.B. während des exzessiven Gamings, die Pizza im Ofen zu vergessen. Aber auch sonst eignet sich Game Wake zum Erinnern an alle möglichen Dinge. Es gibt 4 verschiedene Alarm-Sounds zur Auswahl und eine "Herunterfahren"-Funktion. Neben den Audiosignalen kann Game Wake visuell in einer festgelegten Farbe blinken und zusätzlich eine textbasierte Erinnerung angezeigen. Game Wake verfügt über zwei verschiedene Betriebs-Modi:

"Timer Modus": Standard-Wecker-Funktion, d.h. es kann der Zeitpunkt eingestellt werden, an dem der Alarm ertönen soll
"Counter Modus": Es können Stunden und Minuten eingestellt werden, die vergehen sollen, bis der Alarm ertönt

Sobald der Alarm gestellt ist, wird Game Wake durch Klicken des "Schließen-Knopfs" nicht beendet, sondern in den Tray (Bereich neben der Uhr) minimiert. Diese Funktion wurde eingebaut, um versehendliches Beenden während der Alarm noch gestellt ist, zu verhindern. Soll Game Wake trotzdem beenden werden, muss lediglich ein Rechtsklick auf das Tray-Symbol ausgeführt und dort die Aktion "Beenden" gewählt werden.

Game Wake speichert die Einstellungen in einer INI-Datei. Über den Menüpunkt "Optionen" kann ausgewählt werden, was gespeichert werden soll. Es werden mehrere Sprachen unterstützt.

Installation

Game Wake ist für Debian und Windows verfügbar.

Linux

Nachdem das PM Code Works APT-Repository hinzugefügt wurde, kann das Paket einfach mit folgendem Befehl installiert werden:

$ sudo apt-get install gamewake

Anschließend fehlende Pakete installieren:

$ sudo apt-get install -f

Windows

Game Wake wird als Setup zum Download angeboten.

Game Wake Setup herunterladen

Neben dem Setup kann Game Wake auch als Portable Version (ohne Installation) heruntergeladen werden.

Game Wake Portable 64-bit herunterladen

Game Wake Portable 32-bit herunterladen

Game Wake wurde digital signiert. Um diese Signatur zu verifizieren, wird das Zertifikat von PM Code Works benötigt.

Game Wake

2018-03-11T18:15:00+01:00

Game Wake is a simple to configure virtual alarm clock application. It provides multiple types of alerts and features both a timer and counter mode. Four different sounds can be played. The sounds can be combined with a text message and a blinking effect. Instead of using notifications a shutdown can be initiated. Game Wake supports two operation modes:

"Timer Mode": Default alarm function where the time can be set at which the alarm should start
"Counter Mode": Hours and minutes that should elapse before the alarm starts

Once the alarm has been set, clicking on the "Close" button will not terminate Game Wake, but minimize it to the tray icon area. This feature has been incorporated to prevent accidental termination while the alarm is still set. If you want to terminate Game Wake anyway, simply right-click on the tray icon and select "Exit".

Game Wake stores its settings in an INI based configuration file. The menu item "Options" can be used to select what should be saved. Multiple languages are supported.

Installation

Game Wake is available for Debian and Windows.

Linux

After adding the PM Code Works APT repository to the system package sources, the package can be installed using following command:

$ sudo apt-get install libpam-fingerprint

Install missing dependencies:

$ sudo apt-get install -f

Windows

Game Wake is primary distributed as setup.

Download Game Wake Setup

In addition to the setup, Game Wake can also be downloaded as a portable version (without installation).

Download Game Wake Portable 64-bit

Download Game Wake Portable 32-bit

Game Wake has been digitally signed. To verify the signature the certificate of PM Code Works must be installed.

Android Studio Package

2017-12-21T15:45:00+01:00

Android Studio Package ist ein Programm zum einfachen Erstellen von Debian Paketen von heruntergeladenen Android Studio ZIP-Archiven. Zuerst muss ein Android Studio Archiv von https://developer.android.com/studio/index.html#linux-bundle heruntergeladen werden. Anschließend kann das Debian Paket mittels folgendem Befehls erstellt werden:

$ make-aspkg android-studio.zip

Das Debian Paket wird im aktuellen Verzeichnis gepeichert.

Probleme beim erstellen des Debian Pakets auf einem 32-bit Debian

Um ein Android Studio Debian Paket auf einem 32-bit Debian zu erstellen, muss die 64-bit Version des Pakets libc6 installiert sein. Andernfalls wird folgender Fehler auftreten dpkg-shlibdeps: error: couldn't find library libc.so.6. Debian bietet Multiarch, um Pakete anderer Architekturen zu installieren:

$ sudo dpkg --add-architecture amd64

Dadurch kann die 64-bit Version des Pakets libc6 installiert werden

$ sudo apt-get install libc6:amd64

Anschließend sollten Android Studio Debian Pakete auf einem 32-bit Debian ohne Probleme erstellt werden können.

Installation von Android Studio

Damit Android Studio auf einem 64-bit Debian installiert werden kann, müssen einige 32-bit Pakete installiert sein. Dafür wird wieder Debian Multiarch verwendet:

$ sudo dpkg --add-architecture i386

Android Studio mittels folgendem Befehl installieren

$ sudo dpkg -i android-studio_*.deb

Abschließend fehlende Pakete installieren

$ sudo apt-get install -f

Hinweis: Android Studio benötigt mindestens Java 8.

Installation

Nachdem das PM Code Works APT-Repository hinzugefügt wurde, kann das Paket einfach mit folgendem Befehl installiert werden:

$ sudo apt-get install android-studio-package

Anschließend fehlende Pakete installieren:

$ sudo apt-get install -f

Android Studio Package

2017-12-21T15:45:00+01:00

Android Studio Package is an utility to build Debian package from an Android Studio binary distribution archive. First such an Android Studio IDE archive file must be downloaded from https://developer.android.com/studio/index.html. After that the Debian package can be built with the following command

$ make-aspkg android-studio.zip

The Debian package is stored in the current directory.

Problems when building on 32-bit Debian

To build Android Studio on 32-bit Debian the 64-bit version of libc6 library is required. Otherwise following error will occur dpkg-shlibdeps: error: couldn't find library libc.so.6. Use Multiarch capabilities of Debian and enable installation of 64-bit packages:

$ sudo dpkg --add-architecture amd64

Install 64-bit version of libc6

$ sudo apt-get install libc6:amd64

Then building will succeed on 32-bit Debian.

Installation of Android Studio

If Android Studio should be installed on 64-bit Debian some 32-bit libraries are required. It is recommended to use Multiarch capabilities of Debian and enable installation of 32-bit packages:

$ sudo dpkg --add-architecture i386

Then install Android Studio

$ sudo dpkg -i android-studio_*.deb

Finally install missing dependencies

$ sudo apt-get install -f

Please remind that Android Studio requires at least Java 8.

Installation

After adding the PM Code Works APT repository to the system package sources, the package can be installed using following command:

$ sudo apt-get install android-studio-package

Install missing dependencies:

$ sudo apt-get install -f

Eclipse Package

2017-10-02T10:20:00+02:00

Eclipse Package ist ein Programm zum einfachen Erstellen von Debian Paketen von heruntergeladenen Eclipse IDE Archiven. Zuerst muss ein Eclipse Archiv Paket von https://www.eclipse.org/downloads/packages heruntergeladen werden. Anschließend kann das Debian Paket mittels folgendem Befehl automatisch erstellt werden:

$ make-eclipsepkg eclipse-edition.tar.gz

Das Debian Paket wird im aktuellen Verzeichnis gespeichert und kann mit folgendem Befehl installiert werden:

$ sudo dpkg -i eclipse-*.deb

Abschließend fehlende Pakete installieren

$ sudo apt-get install -f

Installation

Nachdem das PM Code Works APT-Repository hinzugefügt wurde, kann das Paket einfach mit folgendem Befehl installiert werden:

$ sudo apt-get install eclipse-package

Anschließend fehlende Pakete installieren:

$ sudo apt-get install -f

Eclipse Package

2017-10-02T10:20:00+02:00

Eclipse Package is an utility to build Debian packages from an Eclipse binary distribution archive. First such an Eclipse IDE archive file must be downloaded from https://www.eclipse.org/downloads/eclipse-packages/. After that the Debian package can be built with the following command

$ make-eclipsepkg eclipse-edition.tar.gz

The Debian package is stored in the current directory and can be installed using

$ sudo dpkg -i eclipse-*.deb

Finally install missing dependencies

$ sudo apt-get install -f

Installation

After adding the PM Code Works APT repository to the system package sources, the package can be installed using following command:

$ sudo apt-get install eclipse-package

Install missing dependencies:

$ sudo apt-get install -f

DDNS Updater

2017-07-14T15:20:00+02:00

DDNS Updater ist ein Python Programm, welches eine dynamische IP-Adresse auf einem DNS Server aktualisert. Wird z.B. ein eigener Web-Server an einem (NAT-)Router betrieben muss die externe IP-Adresse des Routers benutzt werden, um auf diesen Server zugreifen zu können. Da sich IP-Adressen nur bedingt merken lassen, wurde DNS (Domain Name System) entwickelt. DNS löst Domain Namen in (statische) IP-Adressen auf. Da sich IP-Adressen von Routern sporadisch (alle paar Wochen) ändern, liefert DNS, nach solch einer Änderung, immernoch die alte IP-Adresse. Eine Aktualisierung der IP-Adresse auf dem DNS Server ist also notwendig, um weiterhin Zugriff auf seinen (internen) Web-Server zu bekommen. Dieser Vorgang der Aktualisierung wird durch eine Variante von DNS dem Dynamischen DNS übernommen.

Um immer die aktuellste IP-Adresse auf dem DNS-Server zu hinterlegen, wurde DDNS Updater entwickelt. Es gibt zwar bereits einige solcher Programme. Meist bieten diese unnütze Funktionen, sind kompliziert zu konfigurieren und funktionieren teilweise nicht korrekt. DDNS Updater ist sehr schlank, einfach zu konfigurieren und bietet E-Mail Benachrichtigungen bei Fehlern und erfolgreicher Aktualisierung.

Installation

Nachdem das PM Code Works APT-Repository hinzugefügt wurde, kann das Paket einfach mit folgendem Befehl installiert werden:

$ sudo apt-get install ddns-updater

Anschließend fehlende Pakete installieren:

$ sudo apt-get install -f

Konfiguration

Konfiguriert wird DDNS Updater über die Konfigurationsdatei /etc/ddns-updater/ddns.conf, welche den Aufbau einer INI-Datei hat. Darin gibt es Konfigurationsmöglichkeiten, die im Folgenden erläutert werden:

Sektion [DDNS]

server: Diese Variable muss den Domain-Namen des DNS-Server Providers (ohne http://), z.B. dyndns.strato.com, beinhalten.
server_path: Diese Variable muss den URL-Pfad zum DNS-Server Verzeichnis beinhalten. Bei Strato ist dieser beispielsweise /nic/update.
username: Benutzername des Kontos bei dem DNS-Server Provider.
password: Das zugehörige Passwort zum Benutzernamen.
hostname: Der Domain-Name, der zur Verfügung gestellt werden soll.
ip: Diese Variable sollte nicht verändert werden. Darin speichert DDNS Updater die aktuelle IP-Adresse ab. Falls sich diese ändert, aktualisiert das Programm sofort die IP-Adresse auf dem DNS Server.
external_ip_server: Diese Variable muss einen externen Web Server beinhalten, der die Fähigkeit besitzt, die externe IP-Adresse des Routers zurück zu liefern. checkip.dyndns.com ist beispielsweise ein bekannter Server. Eigene (externe) Web Server können auch dazu benutzt werden. Ein simples PHP-Skript (checkip.php) befindet sich in /usr/share/doc/ddns-updater/.
external_ip_server_path: URL-Pfad zum PHP Skript auf einem externen Web Server. Falls der checkip.dyndns.com Server benutzt wird ist hier lediglich ein / einzutragen.
use_regex: Diese Variable aktiviert bzw. deaktiviert die Nutzung eines regulären Ausdrucks (RegEx), um die IP-Adresse aus einer HTTP-Antwort im HTML-Format auszulesen. Falls checkip.dyndns.com benutzt wird, muss diese Variable auf True gesetzt werden und andernfalls auf False.

Sektion [Mail]

notify: Durch diese Variable werden E-Mail Benachrichtigungen aktiviert bzw. deaktiviert. Falls aktiviert (True) werden Mails bei Fehlern und nach erfolgreicher Aktualisierung der IP-Adresse verschickt.
smtp_server: SMTP Postausgangsserver von dem die E-Mail Benachrichtigungen verschickt werden.
port: Port des Postausgangsservers (587 oder 465).
username: Benutzername des E-Mail Kontos.
password: Das zugehörige Passwort zum Benutzernamen des E-Mail-Kontos. Hinweis: Das Passwort sowie der Benutzername werden mit TLS verschlüsselt übertragen.
recipient: E-Mail-Adresse des Empfängers an den die E-Mail Benachrichtigungen versandt werden.

Intervall

DDNS Updater überprüft standardmäßig alle 10 Minuten, ob sich die IP-Adresse geändert hat. Falls ja wird diese automatisch aktualisiert. Somit wird eine Aktualisierung nicht unnötig vorgenommen. Das Interval kann in der Datei /etc/cron.d/ddns-updater geändert werden.

Weitere Befehle

Standardmäßig wird die Konfigurationsdatei /etc/ddns-updater/ddns.conf beim Starten geladen. Mit folgendem Befehl kann eine andere Datei geladen werden:

$ sudo ddns-updater --config /Pfad/zu/einer/anderen/Konfigurationsdatei

DDNS Updater unterstützt mehrere DDNS Profile. Jede Sektion innerhalb der Konfigurationsdatei bildet ein solches Profil. Standardmäßig wird das Profil "DDNS" geladen. Durch folgenden Befehl kann auch ein anderes Profil geladen werden:

$ sudo ddns-updater --profile PROFILNAME

DDNS Updater

2017-07-14T15:20:00+02:00

DDNS Updater is a Python program to update a dynamic IP address on a DNS server using the NIC V2.0 protocol. If hosting a private webserver connected to a NAT router the external IP address of the router must be used to get access this webserver. Since IP addresses are not made for human memory the DNS (Domain Name System) was invented. DNS resolves domain names into (static) IP addresses. IP addresses of routers change after a few weeks but DNS will not notice anything about it and returns the old IP address. The IP address needs to be updated. This update process is done by a variant of DNS the Dynamic DNS.

In order to always store the most recent IP address on the DNS server, DDNS Updater was developed. There are already some such programs elsewhere. Most of them provide useless functions, are complicated to configure and sometimes do not work properly. DDNS Updater is very slim, easy to configure and provides optional email alerts for errors and successful updates.

Installation

After adding the PM Code Works APT repository to the system package sources, the package can be installed using following command:

$ sudo apt-get install ddns-updater

Install missing dependencies:

$ sudo apt-get install -f

Setup

Edit the file /etc/ddns-updater/ddns.conf.

Section [DDNS]

server: The domain name of DNS server providers (without http://) e.g. dyndns.strato.com.
server_path: The URL path to the DNS server directory e.g. /nic/update.
username: Account name at DNS server provider.
password: Password for account at DNS server provider.
hostname: The domain that should be provided.
ip: Do not edit this. It is maintained by DDNS Updater and contains the current IP address.
external_ip_server: An public available webserver that sends the current IP, e.g. checkip.dyndns.com. Self-hosted servers are also possible by using the simple PHP script checkip.php located in /usr/share/doc/ddns-updater/.
external_ip_server_path: URL path to the directory where the PHP script is located e.g. /
use_regex: (Optional) Set to True to extract the IP address out of HTML formatted HTTP response e.g. when using checkip.dyndns.com in external_ip_server. When using self-hosted server with checkip.php script set to False.

Section [Mail]

notify: (Optional) Set to True to enable e-mail notifications like successful IP address updates or errors. Please configure following value or set to False to disable notifications. Then the following configuration is not necessary.
smtp_server: SMTP Server to send the e-mails from.
port: Port of the SMTP server e.g. 587 or 465.
username: E-mail account name.
password: E-mail account password. Don't worry: TLS is used during exchange!
recipient: E-mail account that should receive the notifications.

Interval

Every 10 minutes DDNS Updater verifies if the IP address has changed and performs an update if necessary. The interval can be changed by editing file /etc/cron.d/ddns-updater.

Additional commands

The configuration file /etc/ddns-updater/ddns.conf is loaded per default during execution. It is possible to load another configuration file by using following command:

$ sudo ddns-updater --config /path/to/another/file.conf

DDNS Updater supports multiple DDNS profiles. Every section inside the configuration file specifies a profile. Per default the profile DDNS is loaded. To load another profile use the following command:

$ sudo ddns-updater --profile PROFILENAME

PyRFID

2017-05-08T12:21:00+02:00

PyRFID ist eine Python Bibliothek zur Ansteuerung eines 125kHz UART RFID-Lesers unter Verwendung des EM4100 Protokolls. Entwickelt wurde mit dem günstigen RDM6300 RFID-Modul. PyRFID kommt auch bei PAM RFID zum Einsatz.

Wichtig: Zur Verwendung von PyRFID muss der RFID-Leser das EM4100 Protokoll unterstützen!

Der Leser wird mittels USB-TTL Adapter an den Rechner angeschlossen (siehe PAM RFID). Die Kommunikation zwischen Leser und Rechner übernimmt PySerial. Pro Lesevorgang wird ein Datenpaket ausgetauscht, was die erforderlichen Daten des RFID-Tags enthält. Im Folgenden wird der Aufbau eines solchen Pakets erklärt.

Datenpaket

Ein Datenpaket besteht aus 10 Byte Nutzdaten und einer 2-Byte Prüfsumme. Anfang und Ende eines solchen Pakets wird durch zwei einzelne Bytes markiert. Das Format eines Datenpakets sieht demnach wie folgt aus:

0x02

5 Hex-data

Checksum

0x03

0x02: Markiert den Anfang des Datenpakets (Länge 1 Byte)
5 Hex-data: RFID-Tag Nummer als Hexa-Dezimal kodiert (Länge 10 Byte; 1 Hex = 2 Byte)
Checksum: Prüfsumme des Datenpakets (Länge 2 Byte)
0x03: Markiert das Ende des Datenpakets (Länge 1 Byte)

Um zu überprüfen, ob die RFID-Tag Nummer korrekt übertragen wurde, wird eine Prüfsumme berechnet.

Prüfsumme

Die Prüfsumme wird nach jedem vollständigen Empfang eines Datenpakets berechnet, indem die 5 hexadezimal kodierten Zahlen durch eine XOR-Operation verbunden werden:

(1. Hex-Zahl) XOR (2. Hex-Zahl) XOR (3. Hex-Zahl) XOR (4. Hex-Zahl) XOR (5. Hex-Zahl)

Das Ergebnis dieser Operation wird dann mit der mitgesendeten Prüfsumme verglichen. Stimmt die berechnete mit der gesendeten Prüfsumme überein, wurde das Datenpaket korrekt übertragen und kann weiterverarbeitet werden. Der Zugriff auf die Nutzdaten durch PyRFID kann nun erfolgen. Um die Prüfsumme auszulesen bietet PyRFID die Methode tagChecksum() an.

Tag-Typen

Die Nutzdaten enthalten neben der eigentlichen RFID-Tag Nummer ein Flag zur Bestimmung des Tag-Typs. Dieses Typ-Flag wird von Herstellern von RFID-Tags unterschiedlich genutzt und befindet sich am Anfang der Nutzdaten. PyRFID bietet zum Auslesen des Typs die Python Properties tagType und tagTypeFloat.

Darstellung

Die RFID-Tag Nummer kann unterschiedlich dargestellt werden:

Hexadezimal: Hierbei werden die Bytes 0 bis 9 des Tags abgegriffen und "roh" zur Verfügung gestellt. PyRFID bietet dazu die Methode rawTag(). Beispiel: 0F00789A62
Fließkomma: Hierbei werden die Bytes 2 bis 5 als Vorkommazahl und die Bytes 6 bis 9 als Nachkommazahl benutzt. PyRFID bietet dazu die Methode tagIdFloat(). Beispiel: 120.39522
Dezimal: Hierbei werden die Bytes 4 bis 9 benutzt und mit Nullen von links auf die Länge 10 aufgefüllt. PyRFID bietet dazu die Methode tagId(). Beispiel: 0007903842

Auslesen

Ein Lesevorgang wird mittels der Methode readTag() ausgelöst. Diese blockiert solange, bis ein RFID-Tag eingelesen wurde. Im Verzeichnis /usr/share/doc/python-rfid/examples/ befindet sich ein Beispiel, wie PyRFID benutzt wird.

Installation

Nachdem das PM Code Works APT-Repository hinzugefügt wurde, kann das Paket einfach mit folgendem Befehl für Python 2 installiert werden:

$ sudo apt-get install python-rfid

Für Python 3 folgenden Befehl verwenden:

$ sudo apt-get install python3-rfid

Anschließend fehlende Pakete installieren:

$ sudo apt-get install -f

Alternativ gibt es PyRFID als ZIP-Archiv.

PyRFID

2017-05-08T12:21:00+02:00

PyRFID is a Python library for using a 125kHz UART RFID reader that uses the EM4100 protocol. The cheap RDM6300 RFID reader was used during development. PyRFID is also used in PAM RFID.

Important: The RFID reader must support the EM4100 protocol to use PyRFID!

The reader is connected to host computer using an USB-TTL converter (see also PAM RFID). PySerial is used for the serial communication.

Each read process results in an exchange of a data packet which contains the RFID tag information.

Data packet

A data packet consists of 10 bytes of user data and a 2-byte checksum. The beginning and end of such a packet is marked by two single bytes. The format of a single data packet looks like this:

0x02

5 Hex-data

Checksum

0x03

0x02: Marks the beginning (length is 1 byte)
5 Hex-data: RFID tag number in hexadecimal encoding (length is 10 byte; 1 hex = 2 byte)
Checksum: Checksum of the data packet (length is 2 byte)
0x03: Marks the end (length 1 byte)

A checksum is calculated to check whether the RFID tag number has been transmitted correctly.

Checksum

After each data packet has been fully received the checksum is calculated using an XOR operation:

(1. hex number) XOR (2. hex number) XOR (3. hex number) XOR (4. hex number) XOR (5. hex number)

The result of this operation is compared against the received checksum. If the calculated checksum matches the received checksum the data packet was successfully transmitted and can be further processed. To read out the checksum PyRFID provides the method tagChecksum().

Tag types

An RFID tag also contains a flag for determining the type. This flag is used differently by manufacturers of RFID tags and is located at the beginning of the tag number. To read the type flag PyRFID provides the Python properties tagType and tagTypeFloat.

Formats

There are more possibilities to format a RFID tag number:

Hexadecimal: Bytes 0 to 9 are used raw e.g. 0F00789A62. To get the data in raw format use the method rawTag().
Floating point: Bytes 2 to 5 are used as number before comma and bytes 6 to 9 are used number after comma e.g. 120.39522. To get data as float use the method tagIdFloat().
Decimal: Bytes 4 to 9 are used and padded with zeros from left side to fit length 10 e.g. 0007903842. To get the data in this format use the methode tagId().

How to read a tag

To read a tag PyRFID provides the method readTag(). This method blocks until a tag has been read. An example can be found in /usr/share/doc/python-rfid/examples/.

Installation

After adding the PM Code Works APT repository to the system package sources, the package can be installed for Python 2 using following command:

$ sudo apt-get install python-rfid

For Python 3 use following command:

$ sudo apt-get install python3-rfid

Install missing dependencies:

$ sudo apt-get install -f

As an alternative PyRFID is offered as ZIP archive.

SIT

2016-07-08T16:32:00+02:00

SIT alias "Support-Information-Tool" ist ein Programm zum einfachen Eintragen von Herstellerinformationen in die Systemeigenschaften von Windows. IT-Firmen können so mit wenigen Klicks ihren (virtuellen) Firmenstempel auf dem Kunden PC hinterlassen. Logos können ganz einfach per Dialog hinzugefügt werden. Die restlichen Informationen müssen per Hand eingetragen werden. Unter "Datei"-->"Eingaben exportieren" können die eingetragenen Informationen aus SIT und unter "Datei"-->"Einträge exportieren" die bestehenden, die in Windows zu finden sind, exportiert werden. Später können diese auch wieder importiert werden.

Ein Klick auf "Übernehmen" und die Informationen werden in den Systemeigenschaften von Windows gespeichert:

Die Funktion "Logo kopieren" kopiert ein Logo vom "Logo Pfad" in ein beliebiges Verzeichnis, sodass dieses zentral gespeichert wird und somit immer in den Systemeigenschaften angezeigt werden kann. Falls SIT z.B. von einem USB-Stick ausgeführt wird und das Logo sich auch dort befindet, würde beim Klick auf "Übernehmen" nur der Pfad zum Logo in Windows geschrieben werden und nicht das Logo selbst. Um auch dieses zu Kopieren, kann die Checkbox "Logo kopieren" ausgewählt werden, womit beim "Übernehmen" ein Dialog zur Verzeichnisauswahl angezeigt wird.

Die Eingaben, sowie die Einträge in Windows, können unter "Bearbeiten" direkt gelöscht werden. Diese und alle anderen Funktionen sind alternativ per Shortcuts ausführbar! SIT unterstützt mehrere Sprachen.

Installation

SIT benötigt keine Installation und ist ab Windows 2000 mit jeder Windows Version kompatibel.

SIT 64-Bit herunterladen

SIT 32-Bit herunterladen

SIT wurde digital signiert. Um diese Signatur zu verifizieren, wird das Zertifikat von PM Code Works benötigt.

SIT

2016-07-08T16:32:00+02:00

SIT a.k.a. "Support Information Tool" is a program to edit the support information in Windows. IT companies can leave their (virtual) company stamp on the customer PC with just a few single clicks.

Just click apply and support information are stored.

The function "Copy Logo" copies a logo from the "Logo path" to any directory, so that it is stored centrally and can therefore always be displayed in the system properties. If the logo loaded from an USB stick clicking on "Apply" would write the USB stick path. When removing the USB stick the image is not displayed in the system properties anymore. If selecting the checkbox "Copy logo" a dialog will be displayed when clicking "Apply" to store the logo in a regular filesystem path. SIT supports multiple languages.

Installation

SIT does not need to be installed and is compatible with Windows 2000 and later.

Download SIT 64-bit

Download SIT 32-bit

SIT has been digitally signed. To verify the signature the certificate of PM Code Works must be installed.

EasyWinHash

2016-05-11T22:45:00+02:00

EasyWinHash ist ein Programm zum einfachen Erzeugen und Überprüfen von kryptografischen Prüfsummen (Hashes) von heruntergeladenen Dateien. Meist bieten Download-Portale solche Prüfsummen neben den eigentlichen Dateien an. Mit EasyWinHash können diese überprüft werden, um sicher zu gehen, dass die Datei nicht verändert bzw. manipuliert wurde. Nutzer haben so die Gewissheit, dass die heruntergeladene Datei die gleiche ist, die sich im Download-Portal befindet. Schließlich besteht die Möglichkeit, dass diese Datei manipuliert wurde.

Zur Überprüfung der Signatur einer heruntergeladenen Datei muss die Datei zuerst entweder per Drag-and-Drop in das Fenster gezogen werden oder über einen Klick auf das Lupensymbol ausgewählt werden. Anschließend muss die Signatur von der Website kopiert und in das untere Eingabefeld eingefügt werden. Vor einem Klick auf "Überprüfen" muss zudem der richtige Signaturalgorithmus in der linken unteren Ecke ausgewählt werden. Dieser steht meist neben der Signatur der Datei auf der Website. Stimmt die Signatur überein, wird das Feedback von EasyWinHash wie folgt aussehen:

Stimmt die Signatur nicht überein, würde das Feedback von EasyWinHash wie folgt aussehen:

In diesem Fall sollte die Signatur der Datei erneut mit der auf der Website angegebenen auf Gleichheit überprüft werden. Der verwendete Algorithmus zur Erzeugung der Signatur muss unbedingt auch übereinstimmen. Stimmt die Signatur samt Algorithmus sie überein, sollte die Datei erneut heruntergeladen und überprüft werden.

EasyWinHash bietet neben einer einfach zu benutzenden grafischen Oberfläche, die Integration in den Windows Explorer.

EasyWinHash unterstützt mehrere Sprachen.

Installation

EasyWinHash ist ab Windows XP mit jeder Windows Version kompatibel und wird als Setup zum Download angeboten.

EasyWinHash herunterladen

EasyWinHash wurde digital signiert. Um diese Signatur zu verifizieren, wird das Zertifikat von PM Code Works benötigt.

EasyWinHash

2016-05-11T22:45:00+02:00

EasyWinHash is a program for easily creating and verifying cryptographic checksums (hashes) of downloaded files. Usually, download portals offer such checksums beside the actual files. Using EasyWinHash these can be checked to make sure that the file has not been altered or tampered. Users can be sure that the downloaded file is exactly the same as in the download portal. After all there is the possibility that this file has been tampered.

To verify the signature of a downloaded file, the file must be either dragged and dropped into the window or selected by clicking on the magnifying glass icon. After that the signature has to be copied from the website and pasted into the lower input field. Before clicking on "Verify", the correct signature algorithm must also be selected in the lower left corner. Usually the algorithm is shown next to the signature of the file on the website. If the signature matches, EasyWinHash will look like this:

If the signature does not match EasyWinHash will look like this:

In this case, the signature of the file should be checked against the one on the website. The used algorithm must strictly match, too. If the signature and the algorithm match the ones on the website, something is gone wrong and the file should be downloaded and checked again.

EasyWinHash offers an easy-to-use graphical interface and integrates into Windows Explorer context menu.

EasyWinHash supports multiple languages.

Installation

EasyWinHash is distributed as setup and is compatible with Windows XP and later.

Download EasyWinHash

EasyWinHash has been digitally signed. To verify the signature the certificate of PM Code Works must be installed.

Linux PAM

2015-03-02T13:31:00+01:00

PAM, die sog. Pluggable Authentication Modules, bieten eine Schnittstelle in unixoiden Betriebssystemen für die Authentisierung von z.B. Benutzern. Bekanntestes Beispiel für ein PAM Modul ist wohl die standardmäßige Passwort-Eingabe nach dem Boot des Betriebssystems. Der Benutzer authentisiert sich dabei gegenüber PAM mit seinem Passwort und PAM authentifizert diesen bei korrekter Passwort-Eingabe, sodass er sich in sein Benutzer-Konto einloggen kann. Der Vorteil bei PAM: Es kann anstatt einer Passwort-Eingabe jedes beliebige Authentisierungs-Verfahren verwendet werden. Das Erstellen eigener Module und das Anmelden darüber am System ist somit möglich. Da der Einstieg in die PAM Programmierung nicht ganz so einfach ist, wird im Folgenden die Erstellung eines sehr einfachen PAM Moduls und dessen Integration in Linux erklärt.

Beispiel für ein Linux PAM Modul mit PAM Python

Ein PAM Modul kann sehr schnell sehr komplex werden. Schließlich findet die komplette Authentisierung eines Benutzers oder Dienstes dort statt. Ein einfaches PAM Modul, um die Funktion von PAM zu erklären und zu verstehen, ist daher generell ein guter Einstieg. Die Programmiersprache für PAM ist C. Da diese Sprache ihre Eigenheiten hat und nicht sehr leicht zu lesen ist, gibt es zum Glück eine Möglichkeit, PAM Module auch in Python zu implementieren. Das Projekt, das dieses bietet, nennt sich PAM Python. Dieses wird für folgendes Beispiel benötigt. Folgender Befehl installiert das Paket:

$ sudo apt-get install libpam-python

PAM Module befinden sich in dem Ordner /lib/security/ und beginnen mit "pam_" gefolgt von einem Namen. Bei PAM Fingerprint heißt das PAM Modul beispielsweise pam_fingerprint.py. Der Aufbau des PAM Moduls ergibt sich stark vereinfacht wie folgt:

def pam_sm_authenticate(pamh, flags, argv):

    return pamh.PAM_SUCCESS

def pam_sm_setcred(pamh, flags, argv):

    return pamh.PAM_SUCCESS

In der Methode pam_sm_authenticate findet die eigentliche Authentisierung eines Benutzers statt. Dort sollte über return pamh.PAM_SUCCESS bei Erfolg und pamh.PAM_AUTH_ERR bei Misserfolg zurückgegeben werden. Um die Rückgabewerte kümmert sich die interne PAM Verwaltung. Wie in dem Beispiel zu sehen ist, wird immer Erfolg zurückgeliefert. Dadurch wird jeder Benutzer sofort authentifiziert und es wird ihm möglich, sogar Root-Rechte ohne Passwortabfrage oder ähnliches zu erlangen. Deswegen nochmal: Dies ist nur ein sehr einfaches Beispiel!

PAM Module verwalten

Unter Debian Linux gibt es einen sehr praktischen Befehl, um PAM Module zu verwalten:

$ sudo pam-auth-update

Mit diesem Befehl öffnet sich eine halbgrafische Oberfläche mit einer Liste, in der alle PAM Module des Systems aufgelistet werden:

Mit der Leertaste können Module aktiviert (*) oder deaktiviert werden. Das Programm hält sich dabei an die sog. PAM Profile.

PAM Profile

PAM Profile bieten die Möglichkeit, PAM Module einfach zu aktivieren oder deaktivieren und beliebig zu verschachteln. Dadurch sind die Module erst modular. Die Profile befinden sich im Ordner /usr/lib/share/pam-configs/.

Als Beispiel wurde ein PAM Modul erstellt, welches jedoch dem System noch unbekannt ist und demnach noch nicht verwendet wird. Deswegen muss ein eigenes PAM Profil im Ordner /usr/lib/share/pam-configs/ erstellt werden. Der Name des Profils ist konventionsgemäß der des Projekts. Diese Profile werden nach dem Stack-Prinzip abgearbeitet. Ein PAM Profil sieht z.B. bei PAM Fingerprint wie folgt aus:

Name: Fingerprint authentication
Default: yes
Priority: 257
Auth-Type: Primary
Auth:
    sufficient            pam_python.so pam_fingerprint.py

Hinter Name steht dabei der angezeigte Name, der in der Liste von pam-auth-update enthalten ist. sufficient bewirkt, dass falls PAM Fingerprint nach der Benutzung Erfolg zurückliefert, keine weiteren PAM Module ausgeführt werden. Liefert PAM Fingerprint jedoch Misserfolg zurück, greift nach dem Stack-Prinzip das nächste PAM Modul. Nach der Liste von pam-auth-update ist dies "Unix authentication", also die Standard Passwort-Authentisierung. Dieses Prinzip geht so lange weiter, bis der Stack abgearbeitet wurde bzw. ein PAM Modul Erfolg zurückliefert. Erreicht der Stack jedoch den Boden ohne Erfolg, wird die Authentisierung abgebrochen und der Stack beginnt von vorne.

Außer sufficient gibt es natürlich noch weitere Flags wie z.B. required. Dieses Flag bewirkt, dass das Modul Erfolg zurückliefern muss. Falls nicht, wird die Authentisierung abgebrochen und der Stack beginnt von vorne.

Fazit

Wie zu sehen ist, ist die Erstellung und Integration von PAM Modulen kein Hexenwerk. Die Verwendung von Python als Programmiersprache durch PAM Python bietet zudem einen syntaktischen Luxus. PAM Fingerprint und PAM RFID sind auch mit Hilfe von PAM Python in Python implementiert worden. Beide wurden als Open-Source veröffentlicht und bieten somit weiterführende Source-Code Beispiele für die Entwicklung eigener PAM Module.