Skip to main content

Handshake Help Center

What can we help you find?

Implementation: Kiosk Configuration

Jennifer
  • Updated

Career services users with the appropriate permissions can configure kiosk card-reader input. 

This article explains the regular expression fields, hashed card ID settings, and how to request configuration assistance from Handshake.

 

Before you begin

To configure kiosks, you need the following permission:

  • Manage Kiosk Preferences

If you do not have this permission, contact your institution's Handshake administrator.

 

How do I configure card-reader input?

  1. Click your name in the upper-right corner of Handshake, then select School Settings.
  2. Select Kiosk Preferences from the menu on the left.
  3. In Card Regex, enter the regular expression that determines what input will be treated as card input.
  4. In Card Substring Regex, enter the regular expression for the substring you want to extract from the full card input.
    • The substring must be the first group match in the regular expression.
  5. If your institution uses hashed card IDs, complete the fields described in How do I configure hashed card IDs?.
  6. Click Save.
Kiosk preferences.png

 

How do the regular expression fields work?

  • Card Regex determines what input will be treated as card input.
  • Card Substring Regex determines which substring will be extracted from the full card input. The substring must be the first group match in the regular expression.

For example:

  • Card output: !9234708294300==124;
  • Card Regex: ^!\d{13}==\d{3};$
  • Student card ID: 347082
  • Card Substring Regex: ^!\d{2}(\d{6})\d{5}==\d{3};$

Glossary of regex terms

  • ^ is used at the beginning of the regex string.
  • \d represents numbers. For example, four consecutive numbers are represented as \d{4}.
  • \D represents letters. For example, five consecutive letters are represented as \D{5}.

 

How do I configure hashed card IDs?

If your institution uses hashed card IDs:

  1. In Salt, enter the salt. The salt is added to the end of the input before it is hashed and used for the student lookup.
  2. Enter the applicable values in Card Regex and Card Substring Regex.
  3. Check Hash Card Input?
  4. Click Save.

Important: Hashed card IDs must be lowercase for the kiosk to check in the correct account.

 

What are the requirements for matching a card ID?

  • The Card ID on the student record must be contained within the card output.
  • Information can be removed from the card output. For example, if the student’s Card ID is 1234123, an output of ;001234123400;: can be configured to use 1234123 as the Card ID.
  • Information cannot be added to the card output to match the student’s Card ID. For example, if the student’s Card ID is 0012341234, but the output is ;1234123400;, the Card ID must be updated to 12341234.

 

Can we configure multiple card formats?

Handshake supports one card format at a time. Work with your team to determine which card format should be added to Handshake for events, career fairs, appointments, interviews, and other check-in activities.

 

Does Handshake support barcode readers?

Barcode readers are not officially supported. However, Handshake should be able to support a barcode reader if it provides keyboard (USB output) and the student ID or another unique identifier is contained in the output.

 

Can Handshake configure the kiosk for us?

Yes. To request assistance, complete the Kiosk Configuration form.

Tip: Submit the form at least one week before your first event. This provides time for your team to test the configuration and troubleshoot any issues.