이 페이지는 Apple Developer 포털에서의 제공자 측 설정만 다룹니다. Apple 활성화 및 Auth 패널에서의 자격 증명 입력을 포함한 전체 Clerk Auth 흐름은 Clerk Auth 문서의 SSO 제공자용 OAuth 자격 증명 구성하기를 참고하세요.
사전 준비 사항
- Apple Developer 계정 (Apple Developer Program 가입 필요)
- 게시된 Replit 앱 — 커스텀 OAuth 자격 증명은 Production 환경에서만 사용할 수 있습니다
- Apple 제공자의 편집 패널을 다음 경로로 엽니다: Auth 패널 → Configure 탭 → SSO providers 섹션 → Production 환경 선택 → Apple 옆의 Edit 선택
1단계: Apple App ID 만들기
- Apple Developer 포털로 이동합니다
- Certificates, IDs & Profiles로 이동한 다음 Identifiers를 선택합니다
- 드롭다운에서 App IDs를 선택합니다
- + 아이콘을 선택하여 새 식별자를 등록합니다
- App IDs를 선택한 다음 Continue를 선택합니다
- App을 선택한 다음 Continue를 선택합니다
- 다음 항목을 입력합니다:
- Description: App ID의 이름
- Bundle ID: 고유 식별자
- Capabilities에서 Sign In with Apple을 활성화합니다
- Continue를 선택한 다음 Register를 선택합니다
- App ID Prefix를 저장하세요(상단에 표시됨) - 이것이 Team ID입니다
2단계: Apple Services ID 만들기
- Identifiers 페이지에서 드롭다운에서 Services IDs를 선택합니다
- **+**를 선택하여 새 식별자를 등록합니다
- Services IDs를 선택한 다음 Continue를 선택합니다
- 다음 항목을 입력합니다:
- Description: Services ID의 이름
- Identifier: 고유 식별자(저장해 두세요 - 이것이 Services ID입니다)
- Continue를 선택한 다음 Register를 선택합니다
Services ID 구성하기
- 새로 만든 Services ID를 선택합니다
- Sign In with Apple을 활성화합니다
- Configure를 선택합니다
-
다음을 설정합니다:
- Primary App ID: 1단계에서 만든 App ID를 선택합니다
- Domains and Subdomains: Auth 패널의 Provider setup에 표시된 값을 복사합니다(
https://프로토콜 접두사 제외) - Return URLs: Auth 패널의 Provider setup에 표시된 값을 복사합니다
- Next를 선택한 다음 Done, Continue, Save를 순서대로 선택합니다
3단계: Apple Private Key 만들기
- Apple Developer 포털 사이드바에서 Keys를 선택합니다
- **+**를 선택하여 새 키를 등록합니다
- Key Name을 입력합니다
- Sign In with Apple을 활성화합니다
- Configure를 선택한 다음 1단계에서 만든 App ID를 선택합니다
- Save를 선택한 다음 Continue, Register를 순서대로 선택합니다
- Key ID를 저장하세요
- 프라이빗 키 파일(.p8)을 다운로드합니다
4단계: Apple Private Email Relay 구성하기
Apple의 Hide My Email 기능을 사용하면 사용자가 실제 이메일을 노출하지 않고 로그인할 수 있습니다. 이런 사용자에게 이메일을 보내려면 이메일 소스를 등록해야 합니다.- Apple Developer 포털 사이드바에서 Services를 선택합니다
- Sign in with Apple for Email Communication 아래에서 Configure를 선택합니다
- **+**를 선택하여 Email Source를 추가합니다
- Auth 패널의 Provider setup에 표시된 Email Source 값을 입력합니다
- Next를 선택한 다음 Register, Done을 순서대로 선택합니다
- DNS 확인을 기다립니다(녹색 체크 아이콘)
일부 지역(중국, 인도)에서는 Apple ID가 이메일 대신 전화번호에 연결되어 있을 수 있습니다. 앱이 모든 사용자에게 이메일을 요구하는 경우, 이러한 지역의 사용자에게는 Sign in with Apple이 실패할 수 있습니다.
문제 해결
Invalid client
- 모든 자격 증명이 올바르게 입력되었는지 확인하세요
- 프라이빗 키에 BEGIN 및 END 줄이 포함되어 있는지 확인하세요
- Services ID가 올바르게 구성되었는지 확인하세요
Invalid redirect URI
- Apple Services ID 구성의 Return URL이 Auth 패널의 Provider setup에 표시된 값과 정확히 일치하는지 확인하세요
- Domains and Subdomains의 도메인이 게시된 도메인과 일치하는지 확인하세요(
https://제외)
이메일 릴레이가 작동하지 않음
- Apple Developer 포털에서 Email Source에 녹색 체크가 표시되는지 확인하세요
- 최근에 추가했다면 DNS 전파를 기다리세요
커스텀 도메인에서 작동하지 않음
- Auth 패널의 Provider setup에 표시된 커스텀 도메인 항목을 Domains and Subdomains(
https://제외)와 Return URLs에 추가하세요