On this page

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=="}