로그인 설정

로그인 설정은 앱아이디에 사용할 로그인 정보를 설정하는 메뉴입니다.

로그인 설정 기본 화면¶

• 프로젝트 선택 : 앱센터에서 설정된 개발 중 또는 라이브 상태의 프로젝트만 나타납니다.
• 앱아이디 : 프로젝트와 연결된 앱아이디 목록을 표시하며, 각 앱아이디는 개발 중, 라이브, 미사용, 서비스 종료 상태를 나타냅니다. ! 표시는 로그인 설정이 등록중이거나 등록되지 않는 앱아이디에 부여됩니다.
• 초기화 : 기존 설정으로 변경하고 싶을 때 사용합니다. 설정이 서버에 저장되어 있을 경우, 저장된 내역으로 롤백됩니다.
• 변경 내역 : 로그인 설정 메뉴의 변경 내역을 확인할 수 있습니다.

로그인 설정 단계¶

로그인 설정은 로그인 종류 선택, 로그인 순서 설정, 인증 키 등록의 세 단계로 이루어집니다.

1. 로그인 종류 선택
   • 앱센터에서 생성한 앱 아이디에 등록된 운영체제(OS)에 따라 지원되는 로그인 종류가 자동으로 표시됩니다. 활성화하고자 하는 로그인 종류를 선택하세요.
2. 로그인 순서 설정
   • 선택한 로그인 종류의 순서를 프로젝트 요구에 맞게 드래그하여 위치를 조정할 수 있습니다.
3. 인증 키 등록
   • 각 스토어에서 제공하는 로그인 수단의 인증 키를 복사하여 로그인 설정 페이지에 붙여 넣습니다. 단, 모든 로그인 수단이 로그인 설정에서 인증 키를 등록하지 않을 수 있으며, 일부 로그인 수단은 Hive SDK에 직접 등록해야 합니다. 각 스토어의 인증 키 등록 방법에 대한 자세한 내용은 아래에서 확인할 수 있습니다.

지원하는 로그인 종류¶

로그인 설정은 앱아이디와 연결된 프로젝트마다 개별 설정이 필요하며, 앱센터에 등록된 운영체제(OS)에 따라 다음과 같이 구분됩니다.

모바일 (Android, iOS)¶

모바일(Android, iOS)에서 사용할 수 있는 IdP는 Google Play, Hive, Google, Facebook 등 다양합니다.

• Android : Google Play, Hive, Google, Facebook, QQ, VK, WeChat, Apple, LINE, Weverse, Huawei, X, Steam

• iOS : Game Center, Hive, Google, Facebook, QQ, VK, WeChat, Apple, LINE, Weverse, X, Steam

PC (Windows, MacOS)¶

PC(Windows, MacOS)에서 사용할 수 있는 IdP는 Hive, Google, Facebook, Apple입니다. 만약 앱아이디가 앱센터에 Steam 마켓으로 설정된 경우, 'Steam으로 로그인'이 필수로 활성화됩니다.

• 일반
• Steam 마켓
  

웹¶

웹에서 사용할 수 있는 IdP는 Hive, Google, Facebook, Apple 입니다. 웹 로그인의 경우, 인증 키 등록 시 Redirect URI를 등록해야 합니다.

스토어 키 발급 및 로그인 설정 인증 키 등록¶

로그인 설정 메뉴에서 등록하는 인증 키는 Hive에서 제공하는 모든 로그인의 키를 등록하지 않습니다. 로그인 설정 메뉴에서 등록하지 않는 IdP의 경우에는 SDK에 등록합니다.

Google Play로 로그인¶

로그인 설정 인증 키 입력 화면¶

Google Play로 로그인을 사용하려면 아래 내용을 참고하여 클라이언트 ID와 클라이언트 보안 비밀번호를 확인하고 로그인 설정 메뉴에 등록하세요.

Google Play Console 키 발급 및 등록 절차¶

• Google Play Console에서 Play 게임즈 서비스 설정
  • Google Play Console를 접속하여 Google 계정으로 로그인한 후 Play 게임즈 서비스 > 설정 및 관리 > 설정 메뉴를 클릭합니다.
  • Play 게임즈 서비스 프로젝트를 선택합니다.
    • 새로운 Play 게임즈 서비스 프로젝트 만들기: 새로운 Play 게임즈 프로젝트와 클라우드 프로젝트가 생성됩니다.
    • 기존 Play 게임즈 서비스 프로젝트 사용: 기존 프로젝트를 재사용합니다.
  • 클라우드 프로젝트를 선택합니다. 기존에 만들어진 클라우드 프로젝트가 없다면 '새 클라우드 프로젝트 만들기'를 클릭합니다.
  • Google Cloud 프로젝트 만들기 팝업에서 Google Cloud 콘솔을 클릭하여 페이지를 이동합니다.
• Google Cloud 콘솔에서 프로젝트 만들기
  • Google Cloud 콘솔에서 새 프로젝트를 만듭니다.
• Google Cloud 콘솔에서 OAuth 동의 화면 설정
  • API 및 서비스 > OAuth 동의 화면으로 이동하여 Use Type을 외부로 선택하고 '만들기'를 클릭합니다.
  • 앱 등록 수정에서 앱 정보의 앱 이름, 사용자 지원 이메일, 개발자 연락처 정보를 입력하고 '저장 후 계속'을 클릭합니다.
  • 범위에 대한 추가 설정 없이 '저장 후 계속'을 클릭합니다.
  • 테스트 사용자에 대한 추가 설정 없이 '저장 후 계속'을 클릭합니다.
  • 요약 화면에서 설정한 내용을 확인하고 '대시보드로 돌아가기'를 클릭합니다.

• Google Cloud 콘솔에서 사용자 인증 정보 만들기

  • API 및 서비스 > 사용자 인증 정보에서 사용자 인증 정보 만들기를 클릭하여 OAuth 클라이언트 ID를 선택합니다.
  • 애플리케이션 유형 : Android
    • 애플리케이션 유형과 이름과 SHA-1 인증서 디지털 지문을 입력하고 '만들기'를 클릭합니다. Google Play Service 가이드 참고
      • 패키지 이름은 AndroidManifest.xml 파일에서 찾을 수 있습니다.
      • SHA-1 인증서 디지털 지문은 명령 프롬프트에서 C:\Users\%USERPROFILE%.android>에 아래의 keytool 커맨드를 사용하여 확인할 수 있습니다.
    • OAuth 클라이언트 생성됨 창에서 클라이언트 ID를 확인합니다.
  • 애플리케이션 유형 : 웹 애플리케이션
    • OAuth 클라이언트 ID를 선택해 웹 애플리케이션 유형을 추가로 생성합니다.
    • 애플리케이션 이름을 입력하고 만들기를 클릭합니다.
    • OAuth 클라이언트 생성됨 창에서 클라이언트 ID와 클라이언트 보안 비밀번호를 확인합니다.
  Note

  • Google Play로 로그인을 사용하기 위해 사용자 인증 정보를 만들 때 애플리케이션 유형을 Andriod와 웹 애플리케이션 모두 생성합니다. 애플리케이션 유형 Android는 Hive SDK에 설정할 때 필요하며, 애플리케이션 유형 웹 애플리케이션은 로그인 설정 메뉴에서 인증 키 등록 때 사용합니다.

• Google Play Console에서 Play 게임즈 서비스 설정에서 클라우드 프로젝트 설정

  • 클라우드 프로젝트를 선택하여 '새 클라우드 프로젝트 만들기'를 클릭하고, 생성된 프로젝트 ID를 확인합니다.

Google로 로그인¶

로그인 설정 인증 키 입력 화면¶

Google로 로그인을 사용하려면 아래 내용을 참고하여 클라이언트 ID와 클라이언트 보안 비밀번호를 확인하고 로그인 설정 메뉴에 등록하세요.

Google Cloud 콘솔 키 발급 및 등록 절차¶

• Google Cloud 콘솔에서 프로젝트 만들기
  • Google Cloud 콘솔에서 새 프로젝트를 만듭니다.
• Google Cloud 콘솔에서 OAuth 동의 화면 설정
  • API 및 서비스 > OAuth 동의 화면으로 이동하여 Use Type을 외부로 선택하고 '만들기'를 클릭합니다.
  • 앱 등록 수정에서 앱 정보의 앱 이름, 사용자 지원 이메일, 개발자 연락처 정보를 입력하고 '저장 후 계속'을 클릭합니다.
  • 범위에 대한 추가 설정 없이 '저장 후 계속'을 클릭합니다.
  • 테스트 사용자에 대한 추가 설정 없이 '저장 후 계속'을 클릭합니다.
  • 요약 화면에서 설정한 내용을 확인하고 '대시보드로 돌아가기'를 클릭합니다.
• Google Cloud 콘솔에서 사용자 인증 정보 만들기
  • API 및 서비스 > 사용자 인증 정보에서 사용자 인증 정보 만들기를 클릭하여 OAuth 클라이언트 ID를 선택합니다.
  • 애플리케이션 유형 : Android
    • 애플리케이션 유형과 이름과 SHA-1 인증서 디지털 지문을 입력하고 '만들기'를 클릭합니다. Google Play Service 가이드 참고
      • 패키지 이름은 AndroidManifest.xml 파일에서 찾을 수 있습니다.
      • SHA-1 인증서 디지털 지문은 명령 프롬프트에서 C:\Users\%USERPROFILE%.android>에 아래의 keytool 커맨드를 사용하여 확인할 수 있습니다.
    • OAuth 클라이언트 생성됨 창에서 클라이언트 ID를 확인합니다.
  • 애플리케이션 유형 : 웹 애플리케이션
    • OAuth 클라이언트 ID를 선택해 웹 애플리케이션 유형을 추가로 생성합니다.
    • 애플리케이션 이름을 입력하고 만들기를 클릭합니다.
    • OAuth 클라이언트 생성됨 창에서 클라이언트 ID와 클라이언트 보안 비밀번호를 확인합니다.
  Note

  • 애플리케이션 유형 Android는 Hive SDK에서 설정합니다.
  • 애플리케이션 유형 웹 애플리케이션은 Web, Windows, MacOS 로그인 설정 메뉴에서 사용합니다.

Facebook으로 로그인¶

로그인 설정 인증 키 입력 화면¶

Facebook으로 로그인을 사용하려면 아래 내용을 참고하여 페이스북의 앱 ID와 앱 시크릿 코드을 확인하고 로그인 설정 메뉴에 등록하세요.

Facebook 개발자 사이트 키 발급 및 등록 절차¶

• Facebook 개발자 사이트 접속 및 로그인
  • 페이스북 개발자 사이트에 접속하여 페이스북 계정으로 로그인합니다.
  • '내 앱'을 클릭한 후, 기존 앱을 선택하거나 새 앱을 등록합니다.
• 앱 설정 페이지에서 앱 ID와 앱 시크릿 코드 확인
  • 앱 대시보드에서 '설정 > 기본'을 클릭하여 앱 ID와 앱 시크릿 코드를 확인합니다.
  • 앱 시크릿 코드는 보안상의 이유로 숨겨져 있으며, 확인 시 비밀번호 입력이 요구될 수 있습니다.
• 참고 사항
  • 참고 사항의 경우 로그인 설정 메뉴에는 등록하지 않아도 되지만 페이스북 로그인하려면 필요한 설정 기능입니다.
    • '앱 설정 > 고급 설정'에서 앱 인증을 활성화하세요.
    • '앱 설정 > 고급 설정 > 보안'에서 클라이언트 토큰을 확인한 후 Hive SDK에 클라이언트 토큰을 설정합니다.
    • 'Facebook 로그인 > 설정'을 클릭하여 클라이언트 OAuth 설정에서 유효한 OAuth 리디렉션 URI를 등록합니다.

Apple로 로그인¶

로그인 설정 인증 키 입력 화면¶

Apple로 로그인을 사용하려면 아래 내용을 참고하여 App Store Console에서 Bundle ID, Team ID, Key ID, Private Key를 확인하고 로그인 설정 메뉴에 등록하세요. 만약 인증 키 입력 시 Bundle ID가 앱아이디와 동일하지 않을 경우 Apple 개발자사이트의 Bundle ID를 입력합니다.

Apple 개발자 사이트 키 발급 및 등록 절차¶

• Certificates, Identifiers & Profiles 페이지로 이동
  • Apple 개발자 사이트에 접속하여 Apple ID로 로그인한 후, 상단 메뉴에서 'Account'를 클릭하고 'Certificates, Identifiers & Profiles'로 이동합니다.
• Bundle ID 확인
  • Certificates, Identifiers & Profiles에서 Identifiers로 이동하여 Bundle ID를 확인합니다.
• Team ID 확인
  • Team ID는 Apple 개발자 계정의 고유 식별자로, 'Membership' 섹션에서 확인할 수 있습니다.
• Key ID 확인
  • 'Certificates, Identifiers & Profiles'에서 'Keys' 섹션으로 이동합니다. Key Name을 입력한 후 'Sign in with Apple'을 선택하고 'Continue'를 클릭합니다.
  • 'Configure Key' 페이지에서 'Primary App ID' 항목에 'Sign in with Apple'을 사용할 앱 ID를 선택한 후 'Save'를 클릭합니다.
  • 'Register a New Key' 페이지에서 'Register'를 클릭합니다.
  • 'Download Your Key' 페이지에서 Key ID를 확인하고 'Download'를 클릭하여 키를 생성 및 다운로드합니다.
• Private Key 다운로드
  • .p8 형식의 Private Key 파일을 다운로드할 수 있습니다. 이 파일은 한 번만 다운로드 가능하므로 안전한 위치에 보관하세요.
  • 로그인 설정 시, 반드시 -----BEGIN PRIVATE KEY-----와 -----END PRIVATE KEY-----를 포함하여 등록해 주세요.

HUAWEI ID 로그인¶

로그인 설정 인증 키 입력 화면¶

HUAWEI ID 로그인을 사용하려면 아래 내용을 참고하여 Huawei의 Client ID와 Client Secret을 확인하고 로그인 설정 메뉴에 등록하세요.

Huawei 개발자 콘솔 키 발급 및 등록 절차¶

• AppGallery Connect로 이동
  • Huawei 개발자 콘솔에 접속하여 Huawei 계정으로 로그인한 후 AppGallery Connect로 이동합니다.
  • 'My Projects'를 선택하고, 앱 대시보드에서 'Project Settings'를 클릭합니다.
• 프로젝트 설정에서 App ID와 App Secret 확인
  • Project Settings > General Information 섹션을 클릭하고 App information 아래 'OAuth 2.0 client ID'에서 Client ID와 Client Secret을 확인할 수 있습니다.

Steam으로 로그인¶

모바일 (Android, iOS)¶

로그인 설정 인증 키 입력 화면¶

Steam 로그인을 사용하려면 아래 내용을 참고하여 웹 API를 확인하여 로그인 설정 메뉴에 등록하세요.

Steamworks 파트너 사이트 키 발급 및 등록 절차¶

• Steamworks 파트너 사이트 접속 및 로그인
  • Steamworks 파트너 사이트에 접속하여 steam 계정으로 로그인합니다.
• 웹 API 키 확인
  • 상단 메뉴에서 '사용자 및 사용 권한'에서 '그룹 관리' 목록에서 그룹을 클릭합니다. 그룹이 없을 경우에는 '새로운 그룹 만들기'를 클릭하여 그룹을 생성합니다.
  • 선택한 그룹의 웹 API를 확인합니다.

PC (Winodows, MacOS)¶

로그인 설정 인증 키 입력 화면¶

Steam 로그인을 사용하려면 아래 내용을 참고하여 앱 ID와 웹 API를 확인하여 로그인 설정 메뉴에 등록하세요.

Steamworks 파트너 사이트 키 발급 및 등록 절차¶

• 앱 ID 확인
  • Steamworks 파트너 사이트에 접속하여 Steam 계정으로 로그인한 후, 상단의 '앱 및 패키지' 메뉴에서 '앱'을 클릭하여 기존 애플리케이션을 선택합니다.
  • 앱 ID는 Steam에서 애플리케이션을 식별하는 숫자로 애플리케이션의 대시보드에서 확인할 수 있습니다.
• 사용자 및 권한 관리에서 웹 API 확인
  • 상단 메뉴에서 '사용자 및 사용 권한'에서 '그룹 관리' 목록에서 그룹을 클릭합니다. 그룹이 없을 경우에는 '새로운 그룹 만들기'를 클릭하여 그룹을 생성합니다.
  • 선택한 그룹의 웹 API를 확인합니다.

Telegram으로 로그인¶

로그인 설정 인증 키 입력 화면¶

Telegram으로 로그인을 사용하려면 아래 내용을 참고하여 Bot Token을 확인하고 로그인 설정 메뉴에 등록하세요.

Telegram 키 발급 및 등록 절차¶

• Bot 생성
  1. Telegram 앱을 실행하고, 검색창에 BotFather를 입력하여 BotFather를 찾습니다.
  2. BotFather와 채팅을 시작하고 /start 명령어를 입력합니다.
  3. /newbot 명령어를 입력하여, 로그인 처리를 위한 새로운 봇을 생성합니다.
  4. 봇 이름과 사용자 이름을 순서대로 입력합니다.
     • 봇 이름: 유저가 봇을 식별할 이름 (예: MyLoginBot).
     • 사용자 이름: _bot으로 끝나는 고유한 이름 (예: my_login_bot).
  5. 봇 생성이 완료되면 BotFather가 Bot Token을 제공합니다. 이 토큰은 Telegram API를 통해 봇과 통신하는 데 사용됩니다.