# 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. 次をクリックします `送信` ボタン