Android 안드로이드 앱 서명 키 생성하기

React Native 앱을 구글 플레이 스토어에 출시하는 전체 과정 중 첫번째

Android 앱 서명 키란? (Keystore)

앱 서명 키는 앱의 신원을 증명하는 디지털 인증서입니다.

주요 목적:

• 앱 개발자 신원 확인
• 앱의 무결성 보장
• 안전한 업데이트 보장

특히 중요한 점:

• 키를 분실하면 같은 패키지명으로 앱 업데이트 불가능
• 키는 영구적이며 변경 불가능
• 보안상 매우 중요한 정보

1. 키스토어 생성 방법

터미널을 이용한 생성

keytool -genkeypair -v -storetype PKCS12 -keystore my-upload-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000

각 파라미터 설명:

• -genkeypair: 키 페어 생성
• -v: 상세 출력
• -storetype PKCS12: 키스토어 형식
• -keystore: 생성될 키스토어 파일명
• -alias: 키 별칭
• -keyalg RSA: 암호화 알고리즘
• -keysize 2048: 키 크기
• -validity 10000: 유효기간(일)

B. Android Studio를 이용한 생성

1. Build → Generate Signed Bundle/APK 선택
2. 'Create new' 버튼 클릭
3. 키스토어 정보 입력:

Key store path: 키스토어 저장 위치 Password: 키스토어 비밀번호 Alias: 키 별칭 Validity: 유효기간 Certificate: 인증서 정보 (이름, 조직 등)

1. 키스토어 정보 관리

A. 프로젝트에 키스토어 설정

 

# android/gradle.properties

MYAPP_UPLOAD_STORE_FILE=my-upload-key.keystore

MYAPP_UPLOAD_KEY_ALIAS=my-key-alias

MYAPP_UPLOAD_STORE_PASSWORD=*****

MYAPP_UPLOAD_KEY_PASSWORD=*****

B. build.gradle 설정

gandroid {
    ...
    signingConfigs {
        release {
            storeFile file(MYAPP_UPLOAD_STORE_FILE)
            storePassword MYAPP_UPLOAD_STORE_PASSWORD
            keyAlias MYAPP_UPLOAD_KEY_ALIAS
            keyPassword MYAPP_UPLOAD_KEY_PASSWORD
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
        }
    }
}

 

1. 키스토어 안전하게 보관하기

중요한 보안 수칙들:

A. 키스토어 파일 보호

• 안전한 오프라인 저장소에 백업
• 버전 관리 시스템에 커밋하지 않기
• .gitignore에 추가

*.keystore
*.jks
gradle.properties

B. 비밀번호 보호

• 환경변수 사용
• 별도의 보안 저장소 사용

# 환경변수 설정 예시
export MYAPP_UPLOAD_STORE_PASSWORD=*****
export MYAPP_UPLOAD_KEY_PASSWORD=*****

1. 키스토어 정보 확인

기존 키스토어 정보 확인:

keytool -list -v -keystore my-upload-key.keystore

출력되는 정보:

• 별칭
• 생성일자
• 유효기간
• 인증서 핑거프린트
• 소유자 정보

1. 구글 플레이 앱 서명

구글 플레이 앱 서명을 사용하면:

• 구글이 앱 서명 키를 안전하게 관리
• 업로드 키만 로컬에서 관리
• 키 분실 위험 감소

설정 방법:

1. 구글 플레이 콘솔 접속
2. 앱 선택 → 설정 → 앱 무결성
3. 구글 플레이 앱 서명 등록
4. 문제 해결

일반적인 문제들:

• 키스토어 비밀번호 분실: 복구 불가능, 새 패키지명으로 재배포 필요
• 서명 불일치: 릴리즈 빌드의 서명이 이전과 다른 경우
• 빌드 오류: 서명 설정 오류

이러한 앱 서명 키의 생성과 관리는 앱 배포의 핵심적인 부분이므로, 처음부터 신중하게 관리하는 것이 매우 중요합니다.