Apple ID 認証

Apple でサインインをアプリに追加

この機能を使用するには、アプリが Appleでサインインの権限を持っている必要があります。

1. Xcode でアプリのターゲットを選択します。

2. [Signing & Capabilities] タブに移動して、[+ Capability] をクリックします。

3. Sign in with Apple（Appleでサインイン）機能を検索し、選択します。

次に、Apple Developer Portal で有効になっていることを確認します。

1. Apple Developer Portal の Certificates, Identifiers and Profiles ページに移動します。

2. ドロップダウンからアプリの ID を選択します。そうすると、[App ID Configuration] ペインが表示されます。

3. [Sign In with Apple] のチェックボックスが表示されるまで下にスクロールします。チェックボックスが選択されていない場合は、選択します。変更を加えた場合は、[Save] ボタンを押します。

アプリの Bundle ID を書き留めておきます。Bundle ID は、クライアントシークレットを作成するときと、Atlas App Services で Apple でサインインを設定するときに必要になります。

秘密キーの作成

Apple でサインインのクライアントシークレットは、 秘密キーを使用して作成、署名する JSON Web Token です。Apple Developer Portal で秘密キーを生成する必要があります。

1. 左側のナビゲーション メニューで [ Keysをクリックします。

2. [Keys] の横にある青いプラスアイコンをクリックします。

3. [Register a New Key] ページで、わかりやすい [Key Name] を入力し、下にスクロールして [Sign in with Apple] の行を見つけます。[Sign in with Apple（Appleでサインイン）] のチェックボックスをオンにして機能を有効にし、[Configure] をクリックします。

4. [Configure Key] ページで、アプリのアプリケーションID を [Primary App ID] として選択し、[Save] をクリックします。

5. [Continue] をクリックして、キーの設定を確認します。キーが正しく設定されたことを確認したら、[Register] をクリックします。

6. 後でアクセスできるように Key ID の値をコピーし、[Download] をクリックしてキーを .p8 テキスト ファイルとしてダウンロードします。この値とテキスト ファイルを、クライアントシークレットの生成に使用します。

   重要

   キーの保存

   キーは 1 回だけダウンロードできます。再度必要になった場合に備えて、キーを安全な場所に保存しておいてください。キーを紛失した場合は、新しいキーを生成する必要があります。

クライアント シークレット JWT の作成

Apple ID 認証プロバイダーのクライアント シークレット JWT を作成できるようになりました。次の情報があることを確認してください。

• アプリの Bundle ID。これを以下のスクリプトの client_id として使用します。

• 作成したキーの Key ID と、そのキーを含む .p8 ファイル。

• あなたの Apple チーム ID。これは、Apple Developer Portal の右上にあります。

必要な情報がすべて揃っていることを確認したら、スクリプトを使用して JWT を生成できます。独自のスクリプトを定義することも、このステップのスクリプトを使用することもできます。

JWT を生成するには、JWT gem を使用します。JWT gem をインストールするには、次のコマンドを実行します。

gem install jwt

generate_client_secret.rb という新しいファイルを作成し、次のコード ブロックをファイルにコピーします。

# Source: https://developer.okta.com/blog/2019/06/04/what-the-heck-is-sign-in-with-apple
require 'jwt'
# Update these values with your app's information
team_id = '<Apple Team ID>'
client_id = '<Bundle ID or Services ID>'
key_id = '<Apple Key ID>'
key_file = '<Key File Path>'
# Define the JWT's headers and claims
headers = {
  # The token must be signed with your key
  'kid' => key_id
}
claims = {
  # The token is issued by your Apple team
  'iss' => team_id,
  # The token applies to Apple ID authentication
  'aud' => 'https://appleid.apple.com',
  # The token is scoped to your application
  'sub' => client_id,
  # The token is valid immediately
  'iat' => Time.now.to_i,
  # The token expires in 6 months (maximum allowed)
  'exp' => Time.now.to_i + 86400*180,
}
# Read in the key and generate the JWT
ecdsa_key = OpenSSL::PKey::EC.new IO.read key_file
token = JWT.encode claims, ecdsa_key, 'ES256', headers
# Print the JWT to stdout
puts token

team_id、client_id、key_id、key_file の値をアプリケーションの情報と一致するように更新し、ファイルを保存します。JWT を生成する準備ができたら、シェルでスクリプトを実行します。

ruby generate_client_secret.rb >> client_secret.txt

Atlas App Services でのプロバイダーの設定

この時点で、Apple アプリケーションを設定し、必要な OAuth 2.0 の認証情報を生成しました。これで、Atlas App Services クライアント アプリケーション ユーザーがログインできるように、Apple ID 認証プロバイダーを設定できます。

{
  "oauth2-apple": {
     "name": "oauth2-apple",
     "type": "oauth2-apple",
     "disabled": <boolean>,
     "config": {
        "clientId": "<Bundle ID>"
     },
     "secret_config": {
        "clientSecret": "<Secret Name>"
     },
     "redirect_uris": ["<string>", ...]
  }
}

appservices push

git add ./auth/providers.json
git commit -m "Configure and Enable Apple ID Authentication"
git push origin <branch name>

アプリ ID の作成

Apple の App ID はユーザーのアプリケーションを表します。また、App ID を使用して Sign in with Apple などのサービスにアクセスできます。Apple ID プロバイダーを構成するには、新しい App ID を作成する必要があります。

1. Apple Developer Portal の Certificates, Identifiers and Profiles ページに移動します。

2. 左側のナビゲーション メニューで [ Identifiersをクリックします。

3. [Identifiers] の横にある青いプラスアイコンをクリックします。

4. Register a New Identifier ページで、[App IDs]、[Continue] の順にクリックします。

5. Register an App ID ページでアプリを実行する Platform を選択した後、簡単な Description と逆 DNS 表記 Bundle ID を入力します。

6. 「Sign in with Apple」の機能が表示されるまで、「Register an App ID」 ページを下にスクロールします。チェックボックスをオンにすると、この機能が有効になります。

7. ページ上部の [Continue] ボタンを押します。アプリに適用されるその他の設定手順を完了し、[Register] ボタンを押します。

サービス ID の作成

Apple Services ID は、1つのアプリケーションを表しており、これにより承認コールバック URL を設定し、アプリケーションの秘密キーを定義できます。

1. 左側のナビゲーション メニューで [ Identifiersをクリックします。

2. [Identifiers] の横にある青いプラスアイコンをクリックします。

3. Register a New Identifier ページで、[Services IDs]、[Continue] の順にクリックします。

4. 「Register a Services ID」ページでの、簡単なDescription と逆 DNS 表記 Identifier の入力。

   重要

   識別子の保存

   サービス ID のIdentifier値は、アプリケーションのClient IDです。この値は、後でAtlas App Services で Apple ID プロバイダーを設定する際に必要になります。

   [Continue] ボタンを押します。詳細を確認し、[Register] をクリックします。

5. 作成したサービスをクリックします。チェックボックスをオンにして [Sign in with Apple] を有効にし、[Configure] をクリックします。作成したアプリケーション ID を Primary App ID として選択します。

6. サービス ID のドメイン、サブドメイン、リターン URL を入力します。[Next] ボタンを押します。

7. [Continue] をクリックし、[Save] をクリックします。サービス ID が正しく設定されていることを確認して、[Register] をクリックします。

秘密キーの作成

Apple でサインインのクライアントシークレットは、 秘密キーを使用して作成、署名する JSON Web Token です。Apple Developer Portal で秘密キーを生成する必要があります。

1. 左側のナビゲーション メニューで [ Keysをクリックします。

2. [Keys] の横にある青いプラスアイコンをクリックします。

3. [Register a New Key] ページで、わかりやすい [Key Name] を入力し、下にスクロールして [Sign in with Apple] の行を見つけます。[Sign in with Apple（Appleでサインイン）] のチェックボックスをオンにして機能を有効にし、[Configure] をクリックします。

4. 「Configure Key」ページで、「 Primary App ID」として作成したアプリ ID を選択し、[ Save] をクリックします。

   

5. [Continue] をクリックして、キーの設定を確認します。キーが正しく設定されたことを確認したら、[Register] をクリックします。

6. 後でアクセスできるように Key ID の値をコピーし、[Download] をクリックしてキーを .p8 テキストファイルとしてダウンロードします。これらはクライアントシークレットの生成に使用します。

   重要

   キーの保存

   キーは 1 回だけダウンロードできます。再度必要になった場合に備えて、キーを安全な場所に保存しておいてください。キーを紛失した場合は、新しいキーを生成する必要があります。

クライアント シークレット JWT の作成

Apple ID 認証プロバイダーのクライアント シークレット JWT を作成できるようになりました。次の情報があることを確認してください。

• 作成された Services ID。これを以下のスクリプトの client_id として使用します。

• 作成したキーの Key ID とキーを含む .p8

  ファイル。

• あなたの Apple チーム ID。これは Apple Developer Portal の

  右上にあります。

必要な情報がすべて揃っていることを確認したら、スクリプトを使用して JWT を生成できます。独自のスクリプトを定義することも、このステップのスクリプトを使用することもできます。

JWT を生成するには、JWT gem を使用します。JWT gem をインストールするには、次のコマンドを実行します。

gem install jwt

generate_client_secret.rb という新しいファイルを作成し、次のコード ブロックをファイルにコピーします。

# Source: https://developer.okta.com/blog/2019/06/04/what-the-heck-is-sign-in-with-apple
require 'jwt'
# Update these values with your app's information
team_id = '<Apple Team ID>'
client_id = '<Bundle ID or Services ID>'
key_id = '<Apple Key ID>'
key_file = '<Key File Path>'
# Define the JWT's headers and claims
headers = {
  # The token must be signed with your key
  'kid' => key_id
}
claims = {
  # The token is issued by your Apple team
  'iss' => team_id,
  # The token applies to Apple ID authentication
  'aud' => 'https://appleid.apple.com',
  # The token is scoped to your application
  'sub' => client_id,
  # The token is valid immediately
  'iat' => Time.now.to_i,
  # The token expires in 6 months (maximum allowed)
  'exp' => Time.now.to_i + 86400*180,
}
# Read in the key and generate the JWT
ecdsa_key = OpenSSL::PKey::EC.new IO.read key_file
token = JWT.encode claims, ecdsa_key, 'ES256', headers
# Print the JWT to stdout
puts token

team_id、client_id、key_id、key_file の値をアプリケーションの情報と一致するように更新し、ファイルを保存します。JWT を生成する準備ができたら、シェルでスクリプトを実行します。

ruby generate_client_secret.rb >> client_secret.txt

Atlas App Services でのプロバイダーの設定

この時点で、Apple アプリケーションを設定し、必要な OAuth 2.0 の認証情報を生成しました。これで、Atlas App Services クライアント アプリケーション ユーザーがログインできるように、Apple ID 認証プロバイダーを設定できます。

{
  "oauth2-apple": {
     "name": "oauth2-apple",
     "type": "oauth2-apple",
     "disabled": <boolean>,
     "config": {
        "clientId": "<Apple Services ID>"
     },
     "secret_config": {
        "clientSecret": "<Secret Name>"
     },
     "redirect_uris": ["<string>", ...]
  }
}

appservices push

git add ./auth/providers.json
git commit -m "Configure and Enable Apple ID Authentication"
git push origin <branch name>