Register Your Login with Amazon Application
In the App Console register a new application by clicking the Register new Application button. The Register Your Application form will appear:
Note: You will be redirected to Seller Central, which handles application registration for Login with Amazon. If this is your first time using Seller Central, you will be asked to setup a Seller Central account.
- In the Register Your Application form, enter a Name and a Description for your application.
The Name is the name displayed on the consent screen when users agree to share information with your application.
This name applies to Android, iOS, and website versions of your application.
- Enter a Privacy Notice URL for your application.
- If you want to add a Logo Image for your application, click Browse and locate the applicable image.
This logo is displayed on the sign-in and consent screen to represent your business or website. The logo will be shrunk to 50 pixels in height if it is taller than 50 pixels; there is no limitation on the width of the logo.
Click Save. Your sample registration should look similar to this:
After your basic application settings are saved, you can add settings for specific websites and mobile apps that will use this Login with Amazon account.
After your basic application settings are saved, you can add settings for specific websites and mobile apps that will use Login with Amazon.
To register an iOS App, you have to specify the Bundle identifier for the app project. Login with Amazon will use the bundle ID to generate an API key. The API key will grant your app access to the Login with Amazon authorization service. Follow these steps to add an iOS app to your account:
From the Application screen, click iOS Settings. If you already have an iOS app registered, look
for the Add API Key button in the iOS Settings section.
The iOS Application Details form will appear:
- Enter the Label of your iOS App.
This does not have to be the official name of your app. It simply identifies this particular iOS app
among the apps and websites registered to your Login with Amazon application.
- Enter your Bundle ID. This must match the bundle identifier of your iOS project.
To determine your bundle identifier,
open the project in Xcode. Open the properties list for the project (
<project>-Info.plist) in the Project Navigator. The Bundle
identifier is one of the properties in the list.
- Click Save.
If different versions of your app have different bundle IDs, such as for one or more testing versions and a production version, each version requires its own API Key. From the iOS Settings of your app, click the Add API Key button to create additional keys for your app (one per version).
iOS Bundle ID and API Keys
The Bundle identifier is unique to every iOS app. Login with Amazon uses the Bundle ID to construct your API Key. The API
Key enables the Login with Amazon authorization service to recognize your app.
Determine a Bundle Identifier for an iOS App
- Open your app project in Xcode.
- Open the Information Property List for the project (
<project>-Info.plist) in the Project Navigator.
- Find Bundle identifier in the list of properties.
Retrieve an iOS API Key
After you have registered an iOS version and provided a Bundle ID, you can retrieve the API key from the registration page for your Login with Amazon application. You will need to place that API key into your project's property list. Until you do, the app will not be authorized to communicate with the Login with Amazon authorization service.
- Click App Console above.
- In the Apps box, click your application.
- Find your iOS app under the iOS Settings section. If you have not registered an iOS app, see Add iOS Settings to an Application.
- Click Generate API Key Value.
A popup window will display your API key. To copy the key, click Select All to select the entire
Note:The API Key value is based, in part, on the time it is generated. Thus, subsequent API Key value(s) you generate may differ from the original. You can use any of these API Key values in your app as they are all valid.
- See "Add Your API Key to Your App Property List" under Creating a Login with Amazon Project section for instructions on adding the API key to your iOS app.