FreeCalypso > hg > fc-sim-tools

comparison doc/Sysmocom-SIM-notes @ 62:6ccc4d952830

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/Sysmocom-SIM-notes: sws-* command updates
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 23 Mar 2021 06:36:26 +0000
parents b9fc7022f9ac
children
comparison
equal deleted inserted replaced
61:97646b363eaa 62:6ccc4d952830
51 for any CHV2 operations: the randomly assigned PIN1 and PUK1 are printed on the 51 for any CHV2 operations: the randomly assigned PIN1 and PUK1 are printed on the
52 plastic, but not PIN2 or PUK2, which are also randomly assigned. 52 plastic, but not PIN2 or PUK2, which are also randomly assigned.
53 53
54 To reduce the need for manual lookups in email data, we have implemented a tool 54 To reduce the need for manual lookups in email data, we have implemented a tool
55 that converts Sysmocom webshop emails into our own database format, and we have 55 that converts Sysmocom webshop emails into our own database format, and we have
56 integrated support for this database into fc-simtool. (Replicating the same 56 integrated support for this database into fc-simtool and fc-uicc-tool.
57 functionality in fc-uicc-tool, as would be appropriate for these UICC-native
58 cards, is on the to-do list.)
59 57
60 Sysmocom webshop emails with USIM/ISIM card key material feature a MIME 58 Sysmocom webshop emails with USIM/ISIM card key material feature a MIME
61 multipart/alternative structure with text/plain and text/html parts, with each 59 multipart/alternative structure with text/plain and text/html parts, with each
62 part further encoded in base64. To extract the bits of interest and convert 60 part further encoded in base64. To extract the bits of interest and convert
63 them into our sws-card-db format, follow these steps: 61 them into our sws-card-db format, follow these steps:
115 113
116 sws-auth-pin1 -- send VERIFY CHV1 with PIN1 from sws-card-db 114 sws-auth-pin1 -- send VERIFY CHV1 with PIN1 from sws-card-db
117 sws-auth-pin2 -- send VERIFY CHV2 with PIN2 from sws-card-db 115 sws-auth-pin2 -- send VERIFY CHV2 with PIN2 from sws-card-db
118 sws-pin1-disable -- send DISABLE CHV with PIN1 from sws-card-db 116 sws-pin1-disable -- send DISABLE CHV with PIN1 from sws-card-db
119 sws-pin1-enable -- send ENABLE CHV with PIN1 from sws-card-db 117 sws-pin1-enable -- send ENABLE CHV with PIN1 from sws-card-db
118
119 There is also a generic sws-lookup command that looks up arbitrary sws-card-db
120 fields for the current card - examples:
121
122 sws-lookup puk1 -- look up and display PUK1 for this card
123 sws-lookup ki opc -- look up and display Ki and OPc for this card
120 124
121 sysmoUSIM-SJS1 difference 125 sysmoUSIM-SJS1 difference
122 ========================= 126 =========================
123 127
124 Both sysmoUSIM-SJS1 and sysmoISIM-SJA2 are UICC-native cards, and both really 128 Both sysmoUSIM-SJS1 and sysmoISIM-SJA2 are UICC-native cards, and both really
185 verify-pin 10 xxxxxxxx 189 verify-pin 10 xxxxxxxx
186 190
187 where xxxxxxxx are the 8 digits of the ADM1 secret code. There are no 191 where xxxxxxxx are the 8 digits of the ADM1 secret code. There are no
188 restrictions as to when this command may be given in an fc-uicc-tool session. 192 restrictions as to when this command may be given in an fc-uicc-tool session.
189 193
190 sws-auth-* commands have not been ported over fc-uicc-tool yet, but this 194 sws-auth-* and sws-lookup commands work in fc-uicc-tool exactly the same way as
191 omission will be easy to fill. 195 in fc-simtool.
192 196
193 Changing the ADM1 PIN 197 Changing the ADM1 PIN
194 ===================== 198 =====================
195 199
196 Experiments show that when speaking the UICC protocol to the card, the standard 200 Experiments show that when speaking the UICC protocol to the card, the standard