Android 인증서 핑거프린트 조회

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

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

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

Google Play Console에서

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

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

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

   

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

   

Google Play Console - Internal App Sharing

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

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

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

   

AppGallery Connect에서

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

1
   SHA1 Fingerprint=C4:BD:07:91:BC:09:F8:B6:15:CD:BC:A3:3F:BC:68:8B:C2:EF:4F:F5

Keystore 사용

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

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

   • 자체 관리형 키스토어: .jks 파일이 포함된 폴더의 경로
   • Android 디폴트 디버그 키스토어:
     • MacOS/Linux: ~/.android/debug.keystore
     • Windows: %USERPROFILE%\.android\debug.keystore

2. 아래의 keytool 명령어를 실행하여 파라미터 값을 교체합니다.

   1
   # For a self-managed keystore (replace with path to your .jks file):
   2
   keytool -list -v -keystore </path/to/keystore.jks> -alias <your_key_alias>
   3
   
   4
   # For the Android default debug keystore:
   5
   keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey

3. 비밀번호를 입력할 때 다음을 수행합니다.

   • 자체 관리형 키스토어의 경우 키스토어 생성 시 설정한 비밀번호를 입력합니다.
   • Android 디폴트 디버그 키스토어에 android를 입력합니다.

4. 아웃풋에서 SHA1 및/또는 SHA256 값을 조회합니다.

1
   [...]
2

3
   SHA1: C4:BD:07:91:BC:09:F8:B6:15:CD:BC:A3:3F:BC:68:8B:C2:EF:4F:F5
4
   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
5

6
   [...]

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 명령어를 실행합니다.

   1
   apksigner verify -v --print-certs <app.apk>

3. 아웃풋에서 SHA-1 및/또는 SHA-256 값을 조회합니다. 앱에 다음과 같이 단일 서명이 표시될 수 있습니다.

1
  [...]
2

3
  Signer #1 certificate SHA-1 digest: c4bd0791bc09f8b615cdbca33fbc688bc2ef4ff5
4
  Signer #1 certificate SHA-256 digest: 55fb970f460f94ec07ea0169505a203fa09160a4f13358ea76dc549ea76ab91a
5

6
  [...]

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

1
   [...]
2

3
   Signer (minSdkVersion=24, maxSdkVersion=32) certificate SHA-1 digest: c4bd0791bc09f8b615cdbca33fbc688bc2ef4ff5
4
   Signer (minSdkVersion=24, maxSdkVersion=32) certificate SHA-256 digest: 55fb970f460f94ec07ea0169505a203fa09160a4f13358ea76dc549ea76ab91a
5

6
   [...]
7

8
   Signer (minSdkVersion=33, maxSdkVersion=2147483647) certificate SHA-1 digest: 9a3237ad99a97e8ea72df4fb096f28d544d5b8
9
   Signer (minSdkVersion=33, maxSdkVersion=2147483647) certificate SHA-256 digest: 92e961bf8b67043d1af6061b4a926f6a94e2bb78b46a096639e8e2c2fb7784b0
10

11
   [...]

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