---
title: 속성 카탈로그
description: Human Plugin이 credential.type에서 허용하는 문서 유형의 공개 카탈로그입니다. 형식, Human Plugin이 카탈로그를 불러오는 방식, 불러오지 못할 때 시작이 실패하는 이유를 설명합니다.
canonical: https://developer.unico.io/ko/human-plugin/additional-resources/attribute-catalog
locale: ko
generated_by: markdown-export
---

# 속성 카탈로그

credential.type에서 허용되는 문서 유형 목록입니다.

카탈로그는 Unico가 `https://human-token-assets.unico.app/attribute-catalog.json`에 게시하는 공개 JSON 파일입니다. 사용할 수 있는 코드는 이 파일에서 확인하세요.

```json
{
  "schema_version": 1,
  "version": "2026-10-29.1",
  "attributes": [
    { "code": "DUI_TYPE_BR_CPF", "country_code": "BRA" },
    { "code": "DUI_TYPE_NG_BVN", "country_code": "NGA" }
  ]
}
```

- `code`는 `credential.type`에 보내는 값입니다. 일치 여부는 **정확히, 대소문자를 구분하여** 판단합니다.
- `country_code`는 해당 문서를 발급하는 국가의 ISO 3166-1 alpha-3 코드입니다. Human Plugin은 이 값을 `data.ndocs`의 `countryCode`로 응답합니다.

## Human Plugin의 카탈로그 사용 방식

- **시작할 때 한 번** 다운로드하여 메모리에 보관합니다. 새 카탈로그는 Human Plugin을 다음에 재시작할 때 반영됩니다.
- 10초 안에 유효한 카탈로그를 다운로드하지 못하면 Human Plugin은 **시작되지 않습니다**. `human-token-assets.unico.app`으로 나가는 HTTPS 아웃바운드를 허용하세요.
- 카탈로그 호스트에는 고객 데이터가 전송되지 않습니다.
- 카탈로그에 없는 `credential.type`으로 생성을 요청하면, 아무것도 저장하거나 전송하기 전에 `422 ATTRIBUTE_TYPE_NOT_SUPPORTED`로 거부됩니다.