Skip to end of metadata
Go to start of metadata


Especially in large companies, many employees who do not have their own desktop workstation have to be granted access to the Linchpin intranet on a mobile basis. In addition, there is the challenge that these employees do not use a mobile device managed by the company, so that a BYOD strategy (Bring Your Own Device) must be pursued.

To simplify the onboarding of colleagues for Confluence administrators, it is possible to generate authorization tokens for mobile login via a script directly from Linchpin. These tokens can be created per Confluence user and then converted into a QR code, which can be used by the employee for mobile login via the Linchpin Mobile Gateway.


Requirements

Make sure to establish a connection between your Linchpin instance and the Linchpin Mobile Gateway in order for the following tutorial to work. Please refer to this step-by-step guide for how to connect with the Linchpin Mobile Gateway.


Complete generation tool

We have created  a tool based on JS/node to help you automate the mass creation of qr-codes. It is able to generate the tokens and print QR-Codes as file which you can use directly. The code also could help you as orientation to code a solution in your own dev-environment. 

Open code on github.com

Example for generating user logins as a Confluence administrator using a curl statement

Please note that the following example is intended to illustrate the control of the Rest API. Running the script with the correct parameters creates an access for a given Confluence user that can then be used with the Linchpin Mobile apps. It is possible to address this Rest API call in any programming language.

curl -i -X PUT \
     --basic \
     --user [admin_username]:[admin_password] \
     -H "Content-Type:application/json" \
     -d '{"userName":"[username]","expiry":[time_to_expire_in_hours],"qrcodetype":1}' \
     'https://[confluence_base_url]/rest/linchpin-mobile/1.0/firescope/user/qrcode'


The following parameters are to be set here:

  • Authentication as username and password for an administrative account
  • Confluence username of the user for whom the mobile access should be created
  • Validity period of the QR access code in hours (min 1; max 999)
  • Confluence base URL

The interface then returns a text block, which can be converted into a corresponding QR code using a QR code generator. This code can now be issued to employees and scanned by end users with the app.


Example return: 

{"device_id":"9104cfc1df.....5fb7c14065f0ab","device_setup_key":"2.........c66c16e2655dd0","user_name":"pwinter","auth_token":".....5-23a1-.....-9077-.....f8d9be","client_url":"firescope-1.seibert-media.net","system_name":"Mobile+Test","secret_key":"xyz==","init_vector":"fjhsdfkjshfdkj=="}



This page was last edited on 01/28/2022.