{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":34171,"path":"it-service-management/walk-up-experience/assisted-config-badge-read-settings.md","title":"Define and register a badge reader device using the badge reader client","bundle":null,"doc_type":null,"release":"australia","body":"\n# Define and register a badge reader device using the badge reader client\n\nUse the Badge Reader Client to create a badge reader device for registration in your system. Registering your badge reader enables you to make it operational at your Walk-up Experience on-site queue.\n\n## Before you begin\n\nRole required: sn\\_badge.badge\\_admin\n\n## About this task\n\nThere are two ways to register a badge reader device:\n\n-   Assisted method, through the **Badge Reader Client**. You must create your own custom badge reader client software to integrate with the badge reader.\n-   Manually, through the ServiceNow AI Platform®. Refer to [Define and register a badge reader device manually](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/walk-up-experience/config-badge-reader-settings.md) for details on this procedure.\n\nThe **Badge Reader Client** assisted registration method creates an initial Badge Reader record. When a badge is scanned using the badge reader client, this method automatically populates the **Device Identifier** field in the record with the badge reader device serial number.\n\nAutomatic population of the **Device Identifier** field saves you time from looking for the badge reader device serial number to add to the Badge Reader record.\n\nTo register your badge reader device with **Badge Reader Client** assistance, first you need to configure system properties to enable badge scan registration and disable the badge access token. The following System Properties must be configured:\n\n-   **sn\\_badge.enable\\_scan\\_registration**: Disabled by default. When set to **True**, this property enables n\\_badge.badge\\_admins to quickly register badge reader devices by scanning a badge.\n-   **sn\\_badge.disable\\_access\\_token**: Enabled by default. This property disables the access token requirement for the Badge Reader Integration API.\n\n## Procedure\n\n1.  Navigate to **All** > **System Properties** > **All Properties**.\n\n2.  Search by **Name** for the properties by typing `sn_badge`.\n\n3.  Click **sn\\_badge.enable\\_scan\\_registration** to open the system property record.\n\n    The property is set to **False** by default.\n\n4.  Change the property **Value** field to **True** and click **Update**.\n\n5.  Click **sn\\_badge.disable\\_access\\_token** to open the system property record.\n\n    The property is set to **False** by default.\n\n6.  Change the property **Value** field to **True** and click **Update**.\n\n7.  Create and then run your own badge reader client.\n\n8.  Swipe the badge admin's badge on the badge reader to register.\n\n9.  The badge reader client performs a REST API call to api/sn\\_badge/v1/reader/scan with the device identifier and the card data.\n\n10. Navigate to **Badge Reader Integration** > **Badge Readers** to view the newly created record.\n\n11. Provide a name for the badge reader in the **Name** field.\n\n    For example, `Building B Tech Lounge Badge Reader`.\n\n    **Note:** The **Status** field is read only and indicates **New** when configuring a new badge reader. The field indicates **Activated** when a badge reader is approved for activation. If a badge reader is deactivated, the field indicates **Deactivated**.\n\n12. Specify a **Badge Event Handler** using the search list \\[Omitted image \"List\\_SearchIcon.png\"\\] Alt text: search list icon icon.\n\n    **Note:** If no badge event handlers are available to select, create a new Badge Event Handler record. For details about this process, refer to [Create or modify Badge Reader Integration event handlers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/walk-up-experience/create-or-modify-badge-event-handlers.md).\n\n13. Verify that the **Device Identifier** and **Secret Key** fields are populated.\n\n    The Device Identifier uniquely identifies the badge reader hardware. The client defaults to using the badge reader device serial number. The value entered must match the device serial number received from the client software application.\n\n14. Populate the non-mandatory **Short description** and **Location** form fields if desired.\n\n15. Select **Submit** to register the badge reader.\n\n\n**Parent Topic:**[Walk-up Experience Badge Reader Integration setup and configuration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/walk-up-experience/walkup-badge-read-integ-config.md)\n\n"}}