Version: Unity 6.0 (6000.0)
언어 : 한국어
Configuration files
커스텀 패키지 생성

네트워크 문제 해결

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

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

방화벽 설정

Unity 패키지 관리자가 사용하는 도메인에 액세스할 수 있게 하려면 해당 도메인을 방화벽의 허용 목록에 추가해야 합니다.

이러한 도메인과 Unity 에디터에 필요한 모든 도메인의 전체 목록은 Unity 애플리케이션이 액세스하는 엔드포인트를 참고하십시오. 해당 목록을 사용하여 전체 도메인을 추가하거나 표를 사용하여 하위 도메인을 선택적으로 추가할 수 있습니다.

방화벽의 허용 목록에 도메인 이름을 추가하는 방법은 운영체제의 도움말을 참조하십시오.

프록시 서버 설정

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

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

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

커스텀 인증서 권한

일부 조직에서는 사용자가 프록시 서버를 통해서만 인터넷에 액세스할 수 있습니다. 일부 프록시는 HTTPS 콘텐츠의 언패킹한 후 자체 SSL 인증서를 사용하여 다시 패킹합니다. Unity 패키지 관리자의 기본 HTTPS 레이어는 이러한 인증서를 발급한 인증서 권한을 인식하지 못하므로 이러한 인증서를 때때로 거부할 수 있습니다. 이 경우 패키지 관리자는 해당 연결을 MITM(Machine In The Middle) 공격으로 취급합니다. 즉, 이러한 인증서를 허용하기 위해 추가 SSL 인증서 권한을 설정하지 않는 한 Unity에서 패키지 관리자를 포함한 많은 기능을 사용할 수 없습니다.

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

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

  2. 커스텀 인증서 권한에 대한 하나 이상의 인증서로 텍스트 파일을 생성합니다. 파일은 PEM(Privacy-Enhanced Mail) 포맷으로 된 하나 이상의 신뢰할 수 있는 인증서로 구성되어야 합니다. 예시:

    -----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"
    

추가 리소스

Configuration files
커스텀 패키지 생성