Okta Badge & PIN Attributes

Last Updated: April 07, 2026

This topic explains how to set up badge and PIN attributes for print release authentication for Okta.

Stored Attributes

If you use badges or PINs, the necessary attributes depend on how you store them:

• PINs stored in an identity provider (IdP) require the following attributes:
  • authPinUser: The name the user enters to authenticate.
  • authPin: The PIN associated with the user to complete authentication.
• PINs stored in the Vasion Print database require the following attribute: 
  
  • authPinUser: The name the user enters to authenticate.

Users self-register their PINs, so you do not need to add the authPin attribute.

• Badges stored in an IdP require the following attribute:
  • badgeId: The badge information for the user.

The badge associates with the provisioned user, so you do not need to add the authPin or authPinUser attributes.

Add a New Attribute

Follow these steps:

1. Sign in to your Okta Admin Console.
2. In the left-side navigation, expand the Directory section, and select Profile Editor.
3. On the Profile Editor page, select the Okta User (default) profile.
4. In the Attributes section, select the + Add Attribute button.

For badge information do the following:

1. Display name: Enter "Badge ID."

2. Variable name: Enter the following:

   Copy Code

   badgeId

3. Value must be unique for each user: Select the checkbox.
4. You can leave all other fields as default.
5. Select Save.

For PIN information do the following:

1. Add the authPinUser attribute:
   1. Display name: Enter "PIN User."

   2. Variable name: Enter the following:

      Copy Code

      authPinUser

   3. Value must be unique for each user: Select the checkbox.
   4. You can leave all other fields as default.
   5. Select Save, or select Save and Add Another.
      PINs stored in an IdP require the authPin attribute. For PINs stored in the Vasion Print database, select Save, and continue to the next section below.

2. Add the authPin attribute:

   1. Display name: Enter "PIN."

   2. Variable name: Enter the following:

      Copy Code

      authPin

   3. You can leave all other fields as default.
   4. Select Save.

Add App Attributes

Follow these steps:

1. Sign in to your Okta Admin Console.
2. In the left-side navigation, expand the Applications section, and select Applications.
3. Select your Vasion Print app.

4. On the app page, select the Provisioning tab, and select To App in the Settings section.

   

5. Scroll down, and select the Go to Profile Editor button.

Add Badge Attributes

On the Add Attribute modal, do the following:

1. Display name: Enter "Badge ID."

2. Variable name: Exact spelling and case sensitivity are essential. Enter the following:

   Copy Code

   badgeId

3. External namespace: Enter the following:

   Copy Code

   urn:ietf:params:scim:schemas:core:2.0:User

4. Attribute type: Select Personal.
5. You can leave all other fields as default.
6. Select Save.

Add PIN Attributes

Map Attributes

Follow these steps:

1. Return to the app's Provisioning tab.
2. Scroll to the bottom of the page, and select Show Unmapped Attributes.

Map Badge Attributes

Follow these steps:

1. Locate the badgeId attribute, and select the Edit button .
2. From the Attribute value menu, select Map from Okta Profile.
3. Select badgeId | string.
4. Select Create and Update.

5. Select Save.

   

Map PIN Attributes

Follow these steps:

1. Map the authPinUser attribute:

   1. Locate the authPinUser attribute, and select the Edit button .
   2. From the Attribute value menu, select Map from Okta Profile.
   3. Select authPinUser | string.
   4. Select Create and Update.

   5. Select Save.

      

      Skip to the next section if you store PINs in Vasion Print.
2. Map the authPin attribute:
   1. Locate the authPin attribute, and select the Edit button .
   2. From the Attribute value menu, select Map from Okta Profile.
   3. Select authPin | string.
   4. Select Create and Update.

   5. Select Save.

      

Add Badge IDs & PINS

If you store badge or PIN information in Vasion Print, refer to the following:

• Vasion Print Badge Management.
• Import Badges into Vasion Print.
• Badge Self-Registration.
• PIN Self-Registration.

If you store badge or PIN information in an IdP, follow the steps in the relevant section below.

Add Badge IDs in an IdP

Follow these steps:

1. In the left-side navigation, expand the Directory section, and select People.
2. Select a user from the list.

3. Select the Profile tab, and select Edit.

   

4. Scroll to the bottom of the page, and locate the Badge ID badgeId field.

5. Enter the badge number, and select Save.

   

6. Repeat these steps to add badge numbers for additional users.

After you register a badge in Vasion Print, regardless of whether you use the Vasion Print database or an IdP, you cannot remove or disassociate the badge number from the user account in the Admin Console. Instead you must remove the user from Vasion Print, make the change to the badge, and then reprovision.

Add PINs in an IdP

Follow these steps:

1. In the left-side navigation, expand the Directory section, and select People.
2. Select a user from the list.

3. Select the Profile tab, and select Edit.

   

4. Scroll to the bottom of the page, and do the following:
   1. PIN User authPinUser: Enter the name that the user will use when they authenticate with their PIN.
   2. PIN authPin: Enter the PIN for the user.

5. Select Save.

   

6. Repeat these steps to add PINs for additional users.