Login com Amazon: Integre com seu sistema de conta existente
Copyright © 2017 Amazon.com, Inc. ou suas afiliadas. Todos os direitos reservados.
Amazon e o logotipo da Amazon são marcas comerciais da Amazon.com, Inc. ou de suas afiliadas. Todas as outras marcas comerciais não pertencentes à Amazon são propriedade de seus respectivos proprietários.
Introdução
Este é um guia para integrar o cliente profissionalfile dados de Login com contas de usuário da Amazon com um website ou aplicativo móvel que já possui um sistema de gerenciamento de contas.
Você aprenderá como habilitar seu site ou aplicativo para permitir que os usuários façam login usando suas contas da Amazon, e também como permitir que os usuários existentes de seu website anexar sua identidade Amazon para que eles façam login com suas credenciais Amazon.
O que você precisa ter
Este guia pressupõe que você já se inscreveu para fazer login na Amazon, registrou seu website ou aplicativo móvel como um Login com o aplicativo Amazon, e ter o SDK apropriado ou métodos do lado do servidor para se comunicar com o serviço Login com Amazon.
Este guia também presume que seu site ou aplicativo atualmente tem estes recursos:
- Um banco de dados de contas onde você registra informações sobre cada conta de usuário:
uma. Os usuários têm algum tipo de identificador único
b. Os usuários atualmente fazem login usando seu nome de usuário / senha - Uma página de login para usuários registrados.
- Uma página de registro para registrar novos usuários por meio de profissionaisfile informações (nome, email, etc.).
- Algum mecanismo para gerenciar o estado de autenticação depois que o usuário fizer login com sucesso para que a próxima página saiba que o usuário está conectado no momento (por exemploamparquivo, armazenando essas informações em cookies ou em um banco de dados de back-end).
O que você precisa fazer
Estas são as mudanças de alto nível que você precisa fazer para integrar os clientes da Amazon em seu sistema de gerenciamento de conta:
- Mudanças no banco de dados: Você precisará mapear os identificadores de clientes da Amazon para seus próprios identificadores internos. Isso pode assumir a forma de um campo adicional na tabela de usuários em seu banco de dados.
- Mudanças na IU de login: Você precisa alterar sua página de login, página de registro e página de checkout (se aplicável). Sua página de login precisará ter uma opção para os usuários selecionarem o botão “Login com Amazon” para autenticar usando suas credenciais Amazon. As etapas para implementar isso são abordadas no Faça login com as diretrizes de estilo da Amazon.
- Crie um manipulador de resposta: Esta é uma nova página em seu site ou função em seu aplicativo para lidar com respostas de autenticação da Amazon.
Faça alterações no banco de dados
Você precisará modificar o banco de dados de sua conta para registrar um mapeamento entre os identificadores de conta da Amazon e suas contas locais. Isso pode assumir a forma de um novo campo em sua tabela de conta ou uma tabela que mapeia entre os identificadores de conta da Amazon e seus identificadores de conta local.
Os identificadores de conta da Amazon são retornados como a propriedade user_ID, no formato amzn1.accountVALUE.
Por exemploample: amzn1.account.K2LI23KL2LK2.
Configure o login com a Amazon
Usando o SDK relevante ou métodos do lado do servidor para o seu website ou aplicativo, forneça um método para o usuário fazer login com suas credenciais da Amazon. Isso inclui fazer alterações na IU de suas páginas de login e registro. Sua página de login precisará ter uma opção para os usuários selecionarem o botão “Login com Amazon” para autenticar usando suas credenciais Amazon. Para obter mais detalhes sobre como autenticar usuários usando Login com Amazon, consulte nossos guias do desenvolvedor para iOS, android-gsg._TTH [PDF], e website-gsg._TTH.
Obtenha e proteja o Amazon Customer Profile Dados
Uma vez que o usuário tenha interagido com o serviço Login com Amazon para autenticar (e, na primeira visita, autorizar o compartilhamento de dados), você receberá uma resposta de autenticação.
Ao receber uma resposta de autenticação, você deve:
- Envie o token de acesso em sua resposta de autorização para seu servidor usando HTTPS.
- Do lado do servidor, ligue para o profissionalfile endpoint usando o token de acesso. Veja a seção intitulada Usando tokens de acesso para ler um cliente profissionalfile do Login com Amazon webguia do desenvolvedor do site._TTH [PDF] para obter detalhes sobre como ligar para o profissionalfile endpoint do lado do servidor, incluindo códigosamparquivos em vários idiomas. O login com a Amazon retornará um cliente profissionalfile resposta com valores (como user_id, email, name e / ou postal_code) que você pode manter em seu servidor. Essa etapa irá garantir que o profissionalfile os dados que você salva em seu servidor pertencem ao cliente que está conectado ao seu cliente.
- Procurar the user’s Amazon account identifier within your user database to see if they have signed in before. If they have not then you will need to create a new account for them.
- Procurar the user’s email address in your account system. If they have a local account with that email address, prompt them to enter their local credentials to allow Login with Amazon to log in that account.
- Crie cookies no navegador do usuário ou registre-os como autenticados em seu site ou aplicativo.
Encontre ou crie uma conta local
O usuário profissionalfile a resposta sempre conterá um parâmetro denominado user_id. O valor desse parâmetro é uma string que identifica de forma permanente e exclusiva a conta da Amazon na qual o usuário se inscreveu. A Amazon sempre retornará o mesmo identificador para cada usuário.
Você deve pesquisar seu banco de dados de usuário para ver se essa conta da Amazon já entrou no seu site ou aplicativo. Se você não viu a conta da Amazon antes, você precisará criar uma nova entrada em seu banco de dados de conta local e associá-la ao identificador de conta da Amazon para a próxima vez que eles entrarem. Se a conta da Amazon não corresponder a uma conta local existente, solicitar ao usuário sua senha local para vincular as duas contas.
A resposta de autenticação pode conter dados adicionais do usuário, por exemploample, o nome do usuário e endereço de e-mail. Você pode copiar esta informação em seu banco de dados de conta local ao criar novas contas ou para atualizar contas existentes (por exemploamp(le, o usuário pode ter alterado seu endereço de e-mail na Amazon desde a última vez que entrou).
Se você precisar coletar informações adicionais do usuário antes de criar uma conta, é aqui que você deseja exibir uma página de registro. Você pode preenchê-lo previamente com as informações que recebeu na resposta de autenticação ou pode mostrar apenas os campos adicionais necessários.
Observação: Se o seu webO gerenciamento de conta local de um site ou aplicativo inclui a redefinição de senhas, você pode querer garantir que os usuários de Login com Amazon não fiquem confusos sobre como isso afeta sua conta Amazon. Isso pode significar ocultar um link "Redefinir senha" se os usuários estiverem logados via Login com a Amazon, ou uma nota na página de redefinição de senha direcionando-os para https://www.amazon.com se quiserem alterar a senha.
Marque o usuário como autenticado
Depois de receber uma resposta de autenticação válida e encontrar ou criar uma conta correspondente em seu próprio banco de dados de contas, você deve marcar que o usuário foi autenticado. Esta etapa pode funcionar exatamente da mesma forma que em seu sistema de autenticação atual.
Faça login com a Amazon Integrate com o seu sistema de conta existente - Baixar [otimizado]
Faça login com a Amazon Integrate com o seu sistema de conta existente - Download
