> ## 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の設定

> アプリの認証にSign in with Appleを設定する

このガイドでは、Sign in with Appleに必要なApple App ID、Services ID、プライベートキーを作成する手順を説明します。**Authペイン**に入力する**Team ID**、**Services ID**、**Key ID**、**Private Key**を取得します。

<Note>
  このページはApple Developerポータルでのプロバイダー側のセットアップのみを説明しています。Appleを有効化してAuthペインに認証情報を入力するClerk Auth全体のフローについては、Clerk AuthドキュメントのSSOプロバイダーのOAuth認証情報の設定を参照してください: [SSOプロバイダーのOAuth認証情報の設定](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)
</Note>

## 前提条件

* [Apple Developerアカウント](https://developer.apple.com/account)（Apple Developer Programへの登録が必要）
* [発行済みのReplitアプリ](/learn/projects-and-artifacts/replit-deployments) — カスタムOAuth認証情報は**本番**環境でのみ利用可能
* Authペインで以下の手順で開いたAppleプロバイダーの編集パネル：**Authペイン** → **Configure**タブ → **SSO providers**セクション → **Production**環境を選択 → **Apple**の横の**Edit**を選択

## Step 1: Apple App IDを作成する

1. [Apple Developerポータル](https://developer.apple.com/account)に移動します
2. **Certificates, IDs & Profiles**から**Identifiers**に移動します
3. ドロップダウンから**App IDs**を選択します
4. \*\*+\*\*アイコンを選択して新しい識別子を登録します
5. **App IDs**を選択し、**Continue**を選択します
6. **App**を選択し、**Continue**を選択します
7. 以下を入力します：
   * **Description**: App IDの名前
   * **Bundle ID**: 一意の識別子
8. CapabilitiesのSign In with Appleを有効にします
9. **Continue**を選択し、**Register**を選択します
10. **App ID Prefix**（上部に表示）を保存します — これが**Team ID**です

## Step 2: Apple Services IDを作成する

1. Identifiersページでドロップダウンから**Services IDs**を選択します
2. \*\*+\*\*を選択して新しい識別子を登録します
3. **Services IDs**を選択し、**Continue**を選択します
4. 以下を入力します：
   * **Description**: Services IDの名前
   * **Identifier**: 一意の識別子（保存してください — これが**Services ID**です）
5. **Continue**を選択し、**Register**を選択します

### Services IDの設定

1. 新しく作成したServices IDを選択します
2. **Sign In with Apple**を有効にします
3. **Configure**を選択します
4. 以下を設定します：

   * **Primary App ID**: Step 1で作成したApp IDを選択
   * **Domains and Subdomains**: **Authペイン**の**Provider setup**に表示されている値をコピー（`https://`プロトコルプレフィックスなし）
   * **Return URLs**: **Authペイン**の**Provider setup**に表示されている値をコピー

   値の確認方法については[SSOプロバイダーのOAuth認証情報の設定](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)を参照してください。
5. **Next**、**Done**、**Continue**、**Save**を順に選択します

## Step 3: Appleプライベートキーを作成する

1. Apple Developerポータルのサイドバーで**Keys**を選択します
2. \*\*+\*\*を選択して新しいキーを登録します
3. **Key Name**を入力します
4. **Sign In with Apple**を有効にします
5. **Configure**を選択し、Step 1で作成したApp IDを選択します
6. **Save**、**Continue**、**Register**を順に選択します
7. **Key ID**を保存します
8. プライベートキーファイル（.p8）を**ダウンロード**します

<Warning>
  プライベートキーは一度しかダウンロードできません。安全に保管してください。再度ダウンロードすることはできません。
</Warning>

## Step 4: Apple プライベートメールリレーを設定する

AppleのHide My Email機能により、ユーザーは実際のメールアドレスを公開せずにサインインできます。これらのユーザーにメールを送信するには、メールソースを登録してください。

1. Apple Developerポータルのサイドバーで**Services**を選択します
2. **Sign in with Apple for Email Communication**の下で**Configure**を選択します
3. \*\*+\*\*を選択してEmail Sourceを追加します
4. **Authペイン**の**Provider setup**に表示されているEmail Source値を入力します
5. **Next**、**Register**、**Done**を順に選択します
6. DNS認証を待ちます（緑色のチェックアイコン）

<Info>
  一部の地域（中国、インド）では、Apple IDがメールではなく電話番号に関連付けられている場合があります。アプリがすべてのユーザーにメールを必要とする場合、これらの地域のユーザーのSign in with Appleが失敗する可能性があります。
</Info>

## トラブルシューティング

### 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の両方に追加します

## 追加リソース

* [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)