SDK installation
17.3.2.2. Installation of the Loginapp REST UI SDK

The Loginapp REST UI SDK is a standalone application designed to run locally. It does not require an actual Airlock IAM installation.

Requirements

  • An internet connection is required to download Loginapp REST UI SDK and dependencies.
  • The Loginapp REST UI SDK runs on the following OS:
    • Mac OSX
    • Linux
    • Windows (via WSL 2)

Prerequisites

  • bash (version 3.2 or newer)
  • tar (with zlib or gzip)
  • zip

Download and installation

  • 1.
    Download the latest Loginapp REST UI SDK from the release download page: https://techzone.ergon.ch/downloads/airlock-iam
  • 2.
    Unpack the UI SDK:
  • copy
    IAM_VERSION=7.6
    unzip airlock-iam-loginapp-rest-ui-sdk-$IAM_VERSION.zip cd airlock-iam-loginapp-rest-ui-sdk-$IAM_VERSION
  • 3.
    The installed directory contains 2 files (and a hidden folder that should not be modified):
    • README.md: with a link to the latest documentation
       
    • SDK: a CLI to use the Loginapp REST UI SDK

Known limitations

The SDK uses the underlying operating system ability to monitors all files to detect changes. The SDK uses this mechanism to automatically detect when the page needs to be refreshed. How many files can be monitored depends on the configuration of the number of inotify watches configured in the operating system.

This works well on standalone computers but running multiple instances of the SDK on a server system may require an increase of inotify watches permitted by the operating system.