-
-
Notifications
You must be signed in to change notification settings - Fork 10
Amazon
The Akeeba Social Login - Amazon integration plugin allows user on your site to use their Amazon account to login or register a user account on your site.
DISCLAIMER: This part of our documentation describing the interaction with a third party service is for information purposes only. It should be treated as indicative and used at your own risk. Akeeba Ltd can only attest that this part of the documentation has been the faithful transcription of the steps we took at the time of its writing. We strongly recommend that you consult the documentation of the third party service for accurate instructions. Should the behavior of the third party service differ from what is published in our documentation you should consult the support of the third party service provider. Do not seek support from us for such matters; Akeeba Ltd cannot provide support for third party services, is not responsible for or notified about any changes in said services, nor is it obligated to update the documentation pursuant such changes.
Before you can use Amazon login on your site you must create an Amazon "Security Profile". Even though it sounds scary, an Amazon Security Profile is simply a way for you to get a set of access codes which let you identify your site on Amazon.
Start by going to https://developer.amazon.com/apps-and-games/login-with-amazon and log in, if you are not already logged in.
Then, go to https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.html
Click on Create a New Security Profile
Fill in the following information:
- Security Profile Name: Your website name
- Security Profile Description: This is what your visitors see
- Consent Privacy Notice URL: A URL on your site with your Privacy Notice
- Consent Logo Image: Your logo
Click on Save
Go back to https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.html
Click the gear icon under manage, select Security profile
Click on the Web Settings tab
Click on Edit
In the Allowed Origins enter the URL of your site, e.g. https://www.example.com
In the Allowed Return URLs enter http://www.example.com/index.php?option=com_ajax&group=sociallogin&plugin=amazon&format=raw
where http://www.example.com
MUST be replaced with your site's URL.
Click on Save
You are still on the Web Settings tab. Copy the Client ID into the plugin's Amazon Client ID field.
Click on the Show Secret button. Copy the displayed Client Secret into the plugin's Amazon Client Secret field.
Amazon Client ID Enter the Client ID for your custom Amazon Security Profile here. See the previous section for creating an Amazon Security Profile.
Amazon Client Secret Enter the Secret Key for your custom Amazon Security Profile here. See the previous section for creating an Amazon Security Profile.
Allow social login to non-linked accounts When enabled allows users to log in despite not having linked their Amazon account to their site user account. Their Amazon account's email address must be the same as the email account they use on your site.
Create new user accounts Creates a new Joomla! user when a user tries to log in via Amazon but there is no Joomla! user account associated with that email or Amazon User ID. If user registration is disabled no account will be created and an error will be raised. The new Joomla! user will have a username derived from the Amazon account holder's full name, the same email address as the Amazon account, and a long, random password (which the user can change once they have logged in). Set this to No to prevent creation of user accounts through Amazon login.
Ignore Joomla! setting for creating user accounts When both this option and the Create new user accounts option above are enabled a new user will always be created, even if you have disabled user registration in the options of Joomla's Users page. This is useful to prevent anyone from registering to your site unless they have an Amazon account.
Bypass user validation Only applies when creating new user accounts. When enabled the new user will be created active, without going through the Joomla! user account validation. This means that no account activation email will be sent to the user or the administrators of the Joomla! site. This makes perfect sense since Amazon has already verified that the user is in control of the email address they are using with their Amazon account.
Button styling When enabled custom CSS for login, link and unlink button styling will be output to the page header. Disable this option if you intend to use your own CSS to style the buttons.
Icon class The icon CSS class to use in the login, link and unlink buttons. Useful to use an icon font such as FontAwesome or Glyphicons to render the logo. If it's left empty, a PNG image with the Amazon logo will be used instead.
Login buttons can be shown in In which part(s) of your site do you want to allow showing the Social Login buttons? For more information on how this feature works please consult the “Hiding in the frontend or backend” documentation page.
Copyright (C) 2017-2023 Akeeba Ltd.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section "GNU Free Documentation License".