QUESTION
Chain of Trust와 auth_mod_verify_img 단계에서 실제로 바뀌는 상태는 무엇인가?
상위 이미지 탐색과 적재·인증은 Generic code와 IO framework가 CoT를 따라 진행한다. auth_mod_verify_img()는 전달받은 현재 이미지의 설명자를 조회하고, 그 설명자에 지정된 검사만 수행한다.
상위 인증 이미지에서 보존한 공개키·해시 또는 플랫폼의 ROTPK가 현재 이미지 검증의 입력이 된다. 이 함수가 parent를 재귀적으로 다시 적재하거나 인증하는 것으로 읽으면 호출 경계가 뒤바뀐다.
STRUCTURE
상위 신뢰 상태와 현재 이미지 검증의 경계
auth_mod_verify_img()의 현재 이미지 검사 (원본 코드 L484–529)상위 이미지부터 적재·인증
Generic code가 CoT의 parent를 따라 올라갔다가 신뢰 뿌리부터 이미지를 순서대로 적재·인증한다. 현재 이미지 검증에 필요한 인증 매개변수는 앞서 인증한 이미지에서 보존되며, 루트 서명은 플랫폼 ROTPK를 사용한다.
auth_mod_verify_img(img_id, img_ptr, img_len)
- L468–470현재 이미지 입력
img_id · img_ptr · img_len - L484CoT 설명자 조회
FCONF_GET_PROPERTY(tbbr, cot, img_id) - L486–492파서 무결성 검사
img_parser_check_integrity(...) - L496–529지정된 방법 순회
img_desc->img_auth_methods[i]
각 슬롯의 type에 따라 HASH · SIG · NV_CTR 중 해당 검사를 호출한다. NONE은 검사를 하지 않는다. 세 방법을 모든 이미지에 일괄 적용하는 순서도가 아니다.
파서 또는 선택한 방법이 rc != 0이면 즉시 rc 반환. 방법 배열이 없으면 1 반환.
모든 슬롯이 통과하면 L529의 반복문을 벗어나 L531 이후 처리로 이어진다. 이 구간만으로 최종 승인 상태를 단정하지 않는다.
상위 경로는 TF-A Authentication Framework 설명의 Generic code 책임이고, 아래 네 단계와 오류 분기는 이 글의 L468–532 고정 코드에 대응한다.
CALL PATH
현재 이미지 한 개를 검증하는 실행 흐름
auth_mod_verify_img()의 주요 분기 (TF-A LTS 2.14.3)상위 인증서 탐색·적재는 이 함수 밖에서 끝난다. 이 함수는 파서·방법·갱신·추출 실패 시 즉시 오류를 반환하며, NV 갱신과 매개변수 추출은 조건이 맞을 때만 수행한다. 인용 코드 L532는 주석 중간에서 끝나므로 마지막 두 칸은 동일 버전의 전체 함수로 확인했다.
STATE LEDGER
단계별 입력과 출력
그림 2의 여섯 단계를 실제 읽는 값과 반환 경계로 풀었다. 상위 CoT 적재는 앞선 호출자의 일이며, 아래 표는 현재 이미지 한 개의 함수 내부만 다룬다.
| # | 함수 안 단계 | 읽는 값 | 통과 시 상태 | 실패·조건 |
|---|---|---|---|---|
| 01 | CoT 설명자 조회 | img_id | img_desc 선택 | 설명자 유효성은 호출 전제에 포함 |
| 02 | 파서 무결성 검사 | img_type, buffer, 길이 | 방법 검사로 진행 | rc != 0이면 반환 |
| 03 | 인증 방법 순회 | img_auth_methods[i]와 필요한 매개변수 | 각 슬롯의 HASH·SIG·NV_CTR 검사 통과 | 배열 없음·알 수 없는 방법·검사 실패 시 반환 |
| 04 | 조건부 NV 갱신 | need_nv_ctr_upgrade, sig_auth_done | 필요할 때 plat_set_nv_ctr2() 완료 | 갱신 실패 시 반환 |
| 05 | 자식용 매개변수 추출 | authenticated_data 설명자와 현재 이미지 | 파서가 찾은 값을 별도 buffer에 복사 | 파서·크기 검사 실패 시 반환 |
| 06 | 현재 이미지 승인 | 위 조건의 성공 | IMG_FLAG_AUTHENTICATED 설정 후 0 반환 | 적재·handoff는 호출자의 별도 단계 |
03단계의 방법은 이미지 설명자에 지정된 것만 실행된다. 04–06단계는 이 글의 발췌 L532 뒤에 있으므로 동일 버전 전체 소스를 함께 보아야 한다.
VISUAL WALKTHROUGH
CoT의 상위 관계와 현재 함수의 순서를 구분하기
상위 인증 이미지는 다음 이미지에 필요한 공개키·해시를 남긴다. 이 관계는 앞의 그림 2에 표시한 현재 이미지 한 개의 함수 호출 순서와 범위가 다르다.
전체 CoT에서 신뢰가 전달되는 방향이다. 한 번의 auth_mod_verify_img() 호출을 네 번으로 나눈 그림이 아니다.
TBBR의 certificate와 BL 이미지에서 어떤 값이 다음 검증에 쓰이는지를 단순화한 관계다.
플랫폼 ROTPK→루트 certificate 서명 확인→인증된 공개키인증된 key certificate→다음 공개키→다음 certificate인증된 content certificate→보존된 해시→대상 BL 이미지NV 방법을 지정한 certificate→rollback 비교→조건부 counter 갱신UPSTREAM SOURCE
원본 코드
원문 Trusted Firmware-A LTS 2.14.3 · drivers/auth/auth_mod.c의 468–593행입니다.
468int auth_mod_verify_img(unsigned int img_id,
469 void *img_ptr,
470 unsigned int img_len)
471{
472 const auth_img_desc_t *img_desc = NULL;
473 const auth_param_type_desc_t *type_desc = NULL;
474 const auth_method_desc_t *auth_method = NULL;
475 void *param_ptr;
476 unsigned int param_len;
477 int rc, i;
478 unsigned int cert_nv_ctr = 0;
479 bool need_nv_ctr_upgrade = false;
480 bool sig_auth_done = false;
481 const auth_method_param_nv_ctr_t *nv_ctr_param = NULL;
482
483 /* Get the image descriptor from the chain of trust */
484 img_desc = FCONF_GET_PROPERTY(tbbr, cot, img_id);
485
486 /* Ask the parser to check the image integrity */
487 rc = img_parser_check_integrity(img_desc->img_type, img_ptr, img_len);
488 if (rc != 0) {
489 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
490 __func__, __LINE__, rc);
491 return rc;
492 }
493
494 /* Authenticate the image using the methods indicated in the image
495 * descriptor. */
496 if (img_desc->img_auth_methods == NULL)
497 return 1;
498 for (i = 0 ; i < AUTH_METHOD_NUM ; i++) {
499 auth_method = &img_desc->img_auth_methods[i];
500 switch (auth_method->type) {
501 case AUTH_METHOD_NONE:
502 rc = 0;
503 break;
504 case AUTH_METHOD_HASH:
505 rc = auth_hash(&auth_method->param.hash,
506 img_desc, img_ptr, img_len);
507 break;
508 case AUTH_METHOD_SIG:
509 rc = auth_signature(&auth_method->param.sig,
510 img_desc, img_ptr, img_len);
511 sig_auth_done = true;
512 break;
513 case AUTH_METHOD_NV_CTR:
514 nv_ctr_param = &auth_method->param.nv_ctr;
515 rc = auth_nvctr(nv_ctr_param,
516 img_desc, img_ptr, img_len,
517 &cert_nv_ctr, &need_nv_ctr_upgrade);
518 break;
519 default:
520 /* Unknown authentication method */
521 rc = 1;
522 break;
523 }
524 if (rc != 0) {
525 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
526 __func__, __LINE__, rc);
527 return rc;
528 }
529 }
530
531 /*
532 * Do platform NV counter upgrade only if the certificate gets
533 * authenticated, and platform NV-counter upgrade is needed.
534 */
535 if (need_nv_ctr_upgrade && sig_auth_done) {
536 rc = plat_set_nv_ctr2(nv_ctr_param->plat_nv_ctr->cookie,
537 img_desc, cert_nv_ctr);
538 if (rc != 0) {
539 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
540 __func__, __LINE__, rc);
541 return rc;
542 }
543 }
544
545 /* Extract the parameters indicated in the image descriptor to
546 * authenticate the children images. */
547 if (img_desc->authenticated_data != NULL) {
548 for (i = 0 ; i < COT_MAX_VERIFIED_PARAMS ; i++) {
549 if (img_desc->authenticated_data[i].type_desc == NULL) {
550 continue;
551 }
552
553 /* Get the parameter from the image parser module */
554 rc = img_parser_get_auth_param(img_desc->img_type,
555 img_desc->authenticated_data[i].type_desc,
556 img_ptr, img_len, ¶m_ptr, ¶m_len);
557 if (rc != 0) {
558 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
559 __func__, __LINE__, rc);
560 return rc;
561 }
562
563 /* Check parameter size */
564 if (param_len > img_desc->authenticated_data[i].data.len) {
565 return 1;
566 }
567
568 /* Copy the parameter for later use */
569 memcpy((void *)img_desc->authenticated_data[i].data.ptr,
570 (void *)param_ptr, param_len);
571
572 /*
573 * If this is a public key then measure and publicise
574 * it.
575 */
576 type_desc = img_desc->authenticated_data[i].type_desc;
577 if (type_desc->type == AUTH_PARAM_PUB_KEY) {
578 rc = plat_mboot_measure_key(type_desc->cookie,
579 param_ptr,
580 param_len);
581 if (rc != 0) {
582 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
583 __func__, __LINE__, rc);
584 }
585 }
586 }
587 }
588
589 /* Mark image as authenticated */
590 auth_img_flags[img_desc->img_id] |= IMG_FLAG_AUTHENTICATED;
591
592 return 0;
593}
READING CONTRACT
발췌 범위와 읽기 기준
원문 468–593행은 auth_mod_verify_img() 전체를 담습니다. 현재 이미지 검사에서 조건부 NV counter 갱신, 자식용 인증 매개변수 추출, 인증 플래그 설정까지 이어지는 경로를 확인할 수 있습니다.
조건부 counter 갱신, 자식용 매개변수 추출, 인증 플래그 설정은 같은 LTS 2.14.3 파일의 L535–592에서 확인한다. 상위 이미지의 탐색·적재는 이 함수가 아닌 Generic code/IO의 책임이다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.
01. certificate signature와 public key를 검증
drivers/auth/auth_mod.c 146-260줄이다.
146 * case, the signature verification is considered just an integrity check and
147 * the authentication is established by calculating the hash of the key and
148 * comparing it with the hash obtained from the parent.
149 *
150 * If the image has no parent (NULL), it means it has to be authenticated using
151 * the ROTPK stored in the platform. Again, this ROTPK could be the key itself
152 * or a hash of it.
153 *
154 * Return: 0 = success, Otherwise = error
155 */
156static int auth_signature(const auth_method_param_sig_t *param,
157 const auth_img_desc_t *img_desc,
158 void *img, unsigned int img_len)
159{
160 void *data_ptr, *pk_ptr, *cnv_pk_ptr, *pk_plat_ptr, *sig_ptr, *sig_alg_ptr, *pk_oid;
161 unsigned int data_len, pk_len, cnv_pk_len, pk_plat_len, sig_len, sig_alg_len;
162 unsigned int flags = 0;
163 int rc;
164
165 /* Get the data to be signed from current image */
166 rc = img_parser_get_auth_param(img_desc->img_type, param->data,
167 img, img_len, &data_ptr, &data_len);
168 if (rc != 0) {
169 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
170 __func__, __LINE__, rc);
171 return rc;
172 }
173
174 /* Get the signature from current image */
175 rc = img_parser_get_auth_param(img_desc->img_type, param->sig,
176 img, img_len, &sig_ptr, &sig_len);
177 if (rc != 0) {
178 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
179 __func__, __LINE__, rc);
180 return rc;
181 }
182
183 /* Get the signature algorithm from current image */
184 rc = img_parser_get_auth_param(img_desc->img_type, param->alg,
185 img, img_len, &sig_alg_ptr, &sig_alg_len);
186 if (rc != 0) {
187 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
188 __func__, __LINE__, rc);
189 return rc;
190 }
191
192 /*
193 * Set Zero-OID for ROTPK(subject key) as a the certificate
194 * does not hold Key-OID information for ROTPK.
195 */
196 if (param->pk->cookie != NULL) {
197 pk_oid = param->pk->cookie;
198 } else {
199 pk_oid = ZERO_OID;
200 }
201
202 set_current_pk_oid(pk_oid);
203
204 /* Get the public key from the parent. If there is no parent (NULL),
205 * the certificate has been signed with the ROTPK, so we have to get
206 * the PK from the platform */
207 if (img_desc->parent != NULL) {
208 rc = auth_get_param(param->pk, img_desc->parent,
209 &pk_ptr, &pk_len);
210 if (rc != 0) {
211 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
212 __func__, __LINE__, rc);
213 return rc;
214 }
215 } else {
216 /*
217 * Root certificates are signed with the ROTPK, so we have to
218 * get it from the platform.
219 */
220 rc = plat_get_rotpk_info(param->pk->cookie, &pk_plat_ptr,
221 &pk_plat_len, &flags);
222 if (rc != 0) {
223 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
224 __func__, __LINE__, rc);
225 return rc;
226 }
227
228 assert(is_rotpk_flags_valid(flags));
229
230 /* Also retrieve the key from the image. */
231 rc = img_parser_get_auth_param(img_desc->img_type,
232 param->pk, img, img_len,
233 &pk_ptr, &pk_len);
234 if (rc != 0) {
235 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
236 __func__, __LINE__, rc);
237 return rc;
238 }
239
240 /*
241 * Validate the certificate's key against the platform ROTPK.
242 *
243 * Platform may store key in one of the following way -
244 * 1. Hash of ROTPK
245 * 2. Hash if prefixed, suffixed or modified ROTPK
246 * 3. Full ROTPK
247 */
248 if ((flags & ROTPK_NOT_DEPLOYED) != 0U) {
249 NOTICE("ROTPK is not deployed on platform. "
250 "Skipping ROTPK verification.\n");
251 } else if ((flags & ROTPK_IS_HASH) != 0U) {
252 /*
253 * platform may store the hash of a prefixed,
254 * suffixed or modified pk
255 */
256 rc = crypto_mod_convert_pk(pk_ptr, pk_len, &cnv_pk_ptr, &cnv_pk_len);
257 if (rc != 0) {
258 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
259 __func__, __LINE__, rc);
260 return rc;
02. certificate와 platform counter를 비교하는 rollback 검사
drivers/auth/auth_mod.c 313-421줄이다.
313 * value that should not be lower than the value stored in the platform. If the
314 * value is larger, the counter in the platform must be updated to the new value
315 * (provided it has been authenticated).
316 *
317 * Return: 0 = success, Otherwise = error
318 * Returns additionally,
319 * cert_nv_ctr -> NV counter value present in the certificate
320 * need_nv_ctr_upgrade = 0 -> platform NV counter upgrade is not needed
321 * need_nv_ctr_upgrade = 1 -> platform NV counter upgrade is needed
322 */
323static int auth_nvctr(const auth_method_param_nv_ctr_t *param,
324 const auth_img_desc_t *img_desc,
325 void *img, unsigned int img_len,
326 unsigned int *cert_nv_ctr,
327 bool *need_nv_ctr_upgrade)
328{
329 unsigned char *p;
330 void *data_ptr = NULL;
331 unsigned int data_len, len, i;
332 unsigned int plat_nv_ctr;
333 int rc;
334
335 /* Get the counter value from current image. The AM expects the IPM
336 * to return the counter value as a DER encoded integer */
337 rc = img_parser_get_auth_param(img_desc->img_type, param->cert_nv_ctr,
338 img, img_len, &data_ptr, &data_len);
339 if (rc != 0) {
340 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
341 __func__, __LINE__, rc);
342 return rc;
343 }
344
345 /* Parse the DER encoded integer */
346 assert(data_ptr);
347 p = (unsigned char *)data_ptr;
348
349 /*
350 * Integers must be at least 3 bytes: 1 for tag, 1 for length, and 1
351 * for value. The first byte (tag) must be ASN1_INTEGER.
352 */
353 if ((data_len < 3) || (*p != ASN1_INTEGER)) {
354 /* Invalid ASN.1 integer */
355 return 1;
356 }
357 p++;
358
359 /*
360 * NV-counters are unsigned integers up to 31 bits. Trailing
361 * padding is not allowed.
362 */
363 len = (unsigned int)*p;
364 if ((len > 4) || (data_len - 2 != len)) {
365 return 1;
366 }
367 p++;
368
369 /* Check the number is not negative */
370 if (*p & 0x80) {
371 return 1;
372 }
373
374 /* Convert to unsigned int. This code is for a little-endian CPU */
375 *cert_nv_ctr = 0;
376 for (i = 0; i < len; i++) {
377 *cert_nv_ctr = (*cert_nv_ctr << 8) | *p++;
378 }
379
380 /* Get the counter from the platform */
381 rc = plat_get_nv_ctr(param->plat_nv_ctr->cookie, &plat_nv_ctr);
382 if (rc != 0) {
383 VERBOSE("[TBB] %s():%d failed with error code %d.\n",
384 __func__, __LINE__, rc);
385 return rc;
386 }
387
388 if (*cert_nv_ctr < plat_nv_ctr) {
389 /* Invalid NV-counter */
390 return 1;
391 } else if (*cert_nv_ctr > plat_nv_ctr) {
392#if PSA_FWU_SUPPORT && IMAGE_BL2
393 if (fwu_get_active_bank_state() == FWU_BANK_STATE_ACCEPTED) {
394 *need_nv_ctr_upgrade = true;
395 } else {
396 *need_nv_ctr_upgrade = false;
397 }
398#elif PSA_FWU_SUPPORT && IMAGE_BL1
399 /* The check is for bl1 only */
400 if (bl1_plat_is_shared_nv_ctr() == false) {
401 /* If NV ctr is not shared, it can be upgraded */
402 *need_nv_ctr_upgrade = true;
403 } else {
404 /* If NV ctr is shared, the upgrade should happens in BL2 */
405 *need_nv_ctr_upgrade = false;
406 }
407#else
408 *need_nv_ctr_upgrade = true;
409#endif /* PSA_FWU_SUPPORT && IMAGE_BL2 */
410 }
411
412 return 0;
413}
414
415int plat_set_nv_ctr2(void *cookie, const auth_img_desc_t *img_desc __unused,
416 unsigned int nv_ctr)
417{
418 return plat_set_nv_ctr(cookie, nv_ctr);
419}
420
421/*
DETAILS
코드에서 상태가 바뀌는 지점
호출 전에 상위 경로를 준비한다
BL1/BL2의 Generic code는 CoT의 parent를 따라 필요한 인증 이미지를 적재·검증한다. auth_mod_verify_img()는 전달된 img_id, img_ptr, img_len으로 현재 이미지 한 개를 검사한다.
설명자를 조회하고 형식을 검사한다
L484에서 CoT 설명자를 조회하고, L487에서 설명자의 img_type에 맞춰 파서 무결성 검사를 한다. 이 함수가 설명자를 동적 할당하거나 list에 등록하는 코드는 보이지 않는다.
지정된 방법만 실행한다
img_auth_methods 배열이 없으면 1을 반환한다. 배열의 각 슬롯에서 HASH, SIG, NV_CTR 또는 NONE을 분기하며, 각 검사 실패 시 즉시 반환한다.
NV counter 갱신 조건을 따로 본다
방법 순회가 끝나도 무조건 persistent counter를 쓰지 않는다. 전체 함수 L535–543에서는 need_nv_ctr_upgrade && sig_auth_done일 때만 plat_set_nv_ctr2()를 호출한다.
다음 이미지의 값과 현재 이미지의 승인 상태를 남긴다
설명자에 authenticated_data가 있으면 파서가 값을 추출하고 크기를 검사한 뒤 보존 buffer로 복사한다. 그 뒤 auth_img_flags[img_id]에 IMG_FLAG_AUTHENTICATED를 설정하고 0을 반환한다. 다음 이미지 적재와 handoff는 호출자의 별도 경로다.
IMPLEMENTATION NOTES
소유권과 실패 경계를 더 깊게 읽기
parent 탐색과 현재 이미지 검증의 소유자가 다르다
공식 인증 프레임워크 문서는 Generic code가 parent를 재귀적으로 묻고 IO로 적재한 뒤 신뢰 뿌리에서 현재 이미지로 내려오며 인증한다고 설명한다. 이 함수 안에서는 이미 전달받은 현재 이미지의 설명자와 method만 순회한다.
설명자와 매개변수 buffer는 이미지 buffer와 수명이 다르다
auth_img_desc_t와 method 설명자는 플랫폼이 구성한 CoT의 일부다. parent 이미지 적재 메모리는 child에 재사용될 수 있어, child가 쓸 공개키·해시는 플랫폼이 별도로 정적으로 할당한 authenticated_data buffer에 보존한다.
오류 반환과 인증 플래그 설정을 구분한다
파서·방법·NV 갱신·매개변수 추출 실패 시 함수는 오류를 반환한다. 플래그는 전체 성공 경로의 맨 끝 L590에서 설정된다. 추출 도중 앞선 매개변수가 이미 복사됐더라도 이 함수에는 이를 되돌리는 공통 정리 경로가 없으므로 반환값과 플래그를 기준으로 이미지를 사용해야 한다.
DEEP ANALYSIS
CoT 설명자에서 인증 플래그까지
CoT 설명자는 이미지별 parent, 형식, 방법 배열, 자식 검증에 쓸 매개변수를 정의한다. parent 그래프를 따라 이미지를 요청하는 일은 Generic code의 범위다. 현재 함수는 해당 이미지의 파서·인증 방법을 실행한다.
아래 다섯 항목은 항상 같은 순서로 생성되는 중간 상태가 아니라, 이미지 유형과 방법에 따라 필요한 입력·전제다. NV counter는 해당 방법이 있을 때 검사하며, 갱신도 별도 조건을 통과해야 한다.
플랫폼 CoT의 유효한 설명자를 가리킨다.
IO가 적재한 실제 검증 대상이다.
방법에 필요한 공개키·해시 또는 루트 ROTPK다.
현재 이미지에 적용할 방법을 지정한다.
NV 방법이 지정된 경우의 비교·갱신 입력이다.
가운데 점은 단계 화살표가 아니라 함께 확인할 조건을 구분한다. 실제 실행 순서는 아래 목록과 그림 2를 따른다.
설명자와 저장 buffer의 생산자·소비자
| 대상 | 생산·준비 | 소비·유효 범위 |
|---|---|---|
auth_img_desc_t.parent | 플랫폼 CoT 정의 | Generic code가 상위 경로를 찾을 때 사용한다. 현재 함수의 L484–529는 parent를 재귀 순회하지 않는다. |
img_auth_methods[] | 플랫폼 CoT 설명자 | 현재 함수의 방법 순회가 각 슬롯을 읽는다. |
authenticated_data[].data | 플랫폼의 별도 정적 buffer, 인증 이미지가 값을 채움 | 다음 child 검증까지 공개키·해시를 보존한다. |
auth_img_flags[] | 현재 함수의 성공 경로 | 모든 검사·추출 뒤 현재 이미지 ID의 인증 완료를 표시한다. |
함수 내부 실행 순서
01–03은 본문에 인용된 L484–529에서, 04–06은 동일 버전 전체 소스 L535–592에서 확인할 수 있다.
- 01
현재
img_id의 CoT 설명자를 조회한다. - 02
이미지 형식에 맞는 파서 무결성 검사를 하고 오류면 즉시 반환한다.
- 03
img_auth_methods[]가 없으면 1을 반환한다. 있으면 각 슬롯의 방법을 호출하고 실패하면 즉시 반환한다. - 04
need_nv_ctr_upgrade && sig_auth_done일 때만 플랫폼 NV counter를 갱신한다. - 05
authenticated_data가 있으면 파서 추출·크기 검사 뒤 별도 buffer에 복사한다. - 06
IMG_FLAG_AUTHENTICATED를 설정하고 0을 반환한다.
실패 위치별 확인할 값
| 증상 | 코드 경계 | 확인할 값 |
|---|---|---|
| certificate 형식 거부 | img_parser_check_integrity() | img_type, buffer 주소·길이, 반환값 |
| 서명 또는 payload hash 실패 | auth_signature() 또는 auth_hash() | 현재 method, 상위에서 보존된 공개키·해시, 반환값 |
| rollback 거부 또는 갱신 실패 | auth_nvctr() / 조건부 plat_set_nv_ctr2() | certificate 값, 플랫폼 값, 두 갱신 조건 |
| method 통과 뒤 자식 값 추출 실패 | img_parser_get_auth_param() / 크기 검사 | type_desc, 추출 길이, destination 용량 |
OBJECT LIFETIME
객체와 수명
| 대상 | 준비·갱신 시점 | 유효 범위와 소비자 | 확인할 조건 |
|---|---|---|---|
auth_img_desc_t / auth_method_desc_t | 플랫폼 CoT를 정적으로 정의 | 인증 경로에서 parent 조회·현재 이미지 방법 선택에 사용 | img_id, parent, 방법 배열의 대응 |
| 현재 이미지 buffer | BL1/BL2 IO 경로가 적재 | 파서와 방법 검증이 끝날 때까지 필요; 이후 재사용 가능 | 검증 bytes와 길이가 적재한 대상과 일치 |
authenticated_data buffer | 플랫폼이 별도 정적 공간을 제공; 인증 이미지 검증 후 값 복사 | 상위 이미지 적재 메모리를 재사용해도 child 검증까지 유지 | 추출값 길이가 buffer 용량 이하 |
auth_img_flags[img_id] | 모든 검사 뒤 현재 함수가 인증 비트 설정 | 해당 인증 모듈의 이미지 상태 조회에 사용 | 오류 반환 때 이번 호출을 성공으로 취급하지 않음 |
| 플랫폼 NV counter | 해당 NV 방법·갱신 조건에 따라 읽기 또는 갱신 | 플랫폼의 persistent 신뢰 상태 | 비교 정책과 조건부 쓰기 실패를 구분 |
FAILURE PATH
실패 지점과 먼저 볼 코드
| 조건 | 검사 위치 | 함수의 결과 |
|---|---|---|
| parent 누락·CoT 경로 불일치 | Generic code의 parent 탐색·적재 | 현재 함수를 호출하기 전의 경로 문제로 분리한다. |
| certificate 형식 오류 | img_parser_check_integrity() | rc를 바로 반환한다. |
| 서명·해시·NV 방법 실패 | 설명자에 지정된 method 분기 | 해당 rc를 바로 반환한다. |
| 자식용 매개변수 추출·크기 오류 | 방법 순회 뒤 authenticated_data 처리 | 파서 오류 또는 크기 오류로 반환하며 인증 비트 설정에 도달하지 않는다. |
매개변수 추출이 여러 슬롯을 처리하다 실패할 수 있다. 코드에는 이전 슬롯의 복사를 되돌리는 공통 경로가 없으므로 이미지 사용 여부는 최종 반환값과 인증 상태로 결정한다.
EVIDENCE
빌드와 로그에서 확인할 증거
아래 BL2 경로는 Trusted Board Boot를 포함한 빌드의 예다. 플랫폼에 따라 BL1에도 인증 코드가 포함될 수 있으므로 실제 산출물과 CoT 구성을 먼저 확인한다.
| 목적 | 명령 또는 계측 | 판정 기준 |
|---|---|---|
| 빌드 설정 | make PLAT=<platform> DEBUG=1 TRUSTED_BOARD_BOOT=1 all fip | 테스트 키·플랫폼 설정을 준비한 뒤 인증 모듈이 포함된 빌드를 고정한다. |
| FIP 항목 | tools/fiptool/fiptool info build/<platform>/debug/fip.bin | 검증하려는 certificate와 BL 이미지가 의도한 FIP에 있는지 확인한다. |
| BL2 심볼 | ${CROSS_COMPILE}nm -n build/<platform>/debug/bl2/bl2.elf | grep ' auth_mod_verify_img$' | 함수 심볼 이름으로 확인한다. nm 출력에 C 선언의 int는 나오지 않는다. |
| 호출·분기 | ${CROSS_COMPILE}objdump -drS build/<platform>/debug/bl2/bl2.elf | 현재 함수의 파서·방법·counter·flag 경계를 찾는다. BL31의 eret 경로와 혼동하지 않는다. |
| 실행 오류 | BL1/BL2 VERBOSE [TBB] log | 현재 image ID와 실패한 method·반환값을 같은 빌드에서 비교한다. |
LAB
직접 확인할 실험
- 01CoT 설명자와 FIP 항목 대조
플랫폼의
tbbr_cot_bl1.c·tbbr_cot_bl2.cparent 관계를 FIP의 certificate·BL 이미지 목록과 맞춰 본다. 상위 탐색은 호출자 경로에서 관찰한다. - 02certificate와 payload를 각각 변조
certificate는 파서·서명, payload는 해당 이미지 설명자의 hash 방법에서 거부되는지 확인한다. method가 없는 이미지는 이 실험 대상으로 삼지 않는다.
- 03테스트 플랫폼에서 NV counter 경계 확인
NV 방법이 있는 certificate로 비교 실패와 조건부 갱신 실패를 분리해 기록한다. 두 경우 모두 최종 인증 플래그 설정에 도달하지 않는지 확인한다.
CoT 선언과 FCONF 조회는 인증 성공이 아닙니다
CoT device-tree binding은 인증서와 이미지의 부모 관계, 공개키·해시·선택적 rollback counter 참조를 기술합니다. FCONF는 설정의 저장 형식을 조회하는 쪽에서 분리합니다. DT backend의 populate 단계가 C 구조체에 값을 채우고, 소비자는 FCONF_GET_PROPERTY()로 속성을 얻습니다. 그 조회가 성공했다고 payload 서명이나 해시까지 검증된 것은 아닙니다. 설정을 가져오는 절차와 인증 모듈이 실제 바이트를 검사하는 절차를 분리해야 합니다.
2026-10-26 직접 확인한 latest TB_FW binding과 stable binding은 모두 2.15.0으로 표시되지만, 이전 수집 캐시는 2.14.0을 표시했습니다. 두 현재 본문은 node/property의 하위 호환성을 보장하지 않습니다. FIP UUID, secure partition 또는 CoT 필드를 본문의 LTS 2.14.3 구현과 자동으로 동일시하지 말고, 대상 커밋의 parser와 platform 구성을 대조합니다.
고정 소스의 auth_nvctr()는 cert_nv_ctr < plat_nv_ctr이면 거부합니다. 즉 인증서 카운터가 플랫폼의 신뢰된 현재값보다 작아서는 안 됩니다. 더 큰 값의 저장소 반영에는 인증 성공과 FWU 빌드·bank 상태 등의 추가 조건이 있으므로, 비교 성공을 즉시 영구 갱신으로 읽지 않습니다. 이 비교 방향은 LTS 2.14.3 고정 원문을 기준으로 합니다.
키 측정의 오류는 인증 오류와 같은 반환 경로가 아닙니다
자식용 공개키를 복사한 뒤 plat_mboot_measure_key()가 실패하면 이 고정 함수는 로그를 남기지만 즉시 반환하지 않습니다. 나머지 매개변수를 처리한 뒤 인증 비트를 설정하고 0을 반환할 수 있습니다. 반면 파서·인증 방법·NV 갱신·크기 검사의 오류는 인증 성공 전에 반환합니다. 측정 부트 기록과 서명·해시 인증을 같은 완료 상태로 합치지 않습니다.
PRIMARY REFERENCES