> ## 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 OAuth 구성

> 앱 인증을 위한 Apple로 로그인을 설정하세요

이 가이드는 Apple로 로그인에 필요한 Apple App ID, Services ID, 개인 키를 만드는 방법을 안내합니다. **Auth 창**에 입력할 **Team ID**, **Services ID**, **Key ID**, **개인 키**를 수집합니다.

<Note>
  이 페이지는 Apple 개발자 포털에서의 공급자 측 설정만 다룹니다. Apple을 활성화하고 **Auth 창**에 자격 증명을 입력하는 전체 Clerk Auth 흐름에 대해서는 Clerk Auth 문서의 [SSO 공급자에 대한 OAuth 자격 증명 구성](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)을 참조하세요.
</Note>

## 사전 요구 사항

* [Apple 개발자 계정](https://developer.apple.com/account) (Apple 개발자 프로그램 등록 필요)
* [게시된 Replit 앱](/learn/projects-and-artifacts/replit-deployments) — 사용자 정의 OAuth 자격 증명은 **프로덕션** 환경에서만 사용 가능
* **Auth 창** → **구성** 탭 → **SSO 공급자** 섹션 → **프로덕션** 환경 선택 → **Apple** 옆의 **편집** 선택에서 열린 **Apple** 공급자 편집 패널

## 1단계: Apple App ID 만들기

1. [Apple 개발자 포털](https://developer.apple.com/account)로 이동합니다
2. **인증서, 식별자 및 프로파일**로 이동한 다음 **식별자**로 이동합니다
3. 드롭다운에서 **App IDs**를 선택합니다
4. **+** 아이콘을 선택하여 새 식별자를 등록합니다
5. **App IDs**를 선택한 다음 **계속**을 선택합니다
6. **앱**을 선택한 다음 **계속**을 선택합니다
7. 다음을 입력합니다:
   * **설명**: App ID의 이름
   * **번들 ID**: 고유 식별자
8. 기능에서 **Sign In with Apple**을 활성화합니다
9. **계속**을 선택한 다음 **등록**을 선택합니다
10. **App ID 접두사**(상단에 표시됨)를 저장합니다 — 이것이 **Team ID**입니다

## 2단계: Apple Services ID 만들기

1. 식별자 페이지에서 드롭다운의 **Services IDs**를 선택합니다
2. \*\*+\*\*를 선택하여 새 식별자를 등록합니다
3. **Services IDs**를 선택한 다음 **계속**을 선택합니다
4. 다음을 입력합니다:
   * **설명**: Services ID의 이름
   * **식별자**: 고유 식별자 (이것을 저장하세요 — **Services ID**입니다)
5. **계속**을 선택한 다음 **등록**을 선택합니다

### Services ID 구성

1. 새로 만든 Services ID를 선택합니다
2. **Sign In with Apple**을 활성화합니다
3. **구성**을 선택합니다
4. 다음을 설정합니다:

   * **Primary App ID**: 1단계의 App ID 선택
   * **도메인 및 서브도메인**: **Auth 창**의 **공급자 설정**에 표시된 값을 복사합니다 (`https://` 프로토콜 접두사 없이)
   * **반환 URL**: **Auth 창**의 **공급자 설정**에 표시된 값을 복사합니다

   이러한 값을 찾는 방법은 [SSO 공급자에 대한 OAuth 자격 증명 구성](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)을 참조하세요.
5. **다음**을 선택한 다음 **완료**, **계속**, **저장**을 선택합니다

## 3단계: Apple 개인 키 만들기

1. Apple 개발자 포털 사이드바에서 **키**를 선택합니다
2. \*\*+\*\*를 선택하여 새 키를 등록합니다
3. **키 이름**을 입력합니다
4. **Sign In with Apple**을 활성화합니다
5. **구성**을 선택한 다음 1단계의 App ID를 선택합니다
6. **저장**을 선택한 다음 **계속**, **등록**을 선택합니다
7. **Key ID를 저장합니다**
8. 개인 키 파일(.p8)을 **다운로드합니다**

<Warning>
  개인 키는 한 번만 다운로드할 수 있습니다. 안전하게 보관하세요 — 다시 다운로드할 수 없습니다.
</Warning>

## 4단계: Apple 개인 이메일 릴레이 구성

Apple의 내 이메일 숨기기 기능을 사용하면 사용자가 실제 이메일을 노출하지 않고 로그인할 수 있습니다. 이러한 사용자에게 이메일을 보내려면 이메일 소스를 등록하세요.

1. Apple 개발자 포털 사이드바에서 **서비스**를 선택합니다
2. **이메일 커뮤니케이션을 위한 Apple로 로그인** 아래에서 **구성**을 선택합니다
3. \*\*+\*\*를 선택하여 이메일 소스를 추가합니다
4. **Auth 창**의 **공급자 설정**에 표시된 이메일 소스 값을 입력합니다
5. **다음**을 선택한 다음 **등록**, **완료**를 선택합니다
6. DNS 확인을 기다립니다 (녹색 체크 아이콘)

<Info>
  일부 지역(중국, 인도)에서는 Apple ID가 이메일 대신 전화번호에 연결될 수 있습니다. 앱이 모든 사용자에게 이메일을 요구하는 경우, 이 지역 사용자에 대해 Apple로 로그인이 실패할 수 있습니다.
</Info>

## 문제 해결

### 유효하지 않은 클라이언트

* 모든 자격 증명이 올바르게 입력되었는지 확인하세요
* 개인 키에 BEGIN 및 END 줄이 포함되어 있는지 확인하세요
* Services ID가 올바르게 구성되어 있는지 확인하세요

### 유효하지 않은 리디렉션 URI

* Apple Services ID 구성의 반환 URL이 **Auth 창**의 **공급자 설정**에 표시된 값과 정확히 일치하는지 확인하세요
* 도메인 및 서브도메인의 도메인이 게시된 도메인과 일치하는지 확인하세요 (`https://` 없이)

### 이메일 릴레이가 작동하지 않음

* Apple 개발자 포털에서 이메일 소스에 녹색 체크가 표시되는지 확인하세요
* 최근에 추가했다면 DNS 전파를 기다리세요

### 사용자 정의 도메인에서 작동하지 않음

* **Auth 창**의 **공급자 설정**에 표시된 사용자 정의 도메인 항목을 도메인 및 서브도메인(`https://` 없이)과 반환 URL에 추가하세요

## 추가 리소스

* [Apple Sign in with Apple 문서](https://developer.apple.com/sign-in-with-apple/)
* [개인 이메일 릴레이 서비스 가이드](https://developer.apple.com/help/account/configure-app-capabilities/configure-private-email-relay-service)