.. customizations.rst .. _customizations-label: ============================== Customizations ============================== YubiKeys can be customized, for example pre-programmed to meet specific needs for an organization. YubiKeys can also be pre-registered with end-user-specific credentials using the *FIDO Pre-reg service*. For more information, see :ref:`prereg-label`. For information about customization services, contact `Yubico `_. When you order a YubiKey with custom configuration, a *Customization ID* is used to represent the applicable customization included in the final product that you will receive. The Customization ID is unique for a configuration but is not specific for a key model (form factor). You can associate a Customization ID with a more user-friendly *Customization label* of your own choice. A Customization ID can be associated with multiple organizations. An organization can for example have sub-entities in different countries to which they want to ship keys with a specific configuration. The Customization ID is needed for example when configuring the shipment request workflow for ordering :ref:`shipment of pre-registered YubiKeys `. Viewing Customizations ========================== To view available customizations for your organization, click **Customizations** in the left menu. The **Customizations** page appears providing an overview of customizations for your organization. .. note:: The Customizations page is only visible if your organization has at least one associated Customization ID. If your organization is not using custom keys, you will not see this page. .. image:: graphics/customizations-page5.png :width: 800 The Customizations page displays the following information: * **Customization ID** - The unique ID for a specific customization. * **Customization label** - A user-friendly name associated with the Customization ID. See :ref:`custom-id-label`. * **Status** - The state of the customization record. Can be one of the following: * **Approved** - Custom configuration is ready to be added to sales orders. * **Active** - Custom configuration is in use for order fulfillment. * **Decommissioned** - Custom configuration is discontinued and is no longer fulfillable. * **Actions** - Options for adding and editing customization labels and viewing the change history. Use **Search** and **Filters** to filter the list by one or more fields to locate a specific customization ID to view its details. .. _custom-id-label: Adding Customization Labels ============================= The Customization ID consists of a string of numbers and letters. To make it easier for users to identify a specific customization, Console Owners can add user-friendly Customization labels to Customization IDs associated with their organization. Customization labels can be shared between organizations, for example if your company has sub-entities in different countries to which you want to ship custom YubiKeys. Customization labels can be viewed by all organization members, but only organization Console Owners can add and update labels. Yubico can view but not update Customization labels. To add or edit a Customization label for a Customization ID, do the following: #. Click **Customizations** in the left menu to open the **Customizations** page. #. Click the **Edit** icon in the **Actions** column for the desire Customization ID. #. Add the desired customization label, for example “YubiKey 5 NFC sales offices”. #. Click **Save**. .. note:: If a Console Owner for an organization updates a customization label, the change will be reflected in all organizations associated with that specific Customization ID. Customization labels will also be displayed on :ref:`purchase orders ` , :ref:`shipment details `, and :ref:`refunded shipments `. If no Customization label has been added, the Customization label column is empty. Viewing Change History ------------------------------- To view the change history for a customization label for example for auditing purposes, click the **clock** icon for the desired **Customization label** in the **Customizations** page. The history information includes the date when a change was made, the updated customization label, and the email of the user that made the change. .. _custom-info-label: Viewing Customization Details =============================== For :ref:`FIDO Pre-reg (pre-registered keys) ` type of shipments, you can view customization details associated with each key in a specific shipment. The information includes serial number and firmware version, and is displayed after the shipment has been processed by Yubico Fulfillment Center and the shipment is moved to state “Shipped: in Transit”. To view customization details for custom keys in a shipment, do the following: #. Click **All shipments** in the left menu. #. Click the **ID** for a shipment of type "AUTO FIDO PRE-REG" for which you want to see customization details. Ensure that the selected shipment is in state “Shipped: in Transit” or later. #. In the **Shipment details** page, scroll down to the **Item details** section and click **Details** in the **Action** column for the applicable key model to expand the view. .. image:: graphics/customization-info-view.png :width: 800 The following information is displayed: * **Serial No.** - A unique number identifying a pre-registered key. * **Firmware** - The version number for the firmware used on the pre-registered key. Each customization has its own Customization ID identifying the type of customization applied to the keys. In the example above, the shipment request contains a total of 16 keys of models "YubiKey 5 NFC" (one key) and "YubiKey 5C NFC" (15 keys). Finding a Customized Shipment ------------------------------- To locate a shipment containing specific customizations, you can filter shipments on serial number and firmware version, if you know this information. This is useful for example to view the status of a specific shipment request. On the **All shipments** page, click **Filters** and enter values in the **Serial No.** and/or **Firmware** fields. .. image:: graphics/customization-filter.png :width: 500 Viewing Customizations in Refunds ----------------------------------- Just as for other types of shipments, you can view refunds for customized shipments. If the refunded shipment includes custom keys, the Customization IDs are listed in the **Refunds** section of the **Shipment details** page. .. image:: graphics/customization-refunds.png :width: 800 For more information, see :ref:`refunds-label`. ------------------------------------- To file a support ticket for YubiEnterprise Delivery, click `Support `_.