> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Certificate Library Item 구성

> Iru Endpoint에서 Certificate Library Item을 설정하여 안전한 인증을 위해 Apple 기기 및 Windows 컴퓨터에 신뢰할 수 있는 인증서를 배포합니다.

<Callout icon="list-check" color="#B84A7A" iconType="regular">이 Library Item은 Apple 기기 및 Windows 컴퓨터에서 사용할 수 있습니다</Callout>

**Certificate Library Item**을 사용하여 인증서를 업로드하고 Apple 기기 및 Windows 컴퓨터에 배포할 수 있습니다. 이는 유효한 인증서 신뢰 체인이 필요한 서비스나 인증서 기반 인증을 지원하는 앱을 구성할 때 유용합니다.

조직에서 Microsoft Active Directory Certificate Services(AD CS)를 사용하는 경우 테넌트 측 [AD CS 통합: 개요](/ko/endpoint/integrations/certificate-services/active-directory-certificate-services/active-directory-certificate-services-ad-cs-integration-overview) 및 [AD CS 통합: 통합 구성](/ko/endpoint/integrations/certificate-services/active-directory-certificate-services/active-directory-certificate-services-ad-cs-integration-configure-the-integration)을 완료하여 발급 CA를 Iru Endpoint에서 사용할 수 있도록 하십시오. 이 Library Item을 사용하여 업로드한 파일에서 루트 및 중간 신뢰 체인을 배포합니다. Mac 컴퓨터, iPhone, iPad, Apple TV 기기 및 Apple Vision Pro용 인증서를 AD CS**에서** 요청하려면 **Apple** 탭에서 **AD CS certificate** 유형을 추가하고, 테넌트에 해당 유형이 표시되는 경우 아래 [**AD CS 인증서**](#ad-cs-certificates)를 따르십시오.

#### 인증서 프로파일 생성

이 Library Item을 Iru Endpoint Library에 추가하려면 [Library 개요](/ko/endpoint/library/library-items-profiles/library-overview) 문서에 설명된 단계를 따르십시오.

<Steps>
  <Step title="Library Item 이름 지정">
    Library Item에 설명이 포함된 **제목**을 지정합니다.
  </Step>

  <Step title="Blueprint에 할당">
    Certificate Library Item을 [Blueprint](/ko/endpoint/getting-started/blueprints-and-library/configuring-blueprints)에 할당합니다.
  </Step>
</Steps>

<Tabs>
  <Tab title="Apple">
    ### Apple 인증서 구성

    배포하려는 인증서 유형을 선택합니다. 지원되는 유형은 다음과 같습니다.

    * **PKCS #1 형식 인증서**(`.cer`, `.crt`, `.der`)
      * 해당 개인 키 없이 인증서만 포함합니다.
    * **PKCS #12 형식 인증서**(`.p12`, `.pfx`)
      * 인증서와 해당 개인 키를 모두 포함합니다.

    #### PKCS #1 형식 인증서

    PKCS #1 형식 인증서를 배포하려면 아래 단계를 따르십시오.

    <Steps>
      <Step title="인증서 유형 선택">
        **Certificate type** 드롭다운에서 **PKCS #1-formatted certificate**를 선택합니다.
      </Step>

      <Step title="인증서 파일 업로드">
        **인증서**에서 `.cer`, `.crt` 또는 `.der` 파일을 업로드합니다. 파일을 업로드 상자로 드래그할 수도 있습니다.
      </Step>

      <Step title="인증서 이름 입력">
        **Certificate name**을 입력합니다. 이는 macOS의 시스템 설정에 표시되는 인증서의 표시 이름입니다.
      </Step>

      <Step title="구성 저장">
        **저장**을 선택하여 구성을 완료합니다.
      </Step>
    </Steps>

    <Note>
      PKCS #1 인증서는 인증서 자체만 포함하며 개인 키는 포함하지 않습니다. 워크플로에 인증서와 개인 키가 모두 필요한 경우 대신 PKCS #12 형식 인증서를 사용하십시오.
    </Note>

    #### PKCS #12 형식 인증서

    **PKCS #12-formatted certificate**를 선택한 경우 다음 단계에 따라 환경에 맞게 구성합니다.

    <Steps>
      <Step title="인증서 암호 입력">
        **Certificate password -** 이 옵션은 **PKCS #12-formatted certificate type**을 선택하면 나타납니다. 인증서 ID를 해독하는 데 사용되는 암호를 입력합니다.
      </Step>

      <Step title="인증서 파일 업로드">
        **Certificate -** 선택하여 인증서 또는 인증서 ID 파일을 업로드합니다. Certificate 상자로 드래그할 수도 있습니다.
      </Step>

      <Step title="인증서 이름 입력">
        **Certificate name -** 구성 프로파일에 표시될 인증서 이름을 지정합니다.
      </Step>

      <Step title="개인 키에 대한 앱 접근 구성">
        **Allow apps to access the private key -** 이 옵션은 **PKCS #12-formatted certificate** 유형을 선택하면 나타납니다. 이 옵션을 선택하면 모든 앱이 자동으로 인증서 ID를 사용할 수 있습니다. 이는 인증서 기반 인증이 필요한 앱이나 서비스를 설정할 때 유용합니다.

        <Note>
          이 옵션을 선택 해제하면 관리자 권한이 있는 사용자가 키체인 앱을 사용하여 인증서 ID 사용을 허용해야 합니다.
        </Note>
      </Step>

      <Step title="키체인 보호 구성">
        **Prevent the private key data from being extracted from the keychain -** 이 옵션은 **PKCS #12-formatted certificate** 유형을 선택하면 나타납니다. 이 옵션은 개인 키가 macOS 키체인에서 내보내지는 것을 방지하고 ID가 배포된 Mac에 유지되도록 합니다.
      </Step>

      <Step title="구성 저장">
        완료되면 **저장**을 선택합니다.
      </Step>
    </Steps>

    #### AD CS 인증서

    테넌트에서 AD CS 인증서 유형을 사용할 수 있는 경우 아래 단계를 사용하여 Mac 컴퓨터, iPhone, iPad, Apple TV 기기 및 Apple Vision Pro에 대해 Active Directory Certificate Services의 인증서 요청을 구성합니다.

    <Note>
      AD CS 인증서를 배포하려면 [AD CS 통합](/ko/endpoint/integrations/certificate-services/active-directory-certificate-services/active-directory-certificate-services-ad-cs-integration-overview)이 이미 설정 및 구성되어 있어야 합니다.
    </Note>

    <Steps>
      <Step title="인증서 이름 입력">
        **Certificate name**을 입력합니다. 이는 시스템 설정의 구성 프로파일에 표시됩니다.
      </Step>

      <Step title="인증서 주체 입력">
        인증 기관 내에서 기기를 식별하는 데 사용되는 **Certificate subject**를 입력합니다. 정적 값 또는 `$SERIAL_NUMBER`와 같은 전역 변수를 사용할 수 있습니다.
      </Step>

      <Step title="주체 대체 이름 추가">
        인증서 요청에 필요한 \*\*Subject Alternative Names (SANs)\*\*를 추가합니다.
      </Step>

      <Step title="필요한 경우 강력한 매핑 URI 추가">
        Windows 업데이트 [KB5014754](https://support.microsoft.com/topic/kb5014754-certificate-based-authentication-changes-on-windows-domain-controllers-ad2c23b0-15d8-4340-a468-4d4f3b188f16)의 강력한 인증서 매핑 요구 사항을 지원하려면 다음 URI SAN 값을 추가합니다: `$ADCS_STRONG_MAPPING_ID`.
      </Step>

      <Step title="템플릿 및 AD CS 서버 설정">
        AD CS 인증서를 생성하는 데 사용되는 AD CS 컴퓨터 인증서 템플릿의 **Template name**을 입력한 다음 드롭다운에서 **AD CS server**를 선택합니다. AD CS 서버는 [AD CS 통합 구성](/ko/endpoint/integrations/certificate-services/active-directory-certificate-services/active-directory-certificate-services-ad-cs-integration-configure-the-integration) 중에 추가됩니다.
      </Step>

      <Step title="키 및 개인 키 옵션 선택">
        **Key size**를 선택합니다. 선택적으로 **Allow apps to access the private key** 및 **Prevent the private key data from being extracted from the keychain**을 선택합니다.
      </Step>

      <Step title="구성 저장">
        **저장**을 선택합니다.
      </Step>
    </Steps>

    #### 문제 해결

    ##### 신뢰할 수 없음으로 표시된 인증서

    기기 인증서를 배포할 때 전체 인증서 신뢰 체인을 포함하십시오.

    * **기기 인증서**
    * 모든 **중간 인증서**
    * **루트 인증서**

    인증서 신뢰 체인은 계층적으로 작동하며, 신뢰할 수 있는 루트 인증서에서 시작하여 중간 인증서를 거쳐 기기 인증서로 끝납니다. 각 인증서는 다음 인증서를 보증하여 신뢰할 수 있는 출처로 돌아가는 검증 가능한 경로를 만듭니다.

    체인의 일부가 누락되면 기기가 인증서를 신뢰할 수 없음으로 표시할 수 있습니다. 이로 인해 연결 문제나 경고가 발생할 수 있습니다. 전체 체인을 업로드하고 배포하십시오.
  </Tab>

  <Tab title="Windows">
    ### Windows 인증서 구성

    배포하려는 인증서 유형을 선택합니다. 지원되는 유형은 다음과 같습니다.

    * **PKCS #1 형식 인증서**(`.cer`, `.crt`, `.der`)
      * 해당 개인 키 없이 인증서만 포함합니다.
    * **PKCS #12 형식 인증서**(`.p12`, `.pfx`)
      * 인증서와 해당 개인 키를 모두 포함합니다.

    #### PKCS #1 형식 인증서

    PKCS #1 형식 인증서를 배포하려면 아래 단계를 따르십시오.

    <Steps>
      <Step title="인증서 유형 선택">
        **Certificate type** 드롭다운에서 **PKCS #1-formatted certificate**를 선택합니다.
      </Step>

      <Step title="인증서 파일 업로드">
        **인증서**에서 `.cer`, `.crt` 또는 `.der` 파일을 업로드합니다. 파일을 업로드 상자로 드래그할 수도 있습니다.
      </Step>

      <Step title="인증서 저장소 선택">
        **Certificate store**에서 인증서가 설치될 위치를 선택합니다.
      </Step>

      <Step title="구성 저장">
        **저장**을 선택하여 구성을 완료합니다.
      </Step>
    </Steps>

    <Note>
      PKCS #1 인증서는 인증서 자체만 포함하며 개인 키는 포함하지 않습니다. 워크플로에 인증서와 개인 키가 모두 필요한 경우 대신 PKCS #12 형식 인증서를 사용하십시오.
    </Note>

    #### PKCS #12 형식 인증서

    **PKCS #12-formatted certificate**를 선택한 경우 다음 단계에 따라 환경에 맞게 구성합니다.

    <Steps>
      <Step title="인증서 암호 입력">
        **Certificate password -** 이 옵션은 **PKCS #12-formatted certificate type**을 선택하면 나타납니다. 인증서 ID를 해독하는 데 사용되는 암호를 입력합니다.
      </Step>

      <Step title="인증서 파일 업로드">
        **Certificate -** 선택하여 인증서 또는 인증서 ID 파일을 업로드합니다. Certificate 상자로 드래그할 수도 있습니다.
      </Step>

      <Step title="키 위치 구성">
        **Key location**: Windows에서 인증서 키가 저장될 위치를 선택합니다.
      </Step>

      <Step title="개인 키 내보내기 옵션 설정">
        **Allow private key to be exported**: 배포 후 Windows에서 개인 키를 내보낼 수 있는지 여부를 선택합니다.
      </Step>

      <Step title="구성 저장">
        완료되면 **저장**을 선택합니다.
      </Step>
    </Steps>

    #### 문제 해결

    ##### 신뢰할 수 없음으로 표시된 인증서

    기기 인증서를 배포할 때 전체 인증서 신뢰 체인을 포함하십시오.

    * **기기 인증서**
    * 모든 **중간 인증서**
    * **루트 인증서**

    인증서 신뢰 체인은 계층적으로 작동하며, 신뢰할 수 있는 루트 인증서에서 시작하여 중간 인증서를 거쳐 기기 인증서로 끝납니다. 각 인증서는 다음 인증서를 보증하여 신뢰할 수 있는 출처로 돌아가는 검증 가능한 경로를 만듭니다.

    체인의 일부가 누락되면 기기가 인증서를 신뢰할 수 없음으로 표시할 수 있습니다. 이로 인해 연결 문제나 경고가 발생할 수 있습니다. 전체 체인을 업로드하고 배포하십시오.
  </Tab>
</Tabs>