Login with Amazonに登録する
AndroidアプリでLogin with Amazonを使用するには、事前にアプリ登録が必要です。Login with Amazonのアプリ登録では、ビジネスに関する基本情報と、Login with Amazonと連携するウェブサイトやモバイルアプリの情報などが必要になります。このビジネス情報は、ユーザーが該当のウェブサイトやモバイルアプリでLogin with Amazonを使用するたびに表示されます。ユーザーに表示されるのは、アプリの名前、ロゴ、プライバシーポリシーへのリンクです。
- 新しいセキュリティプロファイルの作成
- Login with Amazon向け既存セキュリティプロファイルの有効化
- 登録済みアプリをセキュリティプロファイルに関連付ける方法
- セキュリティプロファイルへのAndroid設定の追加
- Androidアプリの署名と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が有効になりました」というメッセージが表示されます。
登録済みアプリをセキュリティプロファイルに関連付ける方法
既にhttps://developer.amazon.com/myapps.htmlでアプリを登録している場合は、セキュリティプロファイルに追加してLogin with Amazonでそれらを有効にすることができます。
または、この手順をスキップして、セキュリティプロファイルにAndroid設定を追加する手順に進むこともできます。
- https://developer.amazon.com/myapps.htmlにアクセスします。
- 一覧からアプリを選択します。[アプリの情報] タブが表示されます。
- 上部のタブで [Login with Amazon] をクリックします。
-
ドロップダウンメニューでセキュリティプロファイルを選択して、アプリと関連付けます。[確定] をクリックします。
セキュリティプロファイルへのAndroid設定の追加
開発者コンソールでセキュリティプロファイルを作成したら、そのプロファイルでLogin with Amazonを使用するウェブサイトやモバイルアプリの設定を追加することができます。AndroidでLogin with Amazonを有効にするには、アプリプロジェクトのパッケージ名と署名を指定する必要があります。Login with Amazonでは、これらの値を使用して、APIキーを生成します。APIキーによって、アプリはLogin with Amazon認可サービスにアクセスできるようになります。プロファイルにAndroid設定を追加する手順は次のとおりです。
- https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.htmlにアクセスします。
- アプリに使用するセキュリティプロファイルを選択します。
- 表から、変更するセキュリティプロファイルを選択します。
- [管理する] 列の
アイコンにカーソルを合わせます。
- [Kindle/Androidの設定] メニューアイテムを選択します。
注: 目的のセキュリティプロファイルが表にない場合は、Login with Amazonでまだ有効になっていないことを意味します。この場合、一覧の上にあるドロップダウンメニューから [セキュリティプロファイルを選択] を選択し、[確定] をクリックします。[プライバシー規約同意用URL] の入力は必須です。[セキュリティプロファイル用ロゴ画像] のアップロードは任意です。どちらもサインイン画面と同意画面に表示されます。アプリのセキュリティプロファイルをまだ作成していない場合は、セキュリティプロファイルを登録するを参照してください。
- Login with Amazonの認証でアプリが使用する [APIキー名] を入力します。これは、アプリの正式な名称である必要はありません。セキュリティプロファイルに登録されている複数のアプリやウェブサイトから、このAndroidアプリを識別するために使用されます。
- [パッケージ] を入力します。これは、Androidプロジェクトのパッケージ名と一致する必要があります。Androidプロジェクトのパッケージ名を確認するには、Android Studioでプロジェクトを開きます。[Project] ビューで
AndroidManifest.XML
をダブルクリックして、このファイルを開き、[Manifest] タブを選択します。最上部にパッケージ名が表示されます。 - アプリの [署名] を入力します。これには、アプリの検証に使用されるMD5とSHA-256ハッシュ値が含まれます。MD5の署名はコロンで区切られた16個の16進数ペアの形式(例:
01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef
)で、SHA-256の署名はコロンで区切られた32個の16進数ペアの形式(例:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef
)です。プロジェクトから署名を抽出する手順については、Androidアプリの署名とAPIキーを参照してください。 - [新しいキーを生成] をクリックします。
Androidアプリの署名とAPIキー
アプリの署名は、Androidアプリがビルドされるときに必ず適用されるハッシュ値です。AmazonではMD5とSHA-256のアプリ署名を使用してAPIキーを構成しています。APIキーによって、Amazonサービスはアプリを認識できます。プロジェクトにAPIキーを追加する方法については、Login with Amazonプロジェクトを作成するを参照してください。
アプリの署名はキーストアに保存されます。一般的なAndroidアプリには、デバッグ用のキーストアとリリース用のキーストアがあります。Android Studioでデバッグ用キーストアの場所を確認するには、[Build] メニューを開き、[Edit Build Types] を選択します。続いて [Signing] タブに移動し、[Store File] フィールドでデバッグ用キーストアを指定します。
リリース用キーストアは通常、Androidアプリをエクスポートして署名済みAPKファイルを生成するときに作成されます。エクスポートプロセス中に新しいリリース用キーストアを作成する場合は、その場所を選択します。デフォルトでは、デフォルトのデバッグ用キーストアと同じ場所に配置されます。
開発中にデバッグ署名を使用してアプリを登録した場合、アプリのリリース準備ができた段階で新しいAndroid設定をアプリに追加する必要があります。新しいアプリ設定ではリリース用キーストアからの署名を使用する必要があります。
詳細については、developer.android.comのアプリの署名に関するページを参照してください。
Androidアプリの署名の確認
- 署名済みAPKファイルの場合:
- APKファイルを解凍して、
CERT.RSA
を展開します(必要に応じてAPKの拡張子名をZIPに変更できます)。 -
コマンドラインから以下を実行します。
keytool -printcert -file CERT.RSA
keytool
は、Javaインストールのbin
ディレクトリにあります。
- APKファイルを解凍して、
- キーストアファイルの場合:
-
コマンドラインから以下を実行します。
keytool -list -v -alias <alias> -keystore <keystore.filename>
keytool
は、Javaインストールのbin
ディレクトリにあります。<alias>は、アプリの署名に使用されたキーの名前です。 -
キーのパスワードを入力し、Enterを押します。
-
- 証明書のフィンガープリントからMD5とSHA-256の値をコピーします。
Android APIキーの取得
Android設定を登録してアプリの署名を済ませたら、Login with Amazonアプリの登録ページからAPIキーを取得できます。そのAPIキーは、Androidプロジェクトのファイルに割り当てる必要があります。この作業を行わなければ、アプリには、Login with Amazon認可サービスと通信する権限が与えられません。
- https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.htmlにアクセスします。
- アプリに使用するセキュリティプロファイルを選択します。
- 表から、変更するセキュリティプロファイルを選択します。
- [管理する] 列の
アイコンにカーソルを合わせます。
- [Kindle/Androidの設定] メニューアイテムを選択します。
-
リストの [APIキー名] から該当するキーを選択し、[APIキー] 列の [表示] をクリックします。ポップアップウィンドウに表示されるAPIキーをコピーします。
注: APIキーには、生成時刻に基づいた情報が含まれています。したがって、その後に生成されるAPIキーは最初のキーと異なる場合があります。すべて有効であり、どのAPIキーでもアプリに使用できます。アイコンにカーソルを合わせて [編集] または [削除] を選択すると、キーの編集や削除ができます。誤ってキーを削除した場合は、[削除されたAPIキーを表示] をクリックし、復元したいキーの横にある [復元] をクリックすると元に戻せます。
- AndroidアプリにAPIキーを追加する手順については、プロジェクトにAPIキーを追加するを参照してください。
セキュリティプロファイルの削除
Amazonアプリストアを通じて配布するアプリに関連付けられていないセキュリティプロファイルは、必要に応じて削除できます。[セキュリティプロファイル管理] ページに移動し、プロファイルを選択して、[セキュリティプロファイルを削除] をクリックします。確認のウィンドウが表示されます。テキストフィールドに「削除」と入力し、[削除] をクリックして操作を確定します。
セキュリティプロファイルを誤って削除しても、[セキュリティプロファイル管理] ページから完全に復元できます。[削除されたセキュリティプロファイルを表示] ボタンをクリックし、復元したいプロファイルを選択して、[セキュリティプロファイルを復元] をクリックします。確認のウィンドウが表示されます。[復元] ボタンをクリックすると、ウェブ、Android/Kindle、iOSの各設定を含むセキュリティプロファイルを復元できます。