adjust-icon

Android 인증서 핑거프린트 조회

인증서 핑거프린트는 인증서 내의 공개 정보를 암호화한 해시입니다. Google 문서에 설명된 바와 같이, 인증서 핑거프린트는 서드파티가 Android 앱 인증을 위해 사용하도록 고안된 공개 정보입니다. Adjust는 절대 비공개 앱 서명 키를 요청하지 않습니다.

Adjust는 다음 기능에 인증서 핑거프린트를 사용합니다.

기능해싱 알고리즘예시
SDK Signature(SDK 서명)SHA-1C4:BD:07:91:BC:09:F8:B6:15:CD:BC:A3:3F:BC:68:8B:C2:EF:4F:F5
Android 앱 링크SHA-25655:FB:97:0F:46:0F:94:EC:07:EA:01:69:50:5A:20:3F:A0:91:60:A4:F1:33:58:EA:76:DC:54:9E:A7:6A:B9:1A

앱의 배포 메서드에서 인증서 핑거프린트를 얻는 가장 좋은 방법을 아래의 표에서 확인하시기 바랍니다. Adjust 대시보드 구성 시 빌드에 적용 가능한 모든 인증서 핑거프린트를 추가하시기 바랍니다.

호스팅 서비스권장 접근 방식
Google PlayGoogle Play Console
Google Play 테스트 트랙Google Play Console - Internal App Sharing(내부 앱 공유)
Huawei App Gallery - 앱 서명 활성화AppGallery Connect
• Huawei App Gallery - 앱 서명 비활성화
• 기타 스토어 또는 직접 APK 다운로드
• 로컬 디버그 빌드
키스토어 또는 APK

Google Play Console에서

  1. Google Play Console에서 앱으로 이동합니다.

  2. 왼쪽의 메뉴에서 테스트 및 릴리스 > 설정 > 앱 서명 을 선택합니다.

  3. Play 앱 서명을 사용하는 경우 앱 서명 키 인증서 섹션이 표시됩니다. 이 섹션에서 SHA-1 인증 핑거프린트 및/또는 SHA-256 인증 핑거프린트 를 복사합니다.

    Google Play Console의 앱 서명 키 인증서 페이지 스크린샷

  4. 업로드 키 인증서 아래에 SHA-1 인증 핑거프린트 및/또는 SHA-256 인증 핑거프린트 를 복사합니다.

    Google Play Console의 업로드 키 인증서 페이지 스크린샷

Google Play Console - Internal App Sharing

  1. Google Play Console에서 앱으로 이동합니다.

  2. 왼쪽 메뉴의 테스트 및 릴리스 > 테스트 > Internal App Sharing(내부 앱 공유) 를 선택합니다.

  3. 내부 테스트 인증서 아래에서 SHA-1 인증 핑거프린트 및/또는 SHA-256 인증 핑거프린트 를 복사합니다.

    Google Play Console의 Internal App Sharing(내부 앱 공유) 키 인증서 페이지 스크린샷

AppGallery Connect에서

Huawei App Signing을 사용하는 경우 아래의 지침을 따르시기 바랍니다. Huawei App Signing을 사용하지 않는 경우 키스토어에서 또는 APK에서 인증서 핑거프린트를 조회합니다.

Keystore 사용

키스토어에서 인증서 핑거프린트를 조회하려면 다음의 단계를 수행하시기 바랍니다.

  1. 다음에서 키스토어를 찾습니다.

    • 자체 관리형 키스토어: .jks 파일이 포함된 폴더의 경로
    • Android 디폴트 디버그 키스토어:
      • MacOS/Linux: ~/.android/debug.keystore
      • Windows: %USERPROFILE%\.android\debug.keystore
  2. 아래의 keytool 명령어를 실행하여 파라미터 값을 교체합니다.

    Terminal window
    # For a self-managed keystore (replace with path to your .jks file):
    keytool -list -v -keystore </path/to/keystore.jks> -alias <your_key_alias>
    # For the Android default debug keystore:
    keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey
  3. 비밀번호를 입력할 때 다음을 수행합니다.

    • 자체 관리형 키스토어의 경우 키스토어 생성 시 설정한 비밀번호를 입력합니다.
    • Android 디폴트 디버그 키스토어에 android를 입력합니다.
  4. 아웃풋에서 SHA1 및/또는 SHA256 값을 조회합니다.

[...]
SHA1: C4:BD:07:91:BC:09:F8:B6:15:CD:BC:A3:3F:BC:68:8B:C2:EF:4F:F5
SHA256: 55:FB:97:0F:46:0F:94:EC:07:EA:01:69:50:5A:20:3F:A0:91:60:A4:F1:33:58:EA:76:DC:54:9E:A7:6A:B9:1A
[...]

APK에서

APK 서명에 사용된 인증서 핑거프린트를 조회하려면 다음의 단계를 수행하시기 바랍니다.

  1. 필요한 경우 Android Studio를 설치하여 apksigner 명령어를 받습니다.

    • Android Studio 설치 시 Android SDK가 설치되어 있는지 확인합니다(기본값으로 포함되어 있음).
    • Android SDK build-tools는 아래 위치에 설치됩니다.
      • MacOS/Linux: ~/Library/Android/sdk/build-tools/<version>/
      • Windows: %LOCALAPPDATA%\Android\Sdk\build-tools\<version>\
  2. 파라미터 값을 교체하여 아래의 apksigner 명령어를 실행합니다.

    Terminal window
    apksigner verify -v --print-certs <app.apk>
  3. 아웃풋에서 SHA-1 및/또는 SHA-256 값을 조회합니다. 앱에 다음과 같이 단일 서명이 표시될 수 있습니다.

[...]
Signer #1 certificate SHA-1 digest: c4bd0791bc09f8b615cdbca33fbc688bc2ef4ff5
Signer #1 certificate SHA-256 digest: 55fb970f460f94ec07ea0169505a203fa09160a4f13358ea76dc549ea76ab91a
[...]

또는 다음과 같이 여러 개의 서명이 표시될 수 있습니다.

[...]
Signer (minSdkVersion=24, maxSdkVersion=32) certificate SHA-1 digest: c4bd0791bc09f8b615cdbca33fbc688bc2ef4ff5
Signer (minSdkVersion=24, maxSdkVersion=32) certificate SHA-256 digest: 55fb970f460f94ec07ea0169505a203fa09160a4f13358ea76dc549ea76ab91a
[...]
Signer (minSdkVersion=33, maxSdkVersion=2147483647) certificate SHA-1 digest: 9a3237ad99a97e8ea72df4fb096f28d544d5b8
Signer (minSdkVersion=33, maxSdkVersion=2147483647) certificate SHA-256 digest: 92e961bf8b67043d1af6061b4a926f6a94e2bb78b46a096639e8e2c2fb7784b0
[...]

여러 개의 서명이 있는 경우 Adjust 대시보드에서 이를 모두 구성해야 합니다.