Create Your First Credential

Documentation Index

Fetch the complete documentation index at: https://docs.zerokeyusb.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide assumes you have already finished the initial tutorial. If not, do it first.

---

​

Step 1 — Unlock with the PIN

When you plug the device in, the PIN numpad appears. For each digit: Up/Down to the correct value, Right to confirm. When you finish the last digit, the cursor jumps to the tick (✓). Press Center on the tick to validate.

---

​

Step 2 — “Add New” appears automatically

If this is the first time (no credentials yet) or you have navigated to the end of your list, the Add New screen appears — a centered button. Press Center to create an empty credential in the first available slot.

---

​

Step 3 — Freshly created credential

The device creates a slot with placeholder values (nuevo/usuario/clave) and takes you directly to its main view. On the left you’ll see the slot number (1). To start filling in the site, press and hold Center for ~1 second (you’ll see the large halo appear). When you release, you enter the editor.

---

​

Step 4 — Editor: the first letter

The editor occupies the whole screen. It has 4 rows:

1. Top: the field being edited (16 slots).
2. Row 2: < > controls to move the cursor + the KB1 keyboard (uppercase A-P).
3. Row 3: Rand (random fill) + KB2 (lowercase a-p).
4. Row 4: Save + KB3 (numbers and symbols).

Let’s start by typing the first letter. We are in KB1 with the cursor over G. Use Right/Left to move the cursor across the keyboard and Center to insert the selected character into the field. The field cursor (where insertion happens) advances automatically.

---

​

Step 5 — Switch keyboard page

To access lowercase (KB2) or numbers/symbols (KB3), use Down from KB1. Press Down to jump from KB1 to KB2 (and again to reach KB3). Up goes back. Keep inserting letters with Center.

---

​

Step 6 — Save the credential

When you finish typing, navigate to Save (row 4, left column) using Down from Rand or Left from KB3, and press Center. With Save highlighted in white, press Center to save and return to the main credential view. What you wrote is encrypted with AES-128 CBC and written to EEPROM before exiting.

---

​

Step 7 — Move to the User field

Back on the main view you’ll see the site (github) and the rest of the fields still empty. Use Down to switch from Site to the User field. Press Down. The icon switches from site (globe) to user (silhouette), confirming the next edit applies to the user field. Then hold Center to enter the editor.

---

​

Step 8 — Generate a random password with Rand

Repeat the steps for the User field. Then navigate to Pass (another Down press) and enter the editor. But this time, instead of typing it manually, use the Rand option to have the device generate a strong 12-character password. With Rand highlighted, press Center. The Pass field is instantly filled with 12 alphanumeric + symbol characters from the ATECC608A’s TRNG. Then move down to Save and press Center to save.

---

​

Step 9 — Done

You’re back on the main view. The credential already has site, user and password encrypted in EEPROM. If you press Center on the Site field now, ZeroKeyUSB will type username + TAB + password + ENTER to the host, as if you were typing on a normal keyboard. With your cursor on the login page’s username field, short-press Center. The device writes user + TAB + password + ENTER automatically.

---

​

Next steps