XenMobile Server

APNs証明書

重要:

APNsの従来のバイナリプロトコルに対するAppleのサポートは、2021年3月31日で終了します。代わりにHTTP/2ベースのAPNプロバイダーAPIの使用をお勧めします。リリース10.13.0以降、XenMobile Serverは HTTP/2ベースのAPIをサポートしています。詳しくは、https://developer.apple.com/のニュースとアップデートで「Apple Push Notification Serviceのアップデート」を参照してください。APNsへの接続を確認する方法については、「接続確認」を参照してください。

XenMobileでiOSおよびmacOSデバイスを登録して管理するには、AppleのAppleプッシュ通知サービス(APNs)証明書を設定します。

ワークフローの概要:

証明書署名要求の作成

macOSでキーチェーンアクセスを使用してCSRを作成することをお勧めします。Microsoft IISまたはOpenSSLを使用してCSRを作成することもできます。

重要:

  • 証明書の作成に使用されたApple IDについて:
    • The Apple ID must be a corporate ID and not a personal ID.
    • Record the Apple ID that you use to create the certificate.
    • To renew your certificate, use the same organization name and Apple ID. Using a different Apple ID to renew the certificate require device re-enrollment.
  • 証明書を失効させると、過失であっても故意であっても、デバイスを管理できなくなります。

  • iOS Developer Enterprise Programを使用してMobile Device Managerプッシュ証明書を作成した場合:Apple Push Certificates Portalに移行した証明書に必要なアクションを実行してください。

macOSでキーチェーンアクセスを使用するCSRの作成

  1. macOSを実行するコンピューターの [アプリケーション]>[ユーティリティ] で、キーチェーンアクセスアプリを起動します。
  2. [キーチェーンアクセス] メニューで、[証明書アシスタント]>[認証局に証明書を要求] の順に選択します。
  3. 証明書アシスタントにより、次の情報の入力を求められます:
    • メールアドレス: 証明書の管理を担当する個人または役割アカウントのメールアドレス。
    • 共通名: 証明書の管理を担当する個人または役割アカウントの通称。
    • CAのメールアドレス: 認証局のメールアドレス。
  4. [ディスクに保存] をクリックし、[鍵ペア情報を指定] チェックボックスをオンにして、[続ける] をクリックします。
  5. CSRファイルの名前を入力してコンピューターにファイルを保存し、[保存] を選択します。
  6. 鍵ペア情報を指定:[鍵のサイズ] で[2048ビット]を選択し、アルゴリズムに [RSA] を選択してから [続ける] をクリックします。APNs証明書プロセスの一環としてCSRファイルをアップロードする準備ができました。
  7. 証明書アシスタンスによるCSRプロセスが完了してから [完了] をクリックします。
  8. 続行するには、CSRに署名します

Microsoft IISを使用するCSRの作成

APNs証明書要求を生成するには、まずCSR(証明書署名要求)を作成します。Windowsの場合は、Microsoft IISを使用してCSRを生成します。

  1. Microsoft IISを開きます。
  2. IISのサーバー証明書アイコンをクリックします。
  3. [サーバー証明書] ウィンドウで、[証明書の要求の作成] をクリックします。
  4. 適切な識別名(Distinguished Name:DN)を入力して [次へ] をクリックします。
  5. [暗号化サービスプロバイダー]で [Microsoft RSA SChannel Cryptographic Provider] を選択して、ビット長として [2048] を選択し、[次へ] をクリックします。
  6. ファイル名を入力してCSRを保存する場所を指定し、[完了] をクリックします。
  7. 続行するには、CSRに署名します

OpenSSLを使用するCSRの作成

macOSデバイスまたはMicrosoft IISを使用してCSRを生成できない場合は、OpenSSLを使用します。OpenSSLは、OpenSSLのWebサイトからダウンロードしてインストールできます。

  1. OpenSSLをインストールしたコンピューターで、コマンドプロンプトまたはシェルから次のコマンドを実行します。

    openssl req -new -keyout Customer.key.pem –out CompanyAPNScertificate.csr -newkey rsa:2048

  2. 証明書の名前に関する次のメッセージが表示されます。要求された情報を入力します。

    You are about to be asked to enter information that will be incorporated into your certificate request.
    What you are about to enter is what is called a Distinguished Name or a DN.
    There are quite a few fields but you can leave some blank
    For some fields there will be a default value,
    If you enter '.', the field will be left blank.
    -----
    Country Name (2 letter code) [AU]:US
    State or Province Name (full name) [Some-State]:CA
    Locality Name (eg, city) []:RWC
    Organization Name (eg, company) [Internet Widgits Pty Ltd]:Customer
    Organizational Unit Name (eg, section) [:Marketing
    Common Name (eg, YOUR name) []:John Doe
    Email Address []:john.doe@customer.com
    <!--NeedCopy-->
    
  3. 次のメッセージが表示されたら、CSRの秘密キーのパスワードを入力します。

    Please enter the following 'extra' attributes
    to be sent with your certificate request
    A challenge password []:
    An optional company name []:
    <!--NeedCopy-->
    
  4. 続行するには、次のセクションの説明に従って、CSRに署名します。

CSRへの署名

XenMobileで証明書を使用するには、署名のために証明書をCitrixに送信します。Citrixはモバイルデバイス管理の署名証明書を使用して署名し、.plist形式の署名ファイルを返送します。

  1. 使用しているブラウザーでEndpoint ManagementツールWebサイトに移動し、[Request push notificationcertificate signature] を選択します。

    Endpoint Managementツールページ

  2. 新しい証明書の作成ページで、[Upload the CSR] を選択します。

    [Upload CSR]オプション

  3. 証明書に移動して選択します。

    証明書は「.pem/txt」形式である必要があります。

  4. Endpoint Management APNs CSR署名ページで、[署名] をクリックします。CSRが署名されて、構成されているダウンロードフォルダーに自動的に保存されます。

  5. 続行するには、次のセクションの説明に従って、署名入りCSRを送信します。

署名入りCSRのAppleへの送信とAPNs証明書の取得

署名入りCSR(Certificate Signing Request:証明書署名要求)をCitrixから受け取ったら、そのCSRをAppleに送信して、XenMobileへのインポートに必要なAPNs証明書を取得します。

注:

一部のユーザーから、Apple Push Portalへのログイン時の問題が報告されています。この場合、Apple Developer Portalにログオンしてから、次の手順に従います。

  1. ブラウザーでApple Push Certificates Portalに移動します。

  2. [証明書識別情報を作成] をクリックします。

  3. Appleで初めて証明書を作成する場合:[利用規約を読みました。内容に同意します。] チェックボックスをオンにして、[同意します] をクリックします。

  4. [ファイルの選択] をクリックし、コンピューター上の署名入りCSRを指定して [アップロード] をクリックします。アップロードが成功したことを示す確認メッセージが表示されます。

  5. [ダウンロード] をクリックして、.pem証明書を取得します。

  6. 続行するには、CSRを完了し、次のセクションの説明に従って、PKCS #12ファイルをエクスポートします。

CSRの完了とPKCS #12ファイルのエクスポート

AppleからAPNs証明書を受け取ったら、キーチェーンアクセス、Microsoft IIS、またはOpenSSLに戻り、証明書をPCKS #12ファイルにエクスポートします。

PKCS #12ファイルには、APNs証明書ファイルと秘密キーが含まれています。通常、PFXファイルの拡張子は.pfxまたは.p12です。.pfxファイルと.p12ファイルは、交換して使用できます。

重要:

Citrixは、個人キーと公開キーを保存するか、ローカルシステムからエクスポートすることをお勧めします。これらのキーは、再利用するためにAPNs証明書にアクセスするときに必要です。同じキーがないと、証明書は無効になり、CSRとAPNsのプロセス全体を繰り返す必要があります。

macOSでキーチェーンアクセスを使用するPKCS #12ファイルの作成

重要:

このタスクには、CSRを生成するために使用したのと同じmacOSデバイスを使用します。

  1. このデバイスで、Appleから受け取ったProduction identity(.pem)証明書を検索します。

  2. キーチェーンアクセスアプリケーションを起動し、[ログイン]>[自分の証明書] タブに移動します。Product identity証明書をドラッグして、開いているウィンドウにドロップします。

  3. 証明書をクリックし、左矢印を展開して、証明書に関連する秘密キーが含まれていることを確認します。

  4. PCKS #12(.pfx)証明書への証明書のエクスポートを開始するには、証明書と秘密キーを選択して右クリックし、[2項目を書き出す] を選択します。

  5. XenMobileで使用するには、証明書ファイルに一意の名前を付けるようにします。名前に空白や特殊文字は含めないでください。次に、保存する証明書のフォルダーの場所を選び、.pfxファイル形式を選択して [保存] をクリックします。

  6. パスワードを入力して証明書をエクスポートします。Citrixでは一意で強力なパスワードを使用することをお勧めします。また、後で使用および参照するために証明書とパスワードを安全に保管するようにします。

  7. キーチェーンアクセスアプリによって、ログインパスワードまたは選択したキーチェーンを確認するメッセージが表示されます。パスワードを入力し、[OK] をクリックします。XenMobile Serverで保存された証明書を使用する準備ができました。

  8. 続行するには、「APNs証明書をXenMobileにインポートする」を参照してください。

Microsoft IISを使用するPKCS #12ファイルの作成

重要:

このタスクには、CSRを生成するために使用したのと同じIISサーバーを使用します。

  1. Microsoft IISを開きます。

  2. サーバー証明書アイコンをクリックします。

  3. [サーバー証明書] ウィンドウで、[証明書の要求の完了] をクリックします。

  4. AppleのCertificate.pemファイルを指定します。フレンドリ名または証明書名を入力して [OK] をクリックします。名前に空白や特殊文字は含めないでください。

  5. 手順4で指定した証明書を選択して [エクスポート] をクリックします。

  6. .pfx証明書の場所とファイル名およびパスワードを指定して [OK] をクリックします。

    XenMobileにインポートするには、証明書のパスワードが必要です。

  7. .pfx証明書をXenMobileをインストールするサーバーにコピーします。

  8. 続行するには、「APNs証明書をXenMobileにインポートする」を参照してください。

OpenSSLを使用するPKCS #12ファイルの作成

OpenSSLを使用してCSRを作成する場合、OpenSSLを使用して.pfx APNs証明書を作成することもできます。

  1. コマンドプロンプトまたはシェルで、次のコマンドを実行します。Customer.privatekey.pemはCSRからの秘密キー、APNs_Certificate.pemはAppleから受け取った証明書です。

    openssl pkcs12 -export -in APNs_Certificate.pem -inkey Customer.privatekey.pem -out apns_identity.pfx

  2. .pfx証明書ファイルのパスワードを入力します。このパスワードは、証明書をXenMobileにアップロードするときに再び使用するので覚えておいてください。

  3. .pfx証明書ファイルの場所を確認します。次に、XenMobileコンソールを使用してアップロードできるようにXenMobile Serverにコピーします。

  4. 続行するには、次のセクションの説明に従って、APNs証明書をXenMobileにインポートします。

APNs証明書をXenMobileにインポートする

新しいAPNs証明書を受け取った後:そのAPN証明書をXenMobileにインポートして、最初の証明書として追加するか、既存の証明書を置き換えます。

  1. XenMobileコンソールで、[設定]>[証明書] の順にクリックします。

  2. [インポート]>[キーストア] の順にクリックします。

  3. [使用目的] から、[APNs] を選択します。

  4. コンピューターの.pfxファイルまたは.p12ファイルを指定します。

  5. パスワードを入力して、[インポート] をクリックします。

XenMobileの証明書について詳しくは、「証明書と認証」を参照してください。

APNs証明書の更新

重要:

更新処理に別のApple IDを使用する場合、ユーザーのデバイスを再登録する必要があります。

APNs証明書を更新するには、証明書を作成する手順を実行してから、Apple Push Certificates Portalにアクセスします。このポータルを使用して、新しい証明書をアップロードします。ログオンすると、既存の証明書(または、前のApple Developersアカウントからインポートされた証明書)が表示されます。

証明書を更新する場合は、証明書を作成する場合との唯一の違いとして、Certificates Portalで [更新] をクリックします。Certificates Portalにアクセスするには、このサイトの開発者アカウントが必要です。証明書を更新するには、同じ組織名とApple IDを使用します。

APNs証明書の有効期限を調べるには、XenMobileコンソールで [設定]>[証明書] の順にクリックします。証明書の有効期限が切れた場合、その証明書を取り消さないでください。

  1. Microsoft IIS、キーチェーンアクセス(macOS)、またはOpenSSLを使用してCSRを生成します。CSRの生成について詳しくは、「証明書署名要求の作成」を参照してください。

  2. ブラウザーで、Endpoint Managementツールに移動します。次に、[プッシュ通知証明書の署名要求]を選択します。

  3. [+ Upload the CSR] をクリックします。

  4. ダイアログボックスでCSRに移動し、[開く][署名] の順にクリックします。

  5. .plistファイルを受信したら保存します。

  6. 手順3のページで、Apple Push Certificates Portalをクリックしてサインオンします。

  7. 更新する証明書を選択して [更新] をクリックします。

  8. .plistファイルをアップロードします。出力として.pemファイルを受信します。.pemファイルを保存します。

  9. この.pemファイルを使用し、(手順1でCSRを作成するために使用した方法に従って)CSRを完了します。

  10. 証明書を.pfxファイルとしてエクスポートします。

XenMobileコンソールで.pfxファイルをインポートし、以下の手順を実行して構成を完了します:

  1. [設定]>[証明書]>[インポート] の順に選択します。
  2. [インポート] メニューから、[キーストア] を選択します。
  3. [キーストアの種類] メニューから、[PKCS#12] を選択します。
  4. [使用目的] から、[APNs] を選択します。

    証明書の[インポート]ダイアログボックス

  5. [キーストアファイル] では、[ブラウザー] をクリックしてファイルに移動します。
  6. [パスワード] ボックスに、証明書のパスワードを入力します。
  7. 必要に応じて [説明] に入力します。
  8. [インポート] をクリックします。

XenMobileで [証明書] ページにリダイレクトされます。[名前][状態][有効期限開始]、および [有効期限終了] フィールドが更新されます。

APNs証明書