Skip to main content

Passwords

The Passwords integration lets you open the passwords stored in GLPI from the app. Before you can use it, you have to pair the app with your GLPI instance. This page explains how to do that.

Before you start

The app has to be paired with GLPI before it can show any password. The pairing is set up from both sides: a PIN in the app, and a QR code generated in GLPI. Your GLPI needs the Passwords plugin and the Gapp Xtended plugin for this. The PIN is a 4-digit code that stays on your phone, and a GLPI account can be paired with one phone at a time.

Note: We recommend reading the Passwords plugin documentation before you start this page. It explains the plugin on the GLPI side, which is where the QR code comes from.

Where to find it

In the app, open Settings from the side drawer and go to the Security section. The pairing starts at Passwords 2FA. In GLPI, it starts at My settings, on the Passwords tab.

Pairing your phone with GLPI

Pairing takes three steps, and the second one has four clicks in GLPI. Have the app and GLPI open at the same time, because the QR code shown in GLPI is scanned with the phone.

1. Set a PIN in the app

In the app, go to Settings > Security and tap Passwords 2FA. Enter a 4-digit PIN code. You will use this PIN later to approve access to your passwords. If you tap Cancel instead, nothing is paired.

Passwords screen asking to enter a PIN code

The app asks you to enter a PIN code. It is used to validate password access requests from your GLPI account.

Once the PIN is set, the app explains where to find the QR code in GLPI. Tap OK.

Information dialog explaining how to pair Gapp with Passwords on GLPI

The information dialog tells you to scan the QR code generated by GLPI at My settings > Passwords > Generate QR to pair with Gapp.

2. Generate the QR code in GLPI

In GLPI, open My settings from your profile menu, go to the Passwords tab and generate the QR code. It takes four clicks.

GLPI profile menu open, with the profile picture and name (1) and the My settings option (2) marked

The GLPI profile menu: your profile picture and name (1) and the My settings option (2).

1. Click your profile picture

At the top right of GLPI, click your profile picture and name. This opens your profile menu.

2. Choose My settings

In the menu, click My settings.

Now go to the Passwords tab and generate the code.

GLPI My settings, with the Passwords tab (3) and the Generate QR to pair with Gapp button (4) marked

GLPI My settings: the Passwords tab (3) and the Generate QR to pair with Gapp button (4).

3. Select the Passwords tab

In My settings, select the Passwords tab.

4. Generate the QR code

Click Generate QR to pair with Gapp. GLPI opens a window with the QR code.

GLPI window Generate QR to pair with Gapp, showing the QR code and the pairing instructions

The Generate QR to pair with Gapp window in GLPI: the QR code on the left and the pairing instructions on the right.

Note: Generating a new QR code cancels the current pairing of your phone until you scan the new code. Generate it only when you want to pair.

3. Scan the QR code with your phone

The app opens its QR scanner. Point it at the QR code shown in GLPI, so that the code is inside the frame. When the pairing works, the app confirms it. The QR code only lasts a limited time, set by your administration in GLPI. If you scan it too late, the app shows "The QR token has expired, please generate a new one." Generate a new QR code and try again.

App QR scanner with the GLPI QR code in view and the green scanning frame

The app's QR scanner, with the QR code from GLPI in view.

Dialog saying Gapp has been successfully paired with Passwords on your GLPI instance

The app confirms that it has been paired with Passwords on your GLPI instance.

Note: The app only accepts the QR code that GLPI generates in My settings > Passwords. With any other QR code, it shows "Invalid QR code".

Checking that it is paired

You can check the pairing at any time in Settings > Security. Under Passwords 2FA, the app shows whether it is paired.

Settings, Security section: Passwords 2FA, Paired with Passwords on GLPI

After pairing, Passwords 2FA reads "Paired with Passwords on GLPI.".

Note: From now on, you are notified on your phone whenever you want to access a password, and only you can authorize that access from your device.

Note: Tapping Passwords 2FA again starts the pairing again. Use it when you change phones: only the last phone you pair works. In GLPI, the Unpair button in My settings > Passwords removes the pairing.

Viewing a password

Once the app is paired, you can go to the Password section of a ticket and look at the passwords of the items linked to it. To see one, you tap it and validate your device from a notification.

1. Open the Password section

Open a ticket, tap the section button above the bottom bar and choose Password. The section shows the passwords of the items (assets) linked to the ticket. If there are any, the icon shows how many.

Ticket section menu with the Password icon marked and a counter showing 1

The section menu of a ticket, with the Password section (1). The counter shows how many passwords the items of the ticket have.

Note: The section is empty when the items of the ticket have no passwords. If it looks empty right after pairing, close the ticket and open it again.

2. Look at the list of passwords

The Password section lists the passwords of the items (assets) linked to the ticket, one card for each. You only see the passwords you have access to, and only their names, not their values.

List of passwords linked to the ticket, showing Microsoft administrator account

The list of passwords of the ticket. Tap a card to open that password.

3. Validate your device

Tap the password you want to see. If you have not validated recently, nothing is shown yet: GLPI sends a notification to your phone so that you validate your device.

Notification from the app asking: Are you trying to access passwords?

The notification: "Are you trying to access passwords?".

Tap the notification and enter the PIN you set when you paired the app. On phones with a fingerprint sensor, the keypad can offer the fingerprint as an alternative to the PIN.

Passwords screen asking to enter your PIN code

The app asks for your PIN code to approve the request.

If the PIN is wrong, the app shows "The entered PIN is incorrect." and does not grant the access.

Once the PIN is right, the app confirms that access has been granted. Tap OK.

Dialog saying access to passwords has been granted successfully

The confirmation that access to passwords has been granted.

Note: After you approve the access, you can open passwords without a new notification for a while. How long depends on a setting your administration chooses in GLPI (Gapp Xtended, duration of the validation token). GLPI mentions 1 hour in the pairing window. In that case, the app shows the password as soon as you tap it.

4. Go to the password to see it

Go back to the Password section of the ticket and tap the password again. The app shows it in a dialog titled Password, with the value hidden. Tap the eye icon to show or hide it. Tap the password itself to copy it to the clipboard. The dialog only closes with OK.

Dialog showing The password is, with the value hidden, an eye icon and an OK button

The dialog with the password, hidden until you tap the eye icon. In this screenshot the value is covered on purpose.

Note: GLPI records every time a password is revealed: who did it, from which IP address and at what time.

Viewing a password from GLPI

The same validation applies in GLPI. If you copy or look at a password from the GLPI web, you also have to confirm from the app that it is you. Private passwords need it too when your administration has enabled Private passwords need 2FA, which is the default.

In the list of passwords in GLPI, each password has an icon to copy it and an eye icon to see it.

Row of a password in GLPI, with the copy and eye icons next to the password column

A password in the GLPI list, with the copy icon and the eye icon.

When you use one of them, GLPI shows the message "Please validate your access on Gapp" and your phone shows the notification. Tap it and enter your PIN, as explained in Viewing a password, and then use the icon again.

If your phone is not paired, GLPI cannot ask for the validation. It shows a warning instead.

GLPI warning: You need to enable 2FA in your app to access Passwords, with the links Learn more and Pair your device

The GLPI warning: "You need to enable 2FA in your app to access Passwords", with the links Learn more and Pair your device.

Pair your device takes you to your My settings in GLPI, and Learn more opens the Passwords integration page on tic.gal.

Note: To get rid of this warning, pair your phone first. See Pairing your phone with GLPI.

If something goes wrong

These are the messages you may see in the app, and what to do in each case.

Your device is not paired on GLPI

This message appears when you tap a password and your GLPI has no pairing for you. Pair your phone again by following Pairing your phone with GLPI above.

Error dialog saying Your device is not paired on GLPI

The error shown when the phone is not paired on GLPI.

Another device is paired with Passwords on GLPI.

This message appears when a different phone, or a newer pairing, has replaced yours. Pair this phone again from Settings > Security > Passwords 2FA.

Error dialog saying Another device is paired with Passwords on GLPI.

The error shown when another device is paired with Passwords on GLPI.

Other messages

These are the other messages you may see.

  • The QR token has expired, please generate a new one.: the QR code was generated too long ago. Generate a new one in My settings > Passwords and scan it.
  • Invalid QR code: the code you scanned does not come from GLPI. Generate a new one in My settings > Passwords.
  • The entered PIN is incorrect.: the access was not granted. Ask for the password again and enter the PIN you chose when you paired the app.
  • Connection error: the app could not reach GLPI. Check your connection and try again.
  • Nothing appears after you tap a password: if you have not validated recently, the password is shown only after you approve the notification, and then you tap it again. If no notification arrives, check that the app can show notifications. If the card does nothing at all, the Passwords integration is probably not available on your GLPI. Ask your administration.
  • No access: you can only open the passwords you have access to in GLPI.