X-Road: Autologin User Guide

Version: 1.4 Doc. ID: UG-AUTOLOGIN

Date Version Description
23.08.2017 1.0 Initial version
06.03.2018 1.1 Added chapter and section structure, terms and refs sections and term doc reference and link, toc
15.11.2018 1.2 Ubuntu 18.04 updates
11.09.2019 1.3 Remove Ubuntu 14.04 support
26.09.2022 1.4 Remove Ubuntu 18.04 support

Table of Contents

1 Introduction

This document describes the Autologin utility which automatically enters the PIN code after xroad-signer has started.

1.1 Terms and abbreviations

See X-Road terms and abbreviations documentation [TA-TERMS].

1.2 References

  1. [TA-TERMS] X-Road Terms and Abbreviations. Document ID: TA-TERMS.

2 Overview

2.1 Usage

  1. Install the package
  1. If storing the PIN code on the server in plaintext is acceptable, create file /etc/xroad/autologin that contains the PIN code.
  1. If you do not want to store PIN code in plaintext, implement bash script /usr/share/xroad/autologin/custom-fetch-pin.sh
#!/bin/bash
PIN_CODE=$(curl https://some-address)
echo "${PIN_CODE}"
exit 0

2.2 Implementation details