Apple 로그인 설정 가이드

Apple 로그인 설정 가이드

이 문서는 Shopify의 Social Login 앱을 사용하는 판매자를 위한 가이드입니다. Apple 로그인 기능을 활성화하고, 필요한 Apple 자격증명을 입력하며, 버튼 스타일을 설정 화면에서 직접 커스터마이징하는 방법까지 단계별로 안내합니다.

시작 전에:
Apple Developer 계정의 Team ID, Service ID, Key ID, Private Key(.p8)를 준비해 주세요. 아직 없다면 Apple의 안내에 따라 먼저 설정해야 합니다. Social Login 앱은 이후의 설정을 자동으로 처리합니다.

개요

Apple 로그인은 고객이 Apple ID로 빠르고 프라이버시 중심의 방식으로 로그인할 수 있게 해줍니다. 필요한 Apple 정보 입력, 활성화 스위치, 버튼 스타일 설정은 모두 Social Login 앱 내에서 관리됩니다.

Apple 자격증명 입력

Social Login 앱에서 App Settings > Apple Login으로 이동한 후, Apple Developer 계정에서 가져온 값을 아래 항목에 입력합니다.

  • APP ID — Services ID (예: com.yourbrand.login)
  • Team ID — Apple Developer 멤버십에 표시된 팀 식별자
  • Key ID — 생성된 Sign in with Apple 키의 식별자
  • Private Key — 다운로드한 .p8 파일의 전체 내용
  • Redirect URL — 앱에서 제공하는 콜백 URL(Apple에도 동일하게 등록 필요)
Social Login 시스템은 입력한 정보를 기반으로 Apple Client Secret을 자동 생성합니다. 별도의 토큰 생성 작업은 필요하지 않습니다.

Apple Developer 설정 단계

아래는 APP ID, Team ID, Key ID, Private Key를 찾기 위해 Apple Developer 포털에서 수행해야 하는 단계입니다. 스크린샷 번호와 순서가 동일합니다.

  1. Apple Developer 계정에 로그인한 후 Certificates, Identifiers & Profiles로 이동합니다.
    Certificates, Identifiers & Profiles
  2. Identifiers에서 새로운 App ID를 생성하고 Sign In with Apple 기능을 활성화합니다. 이 화면에서 Team ID도 확인할 수 있습니다.
    Create App ID
  3. 새로운 Service ID를 생성합니다. 이 값이 Shopify 앱에서 사용하는 APP ID가 됩니다. Sign In with Apple을 활성화하고 Configure를 클릭합니다.
    Service ID Creation
  4. 2단계에서 만든 App ID를 Primary App으로 선택합니다. 도메인은 shopidreamapps.com, Return URL은 https://shopidreamapps.com/apple/auth로 입력 후 저장합니다.
    Primary App Settings
  5. 상단 메뉴에서 Keys로 이동해 새 키를 생성합니다. Sign In with Apple을 활성화한 뒤 Configure를 클릭합니다.
    Create Key
  6. 앞서 설정한 Primary App을 선택 후 저장합니다.
    Save Key Settings
  7. .p8 파일을 다운로드하고 표시된 Key ID를 기록해 둡니다. Shopify 앱 설정에 입력해야 합니다.
    Download Private Key

Shopify에서 Apple 로그인 활성화

Apple 자격증명을 모두 입력했다면, Shopify 관리자 화면에서 아래 단계를 완료하세요.

  1. Shopify 관리자 → Social Login 앱을 열고 API Keys > Apple 메뉴로 이동합니다.
    API Key Page
  2. 수집한 APP ID, Team ID, Key ID, Private Key(.p8), Redirect URL을 입력합니다.
  3. Apple Login 스위치를 Enabled로 켠 뒤 Save를 클릭하세요. 이제 스토어프런트에서 Apple 버튼이 표시됩니다.
마지막 확인: Apple 항목의 모든 값이 입력되어 있는지 확인한 뒤 저장하세요. 이제 Apple 로그인이 정상적으로 활성화되었습니다.

통합 확인

  1. 스토어프런트 로그인 페이지에서 Apple 버튼이 보이는지 확인합니다.
  2. Apple ID로 테스트 로그인하여 정상적으로 리디렉션되는지 확인합니다.
  3. Shopify 고객 목록에서 Apple 로그인 정보가 반영되는지 확인합니다.
문제가 발생하면 입력한 Apple 자격증명을 다시 확인하세요. 키가 만료되었거나 변경되었다면 새로운 키를 생성해 다시 입력해야 합니다.

FAQ & 문제 해결

Client Secret을 매번 갱신해야 하나요?

아닙니다. Social Login 시스템이 자동으로 Client Secret을 생성·관리합니다. 인증 오류가 발생하면 Apple 키 정보가 유효한지 확인하세요.

여러 도메인을 사용할 때는?

Services ID 설정에서 도메인을 추가해 주세요. 환경(프로덕션, 스테이징 등)에 따라 Redirect URL도 일치해야 합니다.

버튼은 보이는데 로그인 에러가 납니다.

대부분 Apple Developer 포털의 설정값 또는 Shopify 앱 입력값이 일치하지 않을 때 발생합니다. 변경된 값이 없는지 다시 확인하세요.

© Social Login App Documentation