# P8キーまたはP12証明書のセットアップ

## 前提条件

ユーザーを通知に登録し始めるには、P8 キー（推奨）または P12 証明書のいずれかが必要です。これらはいずれも Apple Developers ポータルで生成できます。

* 1つの [Apple Developer アカウント](https://developer.apple.com/account/) 管理者権限を持つ
* アプリケーションの App Bundle ID（例： `com.pushly.example`)
* Push Notifications 機能が追加された iOS アプリケーションまたは XCode プロジェクト

## P8キーの設定（推奨）

### ステップ1：キーを生成する

既存のP12証明書を更新するのでない場合は、通知送信用の認証に新しいP8キーを使用することを推奨します。P8キーは、すべてのアプリケーションと環境で使用できます。開発用と本番用、または各アプリケーションごとに個別のP8ファイルは必要ありません。

新しいP8キーを作成するには、 [Apple Developer アカウント](https://developer.apple.com/account/) に移動して、 `キー` リンクをクリックします。

<figure><img src="https://1832353165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2Fhr66nmrcH5k9oL8e59TU%2Fkeys.png?alt=media&#x26;token=4fff2cf6-6abd-44e0-88d5-18c8ed2976bd" alt=""><figcaption></figcaption></figure>

次のページで `+` ボタンを、次の項目の横にある `キー` ヘッダーをクリックします

P8キーの名前を入力します。会社名、アプリケーション名、または後で識別するのに役立つ任意の文字列を指定できます。

次に、 `Apple Push Notification service (APNs)` ボックスにチェックを入れ、 `続行` ボタンを押します。

<figure><img src="https://1832353165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2F1MikHTSIx0icOiCAaWJx%2Fcreate.png?alt=media&#x26;token=d57ce1af-94e1-445b-bc1b-bbb0a32eef50" alt=""><figcaption></figcaption></figure>

次のページで、以下に対して表示される値をコピーします `Key ID` そして、その後 `ダウンロード` ボタンをクリックしてP8キーをダウンロードします。

<figure><img src="https://1832353165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2FlZQkYbTrhXRRZERcCaec%2FScreenshot%202022-12-12%20at%204.10.09%20PM.png?alt=media&#x26;token=3ba39f9c-e7b6-473d-808a-b289075eb454" alt=""><figcaption></figcaption></figure>

必要な最後の情報は、 `Team ID` です。これはメンバーシップに関連付けられており、画面右上の名前の下にあります。

<figure><img src="https://1832353165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2FXFo3595GgoygzfAbErcN%2FScreenshot%202022-12-12%20at%204.19.50%20PM.png?alt=media&#x26;token=24947664-83c3-4817-976e-33cbe23f9963" alt=""><figcaption></figcaption></figure>

### ステップ2：Pushlyで統合を有効にする

これで、 `Team ID`, `Key ID` とP8キーが揃ったので、Pushlyプラットフォームにログインし、 `設定` ページに移動して、 `送信インテグレーション` セクションから取得します。

に移動します。ここで、 `編集` ボタンを `Send Integration` ヘッダーで、 `Native` スイッチを `Apple` 見出しの下で有効にして、

1. を選択します `P8 Cert` ピル選択から
2. 証明書エリアをクリックしてP8キーをアップロードします
3. を入力 `Team ID`
4. を入力 `Key ID`
5. 次をクリックします `送信` ボタン

<figure><img src="https://1832353165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2FzISEeeHVthIJ2AVhffo5%2FScreenshot%202023-02-01%20at%209.29.20%20AM.png?alt=media&#x26;token=2a1e22e1-3c51-435c-8f39-8e20a9a8a65e" alt=""><figcaption></figcaption></figure>

すべて正しく入力されていれば、今すぐ `送信インテグレーション` アクティブなApple Native統合が表示されます。

<figure><img src="https://1832353165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2Fnwbudz0lLpKSXyWiK5Eo%2FScreenshot%202023-02-01%20at%209.27.22%20AM.png?alt=media&#x26;token=b86668f2-c739-4630-a063-629a7c78bc7f" alt=""><figcaption></figcaption></figure>

## P12証明書の設定

P8キーの使用を優先するため、新しいP12証明書の作成は推奨しません。既存のP12証明書がある場合は、以下の手順に従って更新し、プラットフォームに追加してください。

### 手順1：証明書署名要求（CSR）を作成する

1. Macコンピュータで、を開きます `キーチェーンアクセス` アプリケーション
2. 内の `キーチェーンアクセス` メインのアプリケーションメニューで、 `キーチェーンアクセス` > `証明書アシスタント` > `認証局から証明書を要求する`
3. ［証明書情報］ウィンドウで、次の情報を入力します:
   * 「 `ユーザーのメールアドレス` 」欄に、メールアドレスを入力します。
   * 「 `コモンネーム` 」欄に、秘密鍵の名前を作成します（例: 会社名 Web Push）。
   * 「 `CAメールアドレス` 」欄は空欄のままにしてください。
   * 「 `リクエスト` グループを選択し、 `ディスクに保存済み` オプション。
4. クリック `続行` Keychain Access内でCSRをディスクに保存して、この手順を完了してください。

### ステップ2：アプリの識別子を作成する

{% hint style="danger" %}
既存の証明書を更新する場合は、App IdentifierはすでにAppleの開発者アカウント内に存在しているはずなので、この手順はスキップしてステップ3に進めます。
{% endhint %}

1. [ログイン](https://developer.apple.com/account/ios/certificate/) あなたの会社の Apple Developer Console アカウントへ。
2. をクリックします `識別子` の下にあるリンク `Certificates, Identifiers & Profiles`
3. 右上のドロップダウンで `App IDs` が選択されていることを確認し、 `+` ボタンを、次の項目の横にある `識別子` ヘッダー。
4. を選択します `App IDs` オプションの一覧から選択し、 `続行` ボタンを押します。
5. を選択します `App` を識別子の種類として選び、 `続行` ボタン
6. 説明を入力します。例: `YOUR_APP_NAME Push Notifications`
7. アプリのBundle IDを入力します。例：  `com.YOUR_APP_NAME.app-push`
8. の下で `Capabilities` タブを下にスクロールして、 `Push Notifications` 機能
9. 次をクリックします `続行` その後 `登録` ボタンを押します。

### ステップ3: Webプッシュ証明書を生成する

1. をクリックします `証明書` 左側のナビゲーションで次を押します `+` の横にある記号 `証明書` ヘッダーをクリックします
2. を選択します `Apple Push Notification service SSL (Sandbox & Production)` をサービス一覧から選択し、次に `続行`.
3. 証明書を生成するアプリケーションに対応するApp Identifierを選択し、 `続行` ボタンを押します。
4. 次をクリックします `ファイルを選択` ボタンを押し、最初のステップで作成したCSRファイルを参照して、クリックします `続行`.
5. 次の画面で、証明書の準備ができたことが通知されます。クリックします `ダウンロード` 証明書をコンピューターに保存します。

### ステップ4: .p12証明書を生成する

* コンピューターに保存した証明書に移動し、ダブルクリックして次にインストールします `キーチェーンアクセス` アプリケーション。
* 次を開きます `キーチェーンアクセス` アプリケーションを開き、 `My Certificates` タブで、 `ログイン` 左側のナビゲーション領域でキーチェーンが選択されていることを確認します。
* インストール済みのApple Push Services証明書を右クリックして、 `書き出す`.
* 保存ダイアログで、ファイル名を選択し（またはデフォルトのままにし）、次を選択します `.p12` ファイル形式を選択し、次をクリックします `保存` ボタンを押します。
* パスワードの入力を求められます。両方のボックスを空のままにして、次をクリックします `OK`.
* クリック `許可` p12証明書をコンピューターに保存します。

### ステップ5: プラットフォーム経由で証明書をアップロードする

これで、 `Bundle ID` とP12証明書があれば、Pushlyプラットフォームにログインし、 `設定` ページに移動して、 `送信インテグレーション` セクションから取得します。

に移動します。ここで、 `編集` ボタンを `Send Integration` ヘッダーで、 `Native` スイッチを `Apple` 見出しの下で有効にして、

1. アプリケーションの `Bundle ID`
2. を選択します `P12 Cert` ピル選択から
3. エリアをクリックしてP12証明書をアップロードします
4. 証明書の生成時にパスフレーズを入力した場合は、スイッチを有効にしてそれを追加します
5. 次をクリックします `送信` ボタン


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.pushly.com/pushly-ja/integration/implementation-steps/apple-ios/p8kmatahap12nosettoappu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.