인증 자격 증명 시맨틱

이 문서는 다음 모듈에서 공통으로 사용하는 자격 증명 적격성 판단 및 해석 규칙을 정의합니다.

• resolveAuthProfileOrder
• resolveApiKeyForProfile
• models status --probe
• doctor-auth

선택 시점과 런타임의 동작을 일관되게 유지하는 것이 목표입니다.

안정 사유 코드

• ok
• missing_credential
• invalid_expires
• expired
• unresolved_ref

토큰 자격 증명

토큰 자격 증명(type: "token")은 인라인 token과 tokenRef를 지원합니다.

적격성 규칙

1. token과 tokenRef가 모두 없으면 해당 프로필은 부적격입니다.
2. expires는 선택 항목입니다.
3. expires가 있으면 0보다 큰 유한한 숫자여야 합니다.
4. expires가 유효하지 않은 경우(NaN, 0, 음수, 비유한값, 잘못된 타입) 해당 프로필은 invalid_expires로 부적격 처리됩니다.
5. expires가 과거 시점이면 해당 프로필은 expired로 부적격 처리됩니다.
6. tokenRef가 있더라도 expires 유효성 검사를 건너뛸 수 없습니다.

해석 규칙

1. 해석기는 expires에 대해 적격성 규칙과 동일한 기준을 적용합니다.
2. 적격 프로필의 토큰은 인라인 값 또는 tokenRef에서 가져올 수 있습니다.
3. 참조를 해석할 수 없으면 models status --probe 출력에 unresolved_ref가 표시됩니다.

레거시 호환 메시지

스크립트 호환성을 위해 프로브 오류의 첫 번째 줄은 변경하지 않습니다.

Auth profile credentials are missing or expired.

사람이 읽기 좋은 상세 내용과 안정 사유 코드는 이후 줄에 추가할 수 있습니다.