Version: 2023.1
언어: 한국어
설정
범위 지정 레지스트리 인증

네트워크 문제 해결

이 절차를 사용하여 다음을 수행할 수 있습니다.

  • Unity가 패키지 관리자 레지스트리 서버에 액세스할 수 있도록 방화벽을 설정합니다.
  • 환경 변수를 설정하거나 커스텀 CA(인증서 권한) 인증을 추가하여 프록시 서버를 설정합니다.

방화벽 설정

방화벽의 허용 도메인 리스트에 다음을 추가합니다.

  • packages.unity.com
  • download.packages.unity.com
  • upm-cdn.unity.com (또는 중국 내 위치의 경우 upm-cdn-china.unitychina.cn)

이렇게 하면 Unity 패키지 관리자가 HTTPS를 사용하여 이러한 도메인 이름에 액세스할 수 있습니다.

: 방화벽의 세이프 리스트에 도메인 이름을 추가하는 방법은 운영체제의 도움말을 참조하십시오.

프록시 서버 설정

프록시 서버를 사용하는 경우에는 Unity 패키지 관리자에 대해 HTTP_PROXYHTTPS_PROXY 환경 변수를 설정하여 Unity 패키지 레지스트리에 대한 요청을 수행할 때 사용할 수 있습니다. 자세한 내용은 환경 변수를 사용하여 프록시 서버 식별을 참조하십시오.

운영체제에 따라 이러한 변수를 전역으로(시스템 또는 사용자 변수) 설정할 수 있습니다. 또는 커맨드 파일을 생성하여 환경 변수를 설정하고 Hub를 실행할 수도 있습니다.

패키지 관리자가 인식하지 못하는 인증서를 사용하는 프록시 서버 환경의 경우 커스텀 인증서 권한을 설정할 수 있습니다.

커스텀 인증서 권한

일부 조직에서는 사용자가 프록시 서버를 통해서만 인터넷에 액세스할 수 있습니다. 일부 프록시는 HTTPS 콘텐츠를 언패킹하고 자체 SSL 인증서로 리패킹합니다. Unity 패키지 관리자의 기본 HTTPS 레이어는 인증서를 발행한 인증서 권한을 인식하지 못하여 이러한 인증서를 거부하는 경우가 있습니다. 이 경우 패키지 관리자는 해당 연결을 MITM(machine-in-the-middle) 공격으로 처리합니다. 따라서 이러한 인증서를 허용하도록 추가 SSL 인증서 권한을 설정하지 않으면 패키지 관리자를 비롯한 Unity의 많은 기능을 사용할 수 없습니다.

추가 SSL 인증서 권한을 설정하려면 다음을 수행하십시오.

  1. upmconfig.toml 전역 설정 파일을 찾습니다. 파일이 없는 경우 빈 텍스트 파일을 생성합니다.

  2. 하나 이상의 커스텀 인증서 권한이 포함된 텍스트 파일을 생성합니다. 파일은 프라버시 강화 메일(PEM) 형식인 하나 이상의 신뢰할 수 있는 인증서로 구성되어야 합니다. 예시:

    -----BEGIN CERTIFICATE-----
    MIIC+zCCAeOgAwIBAgIJAO0U6hVJnbvjMA0GCSqGSIb3DQEBBQUAMBQxEjAQBgNV
    BAMMCWxvY2FsaG9zdDAeFw0xOTAzMTIwMTIxMzRaFw0yOTAzMDkwMTIxMzRaMBQx
    (additional lines omitted for conciseness)
    LFwHSUdqk0lJK4b0mCwyTHNvYO1IDziE5EKwfuaKVgOa62iCHVahgIVa+een4EfS
    hCCr3M3cq11Mi+mnRi1scxxrOno4OEEChWg2szZLlxBrkVJllrrq620XJ6RLB/8=
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
    MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl
    MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
    (additional lines omitted for conciseness)
    H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe
    +o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g==
    -----END CERTIFICATE-----
    
  3. 이 파일을 가능한 경우 전역 설정 파일과 동일한 폴더에 저장합니다. 단, Unity는 파일 시스템의 모든 위치를 지원합니다.

  4. 전역 설정 파일에서 caFile 키를 추가하고 해당 값을 PEM 파일의 절대 파일 경로로 설정합니다.중요:TOML 파일에서 Windows 경로를 설정할 때는 슬래시(/) 또는 더블 슬래시(\\)를 사용하십시오.백슬래시(\)는 이스케이프 시퀀스를 표시하는 특수 문자이므로 TOML 구문 분석 오류를 발생시킬 수 있는 백슬래시를 사용하지 마십시오.

    Windows 예시

    caFile = "C:\\ProgramData\\Unity\\config\\cert.pem"
    

    macOS 및 Linux 예시

    caFile = "/etc/cert.pem"
    

추가 리소스

설정
범위 지정 레지스트리 인증