From 783366e4db5d8f8ce8227e5a6dea0770032b2246 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:20 +0000 Subject: [PATCH] File src/content/docs/en/sdk/unity/v5/integrations/signature-library.mdx was translated to ko-KR locale --- .../v5/integrations/signature-library.mdx | 126 +++++++++--------- 1 file changed, 61 insertions(+), 65 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx index 7f89a8ba5..22267e992 100644 --- a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: SDK Signature(SDK 서명) 라이브러리 연동 -description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다. -slug: ko/sdk/unity/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/unity/v4/integrations/signature-library +title: "SDK Signature(SDK 서명) 라이브러리 연동" +description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다." +slug: "en/sdk/unity/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/integrations/signature-library" --- - Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## 시작에 앞서 {#before-you-begin} +시작에 앞서 \{\#before\-you\-begin\} +------------------------------------ - + SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. - - + 서명 라이브러리를 Unity 앱에 연동하려면 다음을 확인하시기 바랍니다. -- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -- 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. -- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. +* 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +* 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +* Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. + - - -### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} +### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 {#updating-the-signature-library} +### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)해야 합니다. -- 더 이상 설치 리포트에 필요하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +* 더 이상 설치 리포트에 필요하지 않는 경우. +* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -## Signature 라이브러리 연동\(SDK v4만 해당\) {#integrate-the-signature-library} +Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +--------------------------------------------------------------------------------- - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - - + 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. @@ -64,27 +64,25 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -## Adjust Suite에서 인증서 설정 {#set-up-your-certificates-in-the-adjust-suite} +Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------------- - + 이 단계는 앱이 **Android** 를 대상으로 하는 경우에만 필요합니다. - - + Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. 인증서의 핑거프린트는 인증서 내의 공개 정보를 암호화한 해시입니다. 앱의 인증 여부를 검증하는 데 사용할 수 있습니다. 서명 라이브러리는 인증서 핑거프린트의 인증 여부를 검증할 수 없습니다. 핑거프린트가 포함된 요청을 Adjust가 인증된 것으로 수락하게 하려면 핑거프린트를 Adjust Suite의 허용 리스트에 추가해야 합니다. 이를 위해 인증서의 핑거프린트를 가져와 Adjust에 전송합니다. - - + 서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. + - - -#### Keystore 사용 {#from-a-keystore} +#### Keystore 사용 \{\#from\-a\-keystore\} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -93,7 +91,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 2. 다음의 명령어를 실행하여 키를 나열합니다. 괄호 안의 내용은 입력한 정보로 대체합니다. ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 이 명령은 키스토어 암호를 요구합니다. 키스토어를 생성할 때 정의한 암호입니다. @@ -125,7 +123,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### Google Play Internal App Sharing 사용 {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharing 사용 \{\#from\-google\-play\-internal\-app\-sharing\} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -138,7 +136,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signing 사용 {#from-google-play-app-signing} +#### Google Play App Signing 사용 \{\#from\-google\-play\-app\-signing\} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -151,15 +149,13 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signing 사용 {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signing 사용 \{\#from\-huawei\-appgallery\-app\-signing\} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. - - + Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토어에서 인증서 핑거프린트를 가져오는 방법에 관한 지침](#from-a-keystore)을 따릅니다. - - + 핑거프린트를 추출하는 방법은 다음과 같습니다. @@ -181,13 +177,12 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. - - + 인증서의 핑거프린트를 확보한 후에 다음 단계에 따라 핑거프린트를 허용 리스트에 추가합니다. @@ -200,21 +195,20 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## 앱 테스트 {#test-your-app} +앱 테스트 \{\#test\-your\-app\} +-------------------------------- -[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. - - +[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - - + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. 호출은 다음과 같습니다. @@ -229,18 +223,20 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -## {#troubleshooting} 문제 해결 +\{\#troubleshooting\} 문제 해결 +------------------------------ ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. -### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} +### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) +