Trusted Firmware-A · source analysis

Chain of Trust와 auth_mod_verify_img

상위 이미지를 따라 준비하는 CoT 경로와 현재 이미지를 검증하는 auth_mod_verify_img() 내부 경계를 나누어 읽습니다.

표의 버전은 소스 분석 기준이며 최신 보안 버전 권고가 아닙니다. TF-A LTS 2.14.3 이후에는 보안 수정이 있습니다. 제품 적용 시 공식 변경 기록과 사용 플랫폼의 errata를 확인하세요.

Series
05 / 12
Baseline
LTS 2.14.3
Commit
f5e765a3443f
Source
drivers/auth/auth_mod.c:468-593 (발췌 범위)

Chain of Trust와 auth_mod_verify_img 단계에서 실제로 바뀌는 상태는 무엇인가?

상위 이미지 탐색과 적재·인증은 Generic code와 IO framework가 CoT를 따라 진행한다. auth_mod_verify_img()는 전달받은 현재 이미지의 설명자를 조회하고, 그 설명자에 지정된 검사만 수행한다.

상위 인증 이미지에서 보존한 공개키·해시 또는 플랫폼의 ROTPK가 현재 이미지 검증의 입력이 된다. 이 함수가 parent를 재귀적으로 다시 적재하거나 인증하는 것으로 읽으면 호출 경계가 뒤바뀐다.

상위 신뢰 상태와 현재 이미지 검증의 경계

그림 1. CoT 상위 경로와 auth_mod_verify_img()의 현재 이미지 검사 (원본 코드 L484–529)
함수 밖 · Generic code / IO

상위 이미지부터 적재·인증

Generic code가 CoT의 parent를 따라 올라갔다가 신뢰 뿌리부터 이미지를 순서대로 적재·인증한다. 현재 이미지 검증에 필요한 인증 매개변수는 앞서 인증한 이미지에서 보존되며, 루트 서명은 플랫폼 ROTPK를 사용한다.

상위 이미지의 authenticated data: 공개키 또는 해시루트 인증의 입력: 플랫폼 ROTPK
함수 안 · 현재 이미지 한 개

auth_mod_verify_img(img_id, img_ptr, img_len)

  1. L468–470현재 이미지 입력img_id · img_ptr · img_len
  2. L484CoT 설명자 조회FCONF_GET_PROPERTY(tbbr, cot, img_id)
  3. L486–492파서 무결성 검사img_parser_check_integrity(...)
  4. 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 고정 코드에 대응한다.

현재 이미지 한 개를 검증하는 실행 흐름

그림 2. auth_mod_verify_img()의 주요 분기 (TF-A LTS 2.14.3)
현재 이미지 ID·buffer·길이
CoT 설명자 조회
파서 무결성 검사
설명자에 지정된 방법 순회
조건부 NV 갱신·자식용 매개변수 추출
인증 플래그 설정·0 반환

상위 인증서 탐색·적재는 이 함수 밖에서 끝난다. 이 함수는 파서·방법·갱신·추출 실패 시 즉시 오류를 반환하며, NV 갱신과 매개변수 추출은 조건이 맞을 때만 수행한다. 인용 코드 L532는 주석 중간에서 끝나므로 마지막 두 칸은 동일 버전의 전체 함수로 확인했다.

단계별 입력과 출력

그림 2의 여섯 단계를 실제 읽는 값과 반환 경계로 풀었다. 상위 CoT 적재는 앞선 호출자의 일이며, 아래 표는 현재 이미지 한 개의 함수 내부만 다룬다.

#함수 안 단계읽는 값통과 시 상태실패·조건
01CoT 설명자 조회img_idimg_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 뒤에 있으므로 동일 버전 전체 소스를 함께 보아야 한다.

CoT의 상위 관계와 현재 함수의 순서를 구분하기

상위 인증 이미지는 다음 이미지에 필요한 공개키·해시를 남긴다. 이 관계는 앞의 그림 2에 표시한 현재 이미지 한 개의 함수 호출 순서와 범위가 다르다.

그림 3. CoT 상위 이미지의 결과가 현재 이미지 검증의 입력이 되는 관계

전체 CoT에서 신뢰가 전달되는 방향이다. 한 번의 auth_mod_verify_img() 호출을 네 번으로 나눈 그림이 아니다.

01 · 신뢰 뿌리플랫폼 ROTPK
02 · 상위 이미지인증된 certificate
03 · 보존된 값공개키 또는 해시
04 · 현재 이미지설명자에 지정된 방법으로 검증
그림 4. 인증 이미지에서 다음 이미지로 전달되는 값의 예

TBBR의 certificate와 BL 이미지에서 어떤 값이 다음 검증에 쓰이는지를 단순화한 관계다.

01플랫폼 ROTPK루트 certificate 서명 확인인증된 공개키
02인증된 key certificate다음 공개키다음 certificate
03인증된 content certificate보존된 해시대상 BL 이미지
04NV 방법을 지정한 certificaterollback 비교조건부 counter 갱신

원본 코드

원문 Trusted Firmware-A LTS 2.14.3 · drivers/auth/auth_mod.c의 468–593행입니다.

commitf5e765a3443fe21154aa908228e75ee2600085f6anchor · L468int auth_mod_verify_img(unsigned int img_id
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, &param_ptr, &param_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}

발췌 범위와 읽기 기준

원문 468–593행은 auth_mod_verify_img() 전체를 담습니다. 현재 이미지 검사에서 조건부 NV counter 갱신, 자식용 인증 매개변수 추출, 인증 플래그 설정까지 이어지는 경로를 확인할 수 있습니다.

조건부 counter 갱신, 자식용 매개변수 추출, 인증 플래그 설정은 같은 LTS 2.14.3 파일의 L535–592에서 확인한다. 상위 이미지의 탐색·적재는 이 함수가 아닌 Generic code/IO의 책임이다.

함께 읽어야 하는 원본 코드

첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.

01. certificate signature와 public key를 검증

drivers/auth/auth_mod.c 146-260줄이다.

filedrivers/auth/auth_mod.canchor · L156static int auth_signature
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줄이다.

filedrivers/auth/auth_mod.canchor · L323static int auth_nvctr
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/*

코드에서 상태가 바뀌는 지점

01

호출 전에 상위 경로를 준비한다

BL1/BL2의 Generic code는 CoT의 parent를 따라 필요한 인증 이미지를 적재·검증한다. auth_mod_verify_img()는 전달된 img_id, img_ptr, img_len으로 현재 이미지 한 개를 검사한다.

02

설명자를 조회하고 형식을 검사한다

L484에서 CoT 설명자를 조회하고, L487에서 설명자의 img_type에 맞춰 파서 무결성 검사를 한다. 이 함수가 설명자를 동적 할당하거나 list에 등록하는 코드는 보이지 않는다.

03

지정된 방법만 실행한다

img_auth_methods 배열이 없으면 1을 반환한다. 배열의 각 슬롯에서 HASH, SIG, NV_CTR 또는 NONE을 분기하며, 각 검사 실패 시 즉시 반환한다.

04

NV counter 갱신 조건을 따로 본다

방법 순회가 끝나도 무조건 persistent counter를 쓰지 않는다. 전체 함수 L535–543에서는 need_nv_ctr_upgrade && sig_auth_done일 때만 plat_set_nv_ctr2()를 호출한다.

05

다음 이미지의 값과 현재 이미지의 승인 상태를 남긴다

설명자에 authenticated_data가 있으면 파서가 값을 추출하고 크기를 검사한 뒤 보존 buffer로 복사한다. 그 뒤 auth_img_flags[img_id]에 IMG_FLAG_AUTHENTICATED를 설정하고 0을 반환한다. 다음 이미지 적재와 handoff는 호출자의 별도 경로다.

소유권과 실패 경계를 더 깊게 읽기

01

parent 탐색과 현재 이미지 검증의 소유자가 다르다

공식 인증 프레임워크 문서는 Generic code가 parent를 재귀적으로 묻고 IO로 적재한 뒤 신뢰 뿌리에서 현재 이미지로 내려오며 인증한다고 설명한다. 이 함수 안에서는 이미 전달받은 현재 이미지의 설명자와 method만 순회한다.

02

설명자와 매개변수 buffer는 이미지 buffer와 수명이 다르다

auth_img_desc_t와 method 설명자는 플랫폼이 구성한 CoT의 일부다. parent 이미지 적재 메모리는 child에 재사용될 수 있어, child가 쓸 공개키·해시는 플랫폼이 별도로 정적으로 할당한 authenticated_data buffer에 보존한다.

03

오류 반환과 인증 플래그 설정을 구분한다

파서·방법·NV 갱신·매개변수 추출 실패 시 함수는 오류를 반환한다. 플래그는 전체 성공 경로의 맨 끝 L590에서 설정된다. 추출 도중 앞선 매개변수가 이미 복사됐더라도 이 함수에는 이를 되돌리는 공통 정리 경로가 없으므로 반환값과 플래그를 기준으로 이미지를 사용해야 한다.

CoT 설명자에서 인증 플래그까지

CoT 설명자는 이미지별 parent, 형식, 방법 배열, 자식 검증에 쓸 매개변수를 정의한다. parent 그래프를 따라 이미지를 요청하는 일은 Generic code의 범위다. 현재 함수는 해당 이미지의 파서·인증 방법을 실행한다.

아래 다섯 항목은 항상 같은 순서로 생성되는 중간 상태가 아니라, 이미지 유형과 방법에 따라 필요한 입력·전제다. NV counter는 해당 방법이 있을 때 검사하며, 갱신도 별도 조건을 통과해야 한다.

그림 5. 현재 이미지 검증에 쓰이는 입력과 조건
IDimage ID

플랫폼 CoT의 유효한 설명자를 가리킨다.

BYTES이미지 bytes·length

IO가 적재한 실제 검증 대상이다.

PARENT상위 인증 값

방법에 필요한 공개키·해시 또는 루트 ROTPK다.

METHOD방법 배열

현재 이미지에 적용할 방법을 지정한다.

NVNV backend

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에서 확인할 수 있다.

  1. 01

    현재 img_id의 CoT 설명자를 조회한다.

  2. 02

    이미지 형식에 맞는 파서 무결성 검사를 하고 오류면 즉시 반환한다.

  3. 03

    img_auth_methods[]가 없으면 1을 반환한다. 있으면 각 슬롯의 방법을 호출하고 실패하면 즉시 반환한다.

  4. 04

    need_nv_ctr_upgrade && sig_auth_done일 때만 플랫폼 NV counter를 갱신한다.

  5. 05

    authenticated_data가 있으면 파서 추출·크기 검사 뒤 별도 buffer에 복사한다.

  6. 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 용량

객체와 수명

대상준비·갱신 시점유효 범위와 소비자확인할 조건
auth_img_desc_t / auth_method_desc_t플랫폼 CoT를 정적으로 정의인증 경로에서 parent 조회·현재 이미지 방법 선택에 사용img_id, parent, 방법 배열의 대응
현재 이미지 bufferBL1/BL2 IO 경로가 적재파서와 방법 검증이 끝날 때까지 필요; 이후 재사용 가능검증 bytes와 길이가 적재한 대상과 일치
authenticated_data buffer플랫폼이 별도 정적 공간을 제공; 인증 이미지 검증 후 값 복사상위 이미지 적재 메모리를 재사용해도 child 검증까지 유지추출값 길이가 buffer 용량 이하
auth_img_flags[img_id]모든 검사 뒤 현재 함수가 인증 비트 설정해당 인증 모듈의 이미지 상태 조회에 사용오류 반환 때 이번 호출을 성공으로 취급하지 않음
플랫폼 NV counter해당 NV 방법·갱신 조건에 따라 읽기 또는 갱신플랫폼의 persistent 신뢰 상태비교 정책과 조건부 쓰기 실패를 구분

실패 지점과 먼저 볼 코드

조건검사 위치함수의 결과
parent 누락·CoT 경로 불일치Generic code의 parent 탐색·적재현재 함수를 호출하기 전의 경로 문제로 분리한다.
certificate 형식 오류img_parser_check_integrity()rc를 바로 반환한다.
서명·해시·NV 방법 실패설명자에 지정된 method 분기해당 rc를 바로 반환한다.
자식용 매개변수 추출·크기 오류방법 순회 뒤 authenticated_data 처리파서 오류 또는 크기 오류로 반환하며 인증 비트 설정에 도달하지 않는다.

매개변수 추출이 여러 슬롯을 처리하다 실패할 수 있다. 코드에는 이전 슬롯의 복사를 되돌리는 공통 경로가 없으므로 이미지 사용 여부는 최종 반환값과 인증 상태로 결정한다.

빌드와 로그에서 확인할 증거

아래 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·반환값을 같은 빌드에서 비교한다.

직접 확인할 실험

  1. 01
    CoT 설명자와 FIP 항목 대조

    플랫폼의 tbbr_cot_bl1.c·tbbr_cot_bl2.c parent 관계를 FIP의 certificate·BL 이미지 목록과 맞춰 본다. 상위 탐색은 호출자 경로에서 관찰한다.

  2. 02
    certificate와 payload를 각각 변조

    certificate는 파서·서명, payload는 해당 이미지 설명자의 hash 방법에서 거부되는지 확인한다. method가 없는 이미지는 이 실험 대상으로 삼지 않는다.

  3. 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 갱신·크기 검사의 오류는 인증 성공 전에 반환합니다. 측정 부트 기록과 서명·해시 인증을 같은 완료 상태로 합치지 않습니다.

원문과 다음 글