---
module: msp.institution-keys
title: Institution Keys
tab: Testing
order: 35
audience: dev
---

Frontend test checklist for **Institution Keys** in the MSP app (`msp.bcos.dev`). Click through in the UI and mark each row Pass or Fail.

## Set up
Log in at **msp.bcos.dev** — test accounts (all password `Passw0rd-d3v!`):

| Login | Role | Sees |
|-------|------|------|
| `bcos_a@bcos.dev` | Admin | All institutions (C1BD, C2BD, C3BD) · can add/edit/delete |
| `msp_a@msp1.bcos.dev` | MSP admin | C1 + C2 only · can add/edit/delete |
| `customer_a@customer1.bcos.dev` | Customer | C1 only · read-only |

The keys map to the simulator institutions **C1BD / C2BD / C3BD** (whose devices are `C1-ATM-001…`, `C1-TCR-001…`, etc.).

## What to test

| # | Do this | ✅ Pass if |
|---|---------|-----------|
| 1 | As `bcos_a`, open **Institution Keys** | Table loads with columns **Key / Institution Name / Device Types** and a row for each institution key |
| 2 | Type part of a key or name in the **Search** box (e.g. `C1`) | List narrows to matching rows; clearing the box brings them all back |
| 3 | Click **+ Add Mapping**, enter Key `TEST1`, an Institution Name, tick **ATM** + **TCR**, click **Add Mapping** | Panel closes, a success toast shows, and a new **TEST1** row appears in the table |
| 4 | Click **Edit** on the `TEST1` row | Panel opens with the **Key field greyed out / not editable**; you can still change the name and ATM/TCR checkboxes |
| 5 | Change the name or a device-type checkbox and click **Save Changes** | Toast confirms, and the row shows the updated name / device types |
| 6 | Click **Delete** on the `TEST1` row | A confirm pop-up naming **TEST1** appears; clicking **Delete** removes the row from the table |
| 7 | Turn the **Auto-refresh** toggle off then on, then click the **↻** refresh button | List reloads with no error and the `(60s)` countdown resets |
| 8 | Log in as `msp_a` and open Institution Keys | You see the **C1BD and C2BD** rows only — **no C3BD** |
| 9 | Log in as `customer_a` and open Institution Keys | You see **only C1BD**; if you try **+ Add Mapping** and save, an **error toast** shows and no new row is added (read-only) |

**Report a fail with:** the row #, which login you used, and what you actually saw.
