api-console-assets

<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"> <style> .KEYW {color: #933;} .COMM {color: #bbb; font-style: italic;} .NUMB {color: #393;} .STRN {color: #393;} .REGX {color: #339;} .line {border-right: 1px dotted #666; color: #666; font-style: normal;} </style></head><body><pre> 1 /* asn1hex-1.2.0.js (c) 2012-2017 Kenji Urushima | kjur.github.com/jsrsasign/license 2 */ 3 /* 4 * asn1hex.js - Hexadecimal represented ASN.1 string library 5 * 6 * Copyright (c) 2010-2017 Kenji Urushima (kenji.urushima@gmail.com) 7 * 8 * This software is licensed under the terms of the MIT License. 9 * https://kjur.github.io/jsrsasign/license/ 10 * 11 * The above copyright and license notice shall be 12 * included in all copies or substantial portions of the Software. 13 */ 14 15 /** 16 * @fileOverview 17 * @name asn1hex-1.1.js 18 * @author Kenji Urushima kenji.urushima@gmail.com 19 * @version asn1hex 1.2.0 (2017-Jun-24) 20 * @license <a href="https://kjur.github.io/jsrsasign/license/">MIT License</a> 21 */ 22 23 /* 24 * MEMO: 25 * f('3082025b02...', 2) ... 82025b ... 3bytes 26 * f('020100', 2) ... 01 ... 1byte 27 * f('0203001...', 2) ... 03 ... 1byte 28 * f('02818003...', 2) ... 8180 ... 2bytes 29 * f('3080....0000', 2) ... 80 ... -1 30 * 31 * Requirements: 32 * - ASN.1 type octet length MUST be 1. 33 * (i.e. ASN.1 primitives like SET, SEQUENCE, INTEGER, OCTETSTRING ...) 34 */ 35 36 /** 37 * ASN.1 DER encoded hexadecimal string utility class 38 * @name ASN1HEX 39 * @class ASN.1 DER encoded hexadecimal string utility class 40 * @since jsrsasign 1.1 41 * @description 42 * This class provides a parser for hexadecimal string of 43 * DER encoded ASN.1 binary data. 44 * Here are major methods of this class. 45 * <ul> 46 * <li>ACCESS BY POSITION 47 * <ul> 48 * <li>{@link ASN1HEX.getTLV} - get ASN.1 TLV at specified position</li> 49 * <li>{@link ASN1HEX.getV} - get ASN.1 V at specified position</li> 50 * <li>{@link ASN1HEX.getVlen} - get integer ASN.1 L at specified position</li> 51 * <li>{@link ASN1HEX.getVidx} - get ASN.1 V position from its ASN.1 TLV position</li> 52 * <li>{@link ASN1HEX.getL} - get hexadecimal ASN.1 L at specified position</li> 53 * <li>{@link ASN1HEX.getLblen} - get byte length for ASN.1 L(length) bytes</li> 54 * </ul> 55 * </li> 56 * <li>ACCESS FOR CHILD ITEM 57 * <ul> 58 * <li>{@link ASN1HEX.getNthChildIndex_AtObj} - get nth child index at specified position</li> 59 * <li>{@link ASN1HEX.getPosArrayOfChildren_AtObj} - get indexes of children</li> 60 * <li>{@link ASN1HEX.getPosOfNextSibling_AtObj} - get position of next sibling</li> 61 * </ul> 62 * </li> 63 * <li>ACCESS NESTED ASN.1 STRUCTURE 64 * <ul> 65 * <li>{@link ASN1HEX.getTLVbyList} - get ASN.1 TLV at specified list index</li> 66 * <li>{@link ASN1HEX.getVbyList} - get ASN.1 V at specified nth list index with checking expected tag</li> 67 * <li>{@link ASN1HEX.getIdxbyList} - get index at specified list index</li> 68 * </ul> 69 * </li> 70 * <li>UTILITIES 71 * <ul> 72 * <li>{@link ASN1HEX.dump} - dump ASN.1 structure</li> 73 * <li>{@link ASN1HEX.isASN1HEX} - check whether ASN.1 hexadecimal string or not</li> 74 * <li>{@link ASN1HEX.hextooidstr} - convert hexadecimal string of OID to dotted integer list</li> 75 * </ul> 76 * </li> 77 * </ul> 78 */ 79 var ASN1HEX = new function() { 80 }; 81 82 /** 83 * get byte length for ASN.1 L(length) bytes 84 * @name getLblen 85 * @memberOf ASN1HEX 86 * @function 87 * @param {String} s hexadecimal string of ASN.1 DER encoded data 88 * @param {Number} idx string index 89 * @return byte length for ASN.1 L(length) bytes 90 * @since jsrsasign 7.2.0 asn1hex 1.1.11 91 * @example 92 * ASN1HEX.getLblen('020100', 0) → 1 for '01' 93 * ASN1HEX.getLblen('020200', 0) → 1 for '02' 94 * ASN1HEX.getLblen('02818003...', 0) → 2 for '8180' 95 * ASN1HEX.getLblen('0282025b03...', 0) → 3 for '82025b' 96 * ASN1HEX.getLblen('0280020100...', 0) → -1 for '80' BER indefinite length 97 * ASN1HEX.getLblen('02ffab...', 0) → -2 for malformed ASN.1 length 98 */ 99 ASN1HEX.getLblen = function(s, idx) { 100 if (s.substr(idx + 2, 1) != '8') return 1; 101 var i = parseInt(s.substr(idx + 3, 1)); 102 if (i == 0) return -1; // length octet '80' indefinite length 103 if (0 < i && i < 10) return i + 1; // including '8?' octet; 104 return -2; // malformed format 105 }; 106 107 /** 108 * get hexadecimal string for ASN.1 L(length) bytes 109 * @name getL 110 * @memberOf ASN1HEX 111 * @function 112 * @param {String} s hexadecimal string of ASN.1 DER encoded data 113 * @param {Number} idx string index to get L of ASN.1 object 114 * @return {String} hexadecimal string for ASN.1 L(length) bytes 115 * @since jsrsasign 7.2.0 asn1hex 1.1.11 116 */ 117 ASN1HEX.getL = function(s, idx) { 118 var len = ASN1HEX.getLblen(s, idx); 119 if (len < 1) return ''; 120 return s.substr(idx + 2, len * 2); 121 }; 122 123 /** 124 * get integer value of ASN.1 length for ASN.1 data 125 * @name getVblen 126 * @memberOf ASN1HEX 127 * @function 128 * @param {String} s hexadecimal string of ASN.1 DER encoded data 129 * @param {Number} idx string index 130 * @return ASN.1 L(length) integer value 131 * @since jsrsasign 7.2.0 asn1hex 1.1.11 132 */ 133 /* 134 getting ASN.1 length value at the position 'idx' of 135 hexa decimal string 's'. 136 f('3082025b02...', 0) ... 82025b ... ??? 137 f('020100', 0) ... 01 ... 1 138 f('0203001...', 0) ... 03 ... 3 139 f('02818003...', 0) ... 8180 ... 128 140 */ 141 ASN1HEX.getVblen = function(s, idx) { 142 var hLen, bi; 143 hLen = ASN1HEX.getL(s, idx); 144 if (hLen == '') return -1; 145 if (hLen.substr(0, 1) === '8') { 146 bi = new BigInteger(hLen.substr(2), 16); 147 } else { 148 bi = new BigInteger(hLen, 16); 149 } 150 return bi.intValue(); 151 }; 152 153 /** 154 * get ASN.1 value starting string position for ASN.1 object refered by index 'idx'. 155 * @name getVidx 156 * @memberOf ASN1HEX 157 * @function 158 * @param {String} s hexadecimal string of ASN.1 DER encoded data 159 * @param {Number} idx string index 160 * @since jsrsasign 7.2.0 asn1hex 1.1.11 161 */ 162 ASN1HEX.getVidx = function(s, idx) { 163 var l_len = ASN1HEX.getLblen(s, idx); 164 if (l_len < 0) return l_len; 165 return idx + (l_len + 1) * 2; 166 }; 167 168 /** 169 * get hexadecimal string of ASN.1 V(value) 170 * @name getV 171 * @memberOf ASN1HEX 172 * @function 173 * @param {String} s hexadecimal string of ASN.1 DER encoded data 174 * @param {Number} idx string index 175 * @return {String} hexadecimal string of ASN.1 value. 176 * @since jsrsasign 7.2.0 asn1hex 1.1.11 177 */ 178 ASN1HEX.getV = function(s, idx) { 179 var idx1 = ASN1HEX.getVidx(s, idx); 180 var blen = ASN1HEX.getVblen(s, idx); 181 return s.substr(idx1, blen * 2); 182 }; 183 184 /** 185 * get hexadecimal string of ASN.1 TLV at 186 * @name getTLV 187 * @memberOf ASN1HEX 188 * @function 189 * @param {String} s hexadecimal string of ASN.1 DER encoded data 190 * @param {Number} idx string index 191 * @return {String} hexadecimal string of ASN.1 TLV. 192 * @since jsrsasign 7.2.0 asn1hex 1.1.11 193 */ 194 ASN1HEX.getTLV = function(s, idx) { 195 return s.substr(idx, 2) + ASN1HEX.getL(s, idx) + ASN1HEX.getV(s, idx); 196 }; 197 198 // ========== sibling methods ================================ 199 200 /** 201 * get next sibling starting index for ASN.1 object string 202 * @name getNextSiblingIdx 203 * @memberOf ASN1HEX 204 * @function 205 * @param {String} s hexadecimal string of ASN.1 DER encoded data 206 * @param {Number} idx string index 207 * @return next sibling starting index for ASN.1 object string 208 * @since jsrsasign 7.2.0 asn1hex 1.1.11 209 * @example 210 * SEQUENCE { INTEGER 3, INTEGER 4 } 211 * 3006 212 * 020103 :idx=4 213 * 020104 :next sibling idx=10 214 * getNextSiblingIdx("3006020103020104", 4) & rarr 10 215 */ 216 ASN1HEX.getNextSiblingIdx = function(s, idx) { 217 var idx1 = ASN1HEX.getVidx(s, idx); 218 var blen = ASN1HEX.getVblen(s, idx); 219 return idx1 + blen * 2; 220 }; 221 222 // ========== children methods =============================== 223 /** 224 * get array of string indexes of child ASN.1 objects 225 * @name getChildIdx 226 * @memberOf ASN1HEX 227 * @function 228 * @param {String} h hexadecimal string of ASN.1 DER encoded data 229 * @param {Number} pos start string index of ASN.1 object 230 * @return {Array of Number} array of indexes for childen of ASN.1 objects 231 * @since jsrsasign 7.2.0 asn1hex 1.1.11 232 * @description 233 * This method returns array of integers for a concatination of ASN.1 objects 234 * in a ASN.1 value. As for BITSTRING, one byte of unusedbits is skipped. 235 * As for other ASN.1 simple types such as INTEGER, OCTET STRING or PRINTABLE STRING, 236 * it returns a array of a string index of its ASN.1 value. 237 * NOTE: Since asn1hex 1.1.7 of jsrsasign 6.1.2, Encapsulated BitString is supported. 238 * @example 239 * ASN1HEX.getChildIdx("0203012345", 0) ⇒ [4] // INTEGER 012345 240 * ASN1HEX.getChildIdx("1303616161", 0) ⇒ [4] // PrintableString aaa 241 * ASN1HEX.getChildIdx("030300ffff", 0) ⇒ [6] // BITSTRING ffff (unusedbits=00a) 242 * ASN1HEX.getChildIdx("3006020104020105", 0) ⇒ [4, 10] // SEQUENCE(INT4,INT5) 243 */ 244 ASN1HEX.getChildIdx = function(h, pos) { 245 var _ASN1HEX = ASN1HEX; 246 var a = new Array(); 247 var p0 = _ASN1HEX.getVidx(h, pos); 248 if (h.substr(pos, 2) == "03") { 249 a.push(p0 + 2); // BITSTRING value without unusedbits 250 } else { 251 a.push(p0); 252 } 253 254 var blen = _ASN1HEX.getVblen(h, pos); 255 var p = p0; 256 var k = 0; 257 while (1) { 258 var pNext = _ASN1HEX.getNextSiblingIdx(h, p); 259 if (pNext == null || (pNext - p0 >= (blen * 2))) break; 260 if (k >= 200) break; 261 262 a.push(pNext); 263 p = pNext; 264 265 k++; 266 } 267 268 return a; 269 }; 270 271 /** 272 * get string index of nth child object of ASN.1 object refered by h, idx 273 * @name getNthChildIdx 274 * @memberOf ASN1HEX 275 * @function 276 * @param {String} h hexadecimal string of ASN.1 DER encoded data 277 * @param {Number} idx start string index of ASN.1 object 278 * @param {Number} nth for child 279 * @return {Number} string index of nth child. 280 * @since jsrsasign 7.2.0 asn1hex 1.1.11 281 */ 282 ASN1HEX.getNthChildIdx = function(h, idx, nth) { 283 var a = ASN1HEX.getChildIdx(h, idx); 284 return a[nth]; 285 }; 286 287 // ========== decendant methods ============================== 288 /** 289 * get string index of nth child object of ASN.1 object refered by h, idx 290 * @name getIdxbyList 291 * @memberOf ASN1HEX 292 * @function 293 * @param {String} h hexadecimal string of ASN.1 DER encoded data 294 * @param {Number} currentIndex start string index of ASN.1 object 295 * @param {Array of Number} nthList array list of nth 296 * @param {String} checkingTag (OPTIONAL) string of expected ASN.1 tag for nthList 297 * @return {Number} string index refered by nthList 298 * @since jsrsasign 7.1.4 asn1hex 1.1.10. 299 * @description 300 * @example 301 * The "nthList" is a index list of structured ASN.1 object 302 * reference. Here is a sample structure and "nthList"s which 303 * refers each objects. 304 * 305 * SQUENCE - 306 * SEQUENCE - [0] 307 * IA5STRING 000 - [0, 0] 308 * UTF8STRING 001 - [0, 1] 309 * SET - [1] 310 * IA5STRING 010 - [1, 0] 311 * UTF8STRING 011 - [1, 1] 312 */ 313 ASN1HEX.getIdxbyList = function(h, currentIndex, nthList, checkingTag) { 314 var _ASN1HEX = ASN1HEX; 315 var firstNth, a; 316 if (nthList.length == 0) { 317 if (checkingTag !== undefined) { 318 if (h.substr(currentIndex, 2) !== checkingTag) { 319 throw "checking tag doesn't match: " + 320 h.substr(currentIndex, 2) + "!=" + checkingTag; 321 } 322 } 323 return currentIndex; 324 } 325 firstNth = nthList.shift(); 326 a = _ASN1HEX.getChildIdx(h, currentIndex); 327 return _ASN1HEX.getIdxbyList(h, a[firstNth], nthList, checkingTag); 328 }; 329 330 /** 331 * get ASN.1 TLV by nthList 332 * @name getTLVbyList 333 * @memberOf ASN1HEX 334 * @function 335 * @para