Login with Amazonに登録する
iOSアプリでLogin with Amazonを使用するには、事前にアプリ登録が必要です。Login with Amazonのアプリ登録では、ビジネスに関する基本情報と、Login with Amazonと連携するウェブサイトやモバイルアプリの情報などが必要になります。
このビジネス情報は、ユーザーが該当のウェブサイトやモバイルアプリでLogin with Amazonを使用するたびに表示されます。ユーザーに表示されるのは、アプリの名前、ロゴ、プライバシーポリシーへのリンクです。Login with AmazonにiOSアプリを登録する方法を、以下の手順に沿って説明します。
- 新しいセキュリティプロファイルを作成する
- Login with Amazonで既存のセキュリティプロファイルを有効にする
- セキュリティプロファイルにiOSアプリを追加する
- iOSバンドルIDとAPIキー
- セキュリティプロファイルを削除する
新しいセキュリティプロファイルを作成する
Amazon開発者コンソールでセキュリティプロファイルを作成済みの場合は、このセクションをスキップしてください。
-
https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.htmlにアクセスします。Login with Amazonのアプリ登録を行う開発者コンソールが表示され、ログインするよう求められます。開発者コンソールを初めて使用する場合は、アカウントをセットアップします。
-
[セキュリティプロファイルを新規作成] をクリックします。[セキュリティプロファイル管理] ページが表示されます。
-
[セキュリティプロファイル名] と [セキュリティプロファイルの説明] を入力します。セキュリティプロファイルによって、対象のアプリ(複数可)にユーザーのデータとセキュリティ認証情報が関連付けられます。[セキュリティプロファイル名] は、ユーザーがアプリとの情報共有に同意する際に同意画面に表示される名前です。この名前は、アプリの各バージョン(Android、iOS、ウェブサイト)に適用されます。
-
対象のアプリの [プライバシー規約同意用URL] を入力する必要があります。プライバシー通知URLは、会社またはアプリのプライバシーポリシーの場所(例:http://www.example.com/privacy.html)を示します。このリンクは、同意画面でユーザーに表示されます。これは、アプリの各バージョン(Android、iOS、ウェブサイト)に適用されます。
-
アプリに [セキュリティプロファイル用ロゴ画像] を追加する場合は、[画像のアップロード] をクリックします。このロゴはサインイン画面と同意画面に表示され、開発者のビジネスやウェブサイトを表します。これは、アプリの各バージョン(Android、iOS、ウェブサイト)に適用されます。ロゴの高さの上限は50ピクセルです。それより大きい場合は50ピクセルに縮小されます。ロゴの幅に制限はありません。
-
-
[保存] をクリックします。セキュリティプロファイルは次のように表示されます。
Login with Amazonで既存のセキュリティプロファイルを有効にする
上記の手順に従って新しいセキュリティプロファイルを作成した場合はこのセクションをスキップしてください。上記の手順を使用して作成したセキュリティプロファイルは既にLogin with Amazonで利用できるようになっています。
-
https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.htmlにアクセスします。開発者コンソールにログインするよう求められます。
-
[セキュリティプロファイルを選択] をクリックし、ドロップダウンメニューから対象のセキュリティプロファイルを選択します。
-
右に表示される [確定] ボタンをクリックします。
-
フォームが表示されるので、そこに同意画面の情報を入力してください。
-
対象のアプリの [プライバシー規約同意用URL] を入力する必要があります。プライバシー通知URLは、会社またはアプリのプライバシーポリシーの場所(例:http://www.example.com/privacy.html)を示します。このリンクは、同意画面でユーザーに表示されます。これは、アプリの各バージョン(Android、iOS、ウェブサイト)に適用されます。
-
アプリに [セキュリティプロファイル用ロゴ画像] を追加する場合は、[画像のアップロード] をクリックします。このロゴはサインイン画面と同意画面に表示され、開発者のビジネスやウェブサイトを表します。これは、アプリの各バージョン(Android、iOS、ウェブサイト)に適用されます。ロゴの高さの上限は50ピクセルです。それより大きい場合は50ピクセルに縮小されます。ロゴの幅に制限はありません。
-
[保存] をクリックします。画面がリフレッシュされ、[確定] ボタンの下に 「セキュリティプロファイルでLogin with Amazonが有効になりました」というメッセージが表示されます。
セキュリティプロファイルにiOSアプリを追加する
開発者コンソールでセキュリティプロファイルを作成したら、そのプロファイルでLogin with Amazonを使用するウェブサイトやモバイルアプリの設定を追加することができます。新しいiOSアプリを登録するには、アプリプロジェクトのパッケージ名と署名を指定する必要があります。Login with Amazonでは、これらの値を使用して、APIキーを生成します。APIキーによって、アプリはLogin with Amazon認可サービスにアクセスできるようになります。プロファイルにiOSアプリを追加する手順は次のとおりです。
- https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.htmlにアクセスします。
- アプリに使用するセキュリティプロファイルを選択します。
- 表から、変更するセキュリティプロファイルを選択します。
- [管理する] 列のアイコンにカーソルを合わせます。
- [iOS Settings] メニューアイテムを選択します。
注意: 目的のセキュリティプロファイルが表にない場合は、Login with Amazonでまだ有効になっていないことを意味します。この場合、一覧の上にあるドロップダウンメニューから [セキュリティプロファイルを選択] を選択し、[確定] をクリックします。[プライバシー規約同意用URL] の入力は必須です。[セキュリティプロファイル用ロゴ画像] のアップロードは任意です。どちらもサインイン画面と同意画面に表示されます。アプリのセキュリティプロファイルをまだ作成していない場合は、セキュリティプロファイルを登録するを参照してください。
- Login with Amazonの認証でアプリが使用する [APIキー名] を入力します。これは、アプリの正式な名称である必要はありません。セキュリティプロファイルに登録されている複数のアプリやウェブサイトから、このiOSアプリを識別するために使用されるものです。
- [Bundle ID] を入力します。これは、iOSプロジェクトのバンドル識別子と一致する必要があります。バンドル識別子を確認するには、Xcodeでプロジェクトを開きます。プロジェクトのプロパティリスト(
<project>-Info.plist
)をプロジェクトナビゲーターで開きます。バンドル識別子は、リストに表示されるプロパティの1つです。 - [新しいキーを生成] をクリックします。
アプリに複数のバージョン(複数のテスト版と1つの実稼働版など)があり、それぞれバンドルIDが異なる場合、各バージョンに固有のAPIキーが必要です。アプリの [iOS Settings] から [APIキーを追加] ボタンをクリックして、アプリのキーを新規に作成します(バージョンごとに1つ)。
iOSバンドルIDとAPIキー
バンドル識別子は、iOSアプリごとに一意に割り当てられます。Login with Amazonでは、バンドルIDを使用してAPIキーを作成します。APIキーによって、Login with Amazon認可サービスがアプリを認識できます。
iOSアプリのバンドル識別子を確認する
- Xcodeでアプリプロジェクトを開きます。
- プロジェクトの [Information Property List](
<project>-Info.plist
)をプロジェクトナビゲーターで開きます。 - プロパティのリストでバンドル識別子を確認します。
iOS APIキーを取得する
iOSアプリとセキュリティプロファイルを関連付けたら、セキュリティプロファイルの [iOS Settings] タブからAPIキーを取得できます。そのAPIキーをプロジェクトに配置します。この作業を行わなければ、アプリには、Login with Amazon認可サービスと通信する権限が与えられません。
- https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.htmlにアクセスします。
- アプリに使用するセキュリティプロファイルを選択します。
- 表から、変更するセキュリティプロファイルを選択します。
- [管理する] 列のアイコンにカーソルを合わせます。
- [iOS Settings] メニューアイテムを選択します。
-
リストの [APIキー名] から該当するキーを選択し、[APIキー] 列の [表示] をクリックします。ポップアップウィンドウに表示されるAPIキーをコピーします。
注意: APIキーには、生成時刻に基づいた情報が含まれています。したがって、その後に生成されるAPIキーは最初のキーと異なる場合があります。すべて有効であり、どのAPIキーでもアプリに使用できます。アイコンにカーソルを合わせて [編集] または [削除] を選択すると、キーの編集や削除ができます。誤ってキーを削除した場合は、[削除されたAPIキーを表示] をクリックし、復元したいキーの横にある [復元] をクリックすると元に戻せます。
- アプリにAPIキーを追加する手順については、アプリのプロパティリストにAPIキーを追加するを参照してください。
セキュリティプロファイルを削除する
Amazonアプリストアを通じて配布するアプリに関連付けられていないセキュリティプロファイルは、必要に応じて削除できます。[セキュリティプロファイル管理] ページに移動し、プロファイルを選択して、[セキュリティプロファイルを削除] をクリックします。確認のウィンドウが表示されます。テキストフィールドに「削除」と入力し、[削除] をクリックして操作を確定します。
セキュリティプロファイルを誤って削除しても、[セキュリティプロファイル管理] ページから完全に復元できます。[削除されたセキュリティプロファイルを表示] ボタンをクリックし、復元したいプロファイルを選択して、[セキュリティプロファイルを復元] をクリックします。確認のウィンドウが表示されます。[復元] ボタンをクリックすると、ウェブ、Android/Kindle、iOSの各設定を含むセキュリティプロファイルを復元できます。