이 가이드는 Apple로 로그인에 필요한 Apple App ID, Services ID, 개인 키를 만드는 방법을 안내합니다. Auth 창에 입력할 Team ID, Services ID, Key ID, 개인 키를 수집합니다.Documentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
이 페이지는 Apple 개발자 포털에서의 공급자 측 설정만 다룹니다. Apple을 활성화하고 Auth 창에 자격 증명을 입력하는 전체 Clerk Auth 흐름에 대해서는 Clerk Auth 문서의 SSO 공급자에 대한 OAuth 자격 증명 구성을 참조하세요.
사전 요구 사항
- Apple 개발자 계정 (Apple 개발자 프로그램 등록 필요)
- 게시된 Replit 앱 — 사용자 정의 OAuth 자격 증명은 프로덕션 환경에서만 사용 가능
- Auth 창 → 구성 탭 → SSO 공급자 섹션 → 프로덕션 환경 선택 → Apple 옆의 편집 선택에서 열린 Apple 공급자 편집 패널
1단계: Apple App ID 만들기
- Apple 개발자 포털로 이동합니다
- 인증서, 식별자 및 프로파일로 이동한 다음 식별자로 이동합니다
- 드롭다운에서 App IDs를 선택합니다
- + 아이콘을 선택하여 새 식별자를 등록합니다
- App IDs를 선택한 다음 계속을 선택합니다
- 앱을 선택한 다음 계속을 선택합니다
- 다음을 입력합니다:
- 설명: App ID의 이름
- 번들 ID: 고유 식별자
- 기능에서 Sign In with Apple을 활성화합니다
- 계속을 선택한 다음 등록을 선택합니다
- App ID 접두사(상단에 표시됨)를 저장합니다 — 이것이 Team ID입니다
2단계: Apple Services ID 만들기
- 식별자 페이지에서 드롭다운의 Services IDs를 선택합니다
- **+**를 선택하여 새 식별자를 등록합니다
- Services IDs를 선택한 다음 계속을 선택합니다
- 다음을 입력합니다:
- 설명: Services ID의 이름
- 식별자: 고유 식별자 (이것을 저장하세요 — Services ID입니다)
- 계속을 선택한 다음 등록을 선택합니다
Services ID 구성
- 새로 만든 Services ID를 선택합니다
- Sign In with Apple을 활성화합니다
- 구성을 선택합니다
-
다음을 설정합니다:
- Primary App ID: 1단계의 App ID 선택
- 도메인 및 서브도메인: Auth 창의 공급자 설정에 표시된 값을 복사합니다 (
https://프로토콜 접두사 없이) - 반환 URL: Auth 창의 공급자 설정에 표시된 값을 복사합니다
- 다음을 선택한 다음 완료, 계속, 저장을 선택합니다
3단계: Apple 개인 키 만들기
- Apple 개발자 포털 사이드바에서 키를 선택합니다
- **+**를 선택하여 새 키를 등록합니다
- 키 이름을 입력합니다
- Sign In with Apple을 활성화합니다
- 구성을 선택한 다음 1단계의 App ID를 선택합니다
- 저장을 선택한 다음 계속, 등록을 선택합니다
- Key ID를 저장합니다
- 개인 키 파일(.p8)을 다운로드합니다
4단계: Apple 개인 이메일 릴레이 구성
Apple의 내 이메일 숨기기 기능을 사용하면 사용자가 실제 이메일을 노출하지 않고 로그인할 수 있습니다. 이러한 사용자에게 이메일을 보내려면 이메일 소스를 등록하세요.- Apple 개발자 포털 사이드바에서 서비스를 선택합니다
- 이메일 커뮤니케이션을 위한 Apple로 로그인 아래에서 구성을 선택합니다
- **+**를 선택하여 이메일 소스를 추가합니다
- Auth 창의 공급자 설정에 표시된 이메일 소스 값을 입력합니다
- 다음을 선택한 다음 등록, 완료를 선택합니다
- DNS 확인을 기다립니다 (녹색 체크 아이콘)
일부 지역(중국, 인도)에서는 Apple ID가 이메일 대신 전화번호에 연결될 수 있습니다. 앱이 모든 사용자에게 이메일을 요구하는 경우, 이 지역 사용자에 대해 Apple로 로그인이 실패할 수 있습니다.
문제 해결
유효하지 않은 클라이언트
- 모든 자격 증명이 올바르게 입력되었는지 확인하세요
- 개인 키에 BEGIN 및 END 줄이 포함되어 있는지 확인하세요
- Services ID가 올바르게 구성되어 있는지 확인하세요
유효하지 않은 리디렉션 URI
- Apple Services ID 구성의 반환 URL이 Auth 창의 공급자 설정에 표시된 값과 정확히 일치하는지 확인하세요
- 도메인 및 서브도메인의 도메인이 게시된 도메인과 일치하는지 확인하세요 (
https://없이)
이메일 릴레이가 작동하지 않음
- Apple 개발자 포털에서 이메일 소스에 녹색 체크가 표시되는지 확인하세요
- 최근에 추가했다면 DNS 전파를 기다리세요
사용자 정의 도메인에서 작동하지 않음
- Auth 창의 공급자 설정에 표시된 사용자 정의 도메인 항목을 도메인 및 서브도메인(
https://없이)과 반환 URL에 추가하세요