| Jacob Erlbeck | 0024cee | 2014-12-11 15:14:14 +0100 | [diff] [blame^] | 1 | |
| 2 | GPRS Subscriber Update Protocol |
| 3 | |
| 4 | 1. General |
| 5 | |
| 6 | This document describes the remote protocol that is used by the SGSN to update |
| 7 | and manage the local subscriber list. The protocol and the messages are |
| 8 | designed after the corresponding MAP messages (see GSM 09.02) with the |
| 9 | following differences: |
| 10 | |
| 11 | - The encoding uses TLV structures instead of ASN.1 encodings |
| 12 | - Segmentation is not used |
| 13 | |
| 14 | See the specification of the Gr interface (GSM 03.60). |
| 15 | |
| 16 | 2. Connection |
| 17 | |
| 18 | The protocol expects that a reliable, ordered, packet boundaries preserving |
| 19 | connection is used (e.g. IPA over TCP). The remote peer is either a service |
| 20 | that understands the protocol natively or a wrapper service that maps the |
| 21 | messages to/from real MAP messages that can be used to directly communicate |
| 22 | with an HLR. |
| 23 | |
| 24 | 2. Procedures |
| 25 | |
| 26 | 2.1. Authentication management |
| 27 | |
| 28 | The SGSN sends a SEND_AUTHENTICATION_INFO_REQ message containing the MS's IMSI |
| 29 | to the peer. On errors, especially if authentication info is not availabe for |
| 30 | that IMSI, the peer returns a SEND_AUTHENTICATION_INFO_ERR message. Otherwise |
| 31 | the peer returns a SEND_AUTHENTICATION_INFO_RES message. If this message |
| 32 | contains at least one authentication tuple, the SGSN replaces all tuples that |
| 33 | are assigned to the subscriber. If the message doesn't contain any tuple the |
| 34 | SGSN may reject the Attach Request. (see GSM 09.02, 25.5.6) |
| 35 | |
| 36 | 2.2. Location Updating |
| 37 | |
| 38 | The SGSN sends a UPDATE_LOCATION_REQ to the peer. If the request is denied by |
| 39 | the network, the peer returns an UPDATE_LOCATION_ERR message to the SGSN. |
| 40 | Otherwise the peer returns an UPDATE_LOCATION_RES message containing all |
| 41 | information fields that shall be inserted into the subscriber record. If |
| 42 | the 'PDP info complete' information element is set in the message, the SGSN |
| 43 | clears existing PDP information fields in the subscriber record first. |
| 44 | (see GSM 09.02, 19.1.1.8) |
| 45 | |
| 46 | [...] |
| 47 | |
| 48 | 3. Message Format |
| 49 | |
| 50 | 3.1. General |
| 51 | |
| 52 | Every message is based on the following message format |
| 53 | |
| 54 | IEI Info Element Type Pres. Format Length |
| 55 | Message type 4.2.1 M V 1 |
| 56 | 01 IMSI 4.2.9 M TLV 2-10 |
| 57 | |
| 58 | If a numeric range is indicated in the 'presence' column, multiple information |
| 59 | elements with the same tag may be used in sequence. The information elements |
| 60 | shall be sent in the given order. Nevertheless after the generic part the |
| 61 | receiver shall be able to received them in any order. Unknown IE shall be |
| 62 | ignored. |
| 63 | |
| 64 | 3.2.1. Send Authentication Info Request |
| 65 | |
| 66 | SGSN -> Network peer |
| 67 | |
| 68 | IEI Info Element Type Pres. Format Length |
| 69 | Message type 4.2.1 M V 1 |
| 70 | 01 IMSI 4.2.9 M TLV 2-10 |
| 71 | |
| 72 | 3.2.2. Send Authentication Info Error |
| 73 | |
| 74 | Network peer -> SGSN |
| 75 | |
| 76 | IEI Info Element Type Pres. Format Length |
| 77 | Message type 4.2.1 M V 1 |
| 78 | 01 IMSI 4.2.9 M TLV 2-10 |
| 79 | 02 Cause GMM cause, M TLV 3 |
| 80 | 04.08: 10.5.5.14 |
| 81 | |
| 82 | 3.2.3. Send Authentication Info Response |
| 83 | |
| 84 | Network peer -> SGSN |
| 85 | |
| 86 | IEI Info Element Type Pres. Format Length |
| 87 | Message type 4.2.1 M V 1 |
| 88 | 01 IMSI 4.2.9 M TLV 2-10 |
| 89 | 03 Auth tuple 4.2.5 0-5 TLV 36 |
| 90 | |
| 91 | 3.2.4. Update Location Request |
| 92 | |
| 93 | SGSN -> Network peer |
| 94 | |
| 95 | IEI Info Element Type Pres. Format Length |
| 96 | Message type 4.2.1 M V 1 |
| 97 | 01 IMSI 4.2.9 M TLV 2-10 |
| 98 | |
| 99 | 3.2.5. Update Location Error |
| 100 | |
| 101 | Network peer -> SGSN |
| 102 | |
| 103 | IEI Info Element Type Pres. Format Length |
| 104 | Message type 4.2.1 M V 1 |
| 105 | 01 IMSI 4.2.9 M TLV 2-10 |
| 106 | 02 Cause GMM cause, M TLV 3 |
| 107 | 04.08: 10.5.5.14 |
| 108 | |
| 109 | 3.2.6. Update Location Result |
| 110 | |
| 111 | Network peer -> SGSN |
| 112 | |
| 113 | IEI Info Element Type Pres. Format Length |
| 114 | Message type 4.2.1 M V 1 |
| 115 | 01 IMSI 4.2.9 M TLV 2-10 |
| 116 | 04 PDP info complete 4.2.8 O TLV 2 |
| 117 | 05 PDP info 4.2.3 1-10 TLV |
| 118 | |
| 119 | If the PDP info complete IE is present, the old PDP info list shall be cleared. |
| 120 | |
| 121 | 3.2.7. Location Cancellation Request |
| 122 | |
| 123 | Network peer -> SGSN |
| 124 | |
| 125 | IEI Info Element Type Pres. Format Length |
| 126 | Message type 4.2.1 M V 1 |
| 127 | 01 IMSI 4.2.9 M TLV 2-10 |
| 128 | 06 Cancellation type 4.2.6 M TLV 3 |
| 129 | |
| 130 | 3.2.8. Location Cancellation Result |
| 131 | |
| 132 | SGSN -> Network peer |
| 133 | |
| 134 | IEI Info Element Type Pres. Format Length |
| 135 | Message type 4.2.1 M V 1 |
| 136 | 01 IMSI 4.2.9 M TLV 2-10 |
| 137 | |
| 138 | 3.2.9. Purge MS Request |
| 139 | |
| 140 | SGSN -> Network peer |
| 141 | |
| 142 | IEI Info Element Type Pres. Format Length |
| 143 | Message type 4.2.1 M V 1 |
| 144 | 01 IMSI 4.2.9 M TLV 2-10 |
| 145 | |
| 146 | 3.2.10. Purge MS Error |
| 147 | |
| 148 | Network peer -> SGSN |
| 149 | |
| 150 | TODO |
| 151 | |
| 152 | 3.2.11. Purge MS Result |
| 153 | |
| 154 | Network peer -> SGSN |
| 155 | |
| 156 | TODO |
| 157 | |
| 158 | 3.2.12. Insert Subscriber Data Request |
| 159 | |
| 160 | Network peer -> SGSN |
| 161 | |
| 162 | IEI Info Element Type Pres. Format Length |
| 163 | Message type 4.2.1 M V 1 |
| 164 | 01 IMSI 4.2.9 M TLV 2-10 |
| 165 | 04 PDP info complete 4.2.8 O TLV 2 |
| 166 | 05 PDP info 4.2.3 0-10 TLV |
| 167 | |
| 168 | If the PDP info complete IE is present, the old PDP info list shall be cleared. |
| 169 | |
| 170 | 3.2.13. Insert Subscriber Data Error |
| 171 | |
| 172 | SGSN -> Network peer |
| 173 | |
| 174 | IEI Info Element Type Pres. Format Length |
| 175 | Message type 4.2.1 M V 1 |
| 176 | 01 IMSI 4.2.9 M TLV 2-10 |
| 177 | 02 Cause GMM cause, M TLV 3 |
| 178 | 04.08: 10.5.5.14 |
| 179 | |
| 180 | 3.2.14. Insert Subscriber Data Result |
| 181 | |
| 182 | SGSN -> Network peer |
| 183 | |
| 184 | IEI Info Element Type Pres. Format Length |
| 185 | Message type 4.2.1 M V 1 |
| 186 | 01 IMSI 4.2.9 M TLV 2-10 |
| 187 | |
| 188 | 3.2.15. Delete Subscriber Data Request |
| 189 | |
| 190 | Network peer -> SGSN |
| 191 | |
| 192 | IEI Info Element Type Pres. Format Length |
| 193 | Message type 4.2.1 M V 1 |
| 194 | 01 IMSI 4.2.9 M TLV 2-10 |
| 195 | 10 PDP context id 4.2.3 0-10 TLV |
| 196 | (no conditional IE) |
| 197 | |
| 198 | 3.2.16. Delete Subscriber Data Error |
| 199 | |
| 200 | SGSN -> Network peer |
| 201 | |
| 202 | IEI Info Element Type Pres. Format Length |
| 203 | Message type 4.2.1 M V 1 |
| 204 | 01 IMSI 4.2.9 M TLV 2-10 |
| 205 | 02 Cause GMM cause, M TLV 3 |
| 206 | 04.08: 10.5.5.14 |
| 207 | |
| 208 | 3.2.17. Delete Subscriber Data Result |
| 209 | |
| 210 | Network peer -> SGSN |
| 211 | |
| 212 | IEI Info Element Type Pres. Format Length |
| 213 | Message type 4.2.1 M V 1 |
| 214 | 01 IMSI 4.2.9 M TLV 2-10 |
| 215 | |
| 216 | 4. Information Elements |
| 217 | |
| 218 | 4.1. General |
| 219 | |
| 220 | [...] |
| 221 | |
| 222 | 4.2.1. Message Type |
| 223 | |
| 224 | +---------------------------------------------------+ |
| 225 | | 8 7 6 5 4 3 2 1 | |
| 226 | | | |
| 227 | | 0 0 0 0 0 1 0 0 - Update Location Request | |
| 228 | | 0 0 0 0 0 1 0 1 - Update Location Error | |
| 229 | | 0 0 0 0 0 1 1 0 - Update Location Result | |
| 230 | | | |
| 231 | | 0 0 0 0 1 0 0 0 - Send Auth Info Request | |
| 232 | | 0 0 0 0 1 0 0 1 - Send Auth Info Error | |
| 233 | | 0 0 0 0 1 0 1 0 - Send Auth Info Result | |
| 234 | | | |
| 235 | | 0 0 0 0 1 1 0 0 - Purge MS Request | |
| 236 | | 0 0 0 0 1 1 0 1 - Purge MS Error | |
| 237 | | 0 0 0 0 1 1 1 0 - Purge MS Result | |
| 238 | | | |
| 239 | | 0 0 0 1 0 0 0 0 - Insert Subscr. Data Request | |
| 240 | | 0 0 0 1 0 0 0 1 - Insert Subscr. Data Error | |
| 241 | | 0 0 0 1 0 0 1 0 - Insert Subscr. Data Result | |
| 242 | | | |
| 243 | | 0 0 0 1 0 1 0 0 - Delete Subscr. Data Request | |
| 244 | | 0 0 0 1 0 1 0 1 - Delete Subscr. Data Error | |
| 245 | | 0 0 0 1 0 1 1 0 - Delete Subscr. Data Result | |
| 246 | | | |
| 247 | | 0 0 0 1 1 1 0 0 - Location Cancellation Request | |
| 248 | | 0 0 0 1 1 1 0 1 - Location Cancellation Error | |
| 249 | | 0 0 0 1 1 1 1 0 - Location Cancellation Result | |
| 250 | | | |
| 251 | +---------------------------------------------------+ |
| 252 | |
| 253 | 4.2.2. IP Address |
| 254 | |
| 255 | The value part is encoded like in the Packet data protocol address IE defined |
| 256 | in GSM 04.08, 10.5.6.4. PDP type organization must be set to 'IETF allocated |
| 257 | address'. |
| 258 | |
| 259 | 4.2.3. PDP Info |
| 260 | |
| 261 | This is a container for information elements describing a single PDP. |
| 262 | |
| 263 | IEI Info Element Type Pres. Format Length |
| 264 | PDP Info IEI M V 1 |
| 265 | Length of PDP Info IE length, no ext M V 1 |
| 266 | 10 PDP context id big endian int, 1-N C TLV 3 |
| 267 | 11 PDP type 4.2.4 C TLV 4 |
| 268 | 12 Access point name 04.08, 10.5.6.1 C TLV 3-102 |
| 269 | |
| 270 | The conditional IE are mandantory unless mentioned otherwise. |
| 271 | |
| 272 | 4.2.4. PDP Type |
| 273 | |
| 274 | The PDP type value consists of 2 octets that are encoded like octet 4-5 of the |
| 275 | End User Address defined in GSM 09.60, 7.9.18. |
| 276 | |
| 277 | 8 7 6 5 4 3 2 1 |
| 278 | +-----------------------------------------------------+ |
| 279 | | | PDP type IEI | octet 1 |
| 280 | +-----------------------------------------------------+ |
| 281 | | Length of PDP type IE contents (2) | octet 2 |
| 282 | +-----------------------------------------------------+ |
| 283 | | Spare | PDP type org. | octet 3 |
| 284 | +-----------------------------------------------------+ |
| 285 | | PDP type number | octet 4 |
| 286 | +-----------------------------------------------------+ |
| 287 | |
| 288 | The spare bits are left undefined. While 09.60 defines them as '1 1 1 1', there |
| 289 | are MAP traces where these bits are set to '0 0 0 0'. So the receiver shall |
| 290 | ignore these bits. |
| 291 | |
| 292 | Examples: |
| 293 | |
| 294 | IPv4: PDP type org: 1 (IETF), PDP type number: 0x21 |
| 295 | IPv6: PDP type org: 1 (IETF), PDP type number: 0x57 |
| 296 | |
| 297 | 4.2.5. Auth tuple |
| 298 | |
| 299 | This is a container for information elements describing a single authentication |
| 300 | tuple. |
| 301 | |
| 302 | IEI Info Element Type Pres. Format Length |
| 303 | Auth. Tuple IEI M V 1 |
| 304 | Length of Ath Tuple IE length, no ext M V 1 |
| 305 | 20 RAND octet string (16) M TLV 18 |
| 306 | 21 SRES octet string (4) M TLV 6 |
| 307 | 22 Kc octet string (8) M TLV 10 |
| 308 | |
| 309 | 4.2.6. Cancellation Type |
| 310 | |
| 311 | 8 7 6 5 4 3 2 1 |
| 312 | +-----------------------------------------------------+ |
| 313 | | | Cancellation type IEI | octet 1 |
| 314 | +-----------------------------------------------------+ |
| 315 | | Length of Cancellation Type IE contents (1) | octet 2 |
| 316 | +-----------------------------------------------------+ |
| 317 | | Cancellation type number | octet 4 |
| 318 | +-----------------------------------------------------+ |
| 319 | |
| 320 | Where the cancellation type number is: |
| 321 | |
| 322 | +---------------------------------------------------+ |
| 323 | | 8 7 6 5 4 3 2 1 | |
| 324 | | | |
| 325 | | 0 0 0 0 0 0 0 0 - Update Procedure | |
| 326 | | 0 0 0 0 0 0 0 1 - Subscription Withdraw | |
| 327 | +---------------------------------------------------+ |
| 328 | |
| 329 | 4.2.7. IE Identifier (informational) |
| 330 | |
| 331 | These are the standard values for the IEI. See the message definitions for the |
| 332 | IEI that shall be used for the encoding. |
| 333 | |
| 334 | +---------------------------------------------------------+ |
| 335 | | IEI Info Element Type | |
| 336 | | | |
| 337 | | 0x01 IMSI Mobile identity, 04.08: 10.5.1.4 | |
| 338 | | 0x02 Cause GMM cause, 04.08: 10.5.5.14 | |
| 339 | | 0x03 Auth tuple 4.2.5 | |
| 340 | | 0x04 PDP info compl 4.2.8 | |
| 341 | | 0x05 PDP info 4.2.3 | |
| 342 | | 0x06 Cancel type 4.2.6 | |
| 343 | | 0x10 PDP context id big endian int | |
| 344 | | 0x11 PDP type 4.2.4 | |
| 345 | | 0x12 APN 04.08, 10.5.6.1 | |
| 346 | | 0x20 RAND octet string | |
| 347 | | 0x21 SRES octet string | |
| 348 | | 0x22 Kc octet string | |
| 349 | +---------------------------------------------------------+ |
| 350 | |
| 351 | |
| 352 | 4.2.8 Empty field |
| 353 | |
| 354 | This is used for flags, if and only if this IE is present, the flag is set. |
| 355 | The semantics depend on the IEI and the context. |
| 356 | |
| 357 | 8 7 6 5 4 3 2 1 |
| 358 | +-----------------------------------------------------+ |
| 359 | | | IEI | octet 1 |
| 360 | +-----------------------------------------------------+ |
| 361 | | Length of IE contents (0) | octet 2 |
| 362 | +-----------------------------------------------------+ |
| 363 | |
| 364 | 4.2.9. IMSI |
| 365 | |
| 366 | The IMSI is encoded like in octet 4-N of the Called Party BCD Number defined in GSM 04.08, 10.5.4.7. |
| 367 | |
| 368 | 8 7 6 5 4 3 2 1 |
| 369 | +-----------------------------------------------------+ |
| 370 | | | IMSI IEI | octet 1 |
| 371 | +-----------------------------------------------------+ |
| 372 | | Length of IMSI IE contents | octet 2 |
| 373 | +-----------------------------------------------------+ |
| 374 | | Number digit 2 | Number digit 1 | octet 3 |
| 375 | +-----------------------------------------------------+ |
| 376 | | Number digit 4 | Number digit 3 | octet 4 |
| 377 | +-----------------------------------------------------+ |
| 378 | : : : |
| 379 | +-----------------------------------------------------+ |
| 380 | | see note 1) | octet 2+(N+1)div2 |
| 381 | +-----------------------------------------------------+ |
| 382 | |
| 383 | Note 1) Either '1 1 1 1 | Number digit N' (N odd) or |
| 384 | 'Number digit N | Number digit N-1' (N even), |
| 385 | where N is the number of digits. |