Легко перенести существующих пользователей в Auth0

Включив нашу пользовательскую функцию базы данных, давайте включим функцию импорта. По умолчанию пользовательское подключение к базе данных позволит нам проходить аутентификацию с внешней базой данных и не будет импортировать пользователей в Auth0. Если мы хотим перенести пользователей с внешней платформы в Auth0, нам нужно просто переключить переключатель. Перейдите на вкладку « Настройки » соединения и нажмите переключатель «Импортировать пользователей в Auth0», и все готово.

Последний шаг, который мы сделаем перед реализацией наших скриптов, — это включение этого соединения для нашего клиента по умолчанию. Перейдите на вкладку « Клиенты », пока вы подключены к базе данных, и нажмите переключатель, чтобы включить этот клиент для подключения по умолчанию . Если у вас уже есть учетная запись Auth0, имя подключения может отличаться.

Авторизоваться

Сценарий входа в систему выполняется, когда пользователь пытается войти в систему, но его учетная запись не найдена в базе данных Auth0. Здесь мы реализуем функциональность для передачи учетных данных, предоставленных нашему хранилищу пользовательских данных Stormpath, и посмотрим, действителен ли этот пользователь. Auth0 предоставляет шаблоны для многих распространенных баз данных, таких как MongoDB, MySQL и SQL Server, а также Stormpath. Эти шаблоны обеспечивают отличную отправную точку, и вы можете настроить их так, как вы хотите, или написать свой с нуля.

Сценарии действий с базой данных выполняются в изолированной программной среде Webtask и являются сценариями Node.js. Поскольку наше руководство посвящено миграции пользователей Stormpath на Auth0, приведенные ниже сценарии будут ориентированы на работу с REST API Stormpath, но если вы переносите пользователей из другого провайдера, вы должны написать здесь свою реализацию или использовать один из других. шаблоны предоставляются.

Давайте посмотрим на реализацию сценария входа в систему, чтобы увидеть, как он работает. Мы будем использовать REST API Stormpath для аутентификации пользователя.

function login(username, password, callback) {
  // Replace the YOUR-STORMPATH-CLIENT-ID with your Stormpath ID
  var url = 'https://api.stormpath.com/v1/applications/{YOUR-STORMPATH-CLIENT-ID}/loginAttempts';
  // Add your Stormpath API Client ID and Secret
  var apiCredentials = {
    user : 'YOUR-STORMPATH-API-ID',
    password: 'YOUR-STORMPATH-API-SECRET'
  }

  // Stormpath requires the user credentials be passed in as a base64 encoded message
  var credentials = new Buffer(username + ':' + password).toString('base64');

  // Make a POST request to authenticate a user
  request({
    url: url,
    method: 'POST',
    auth: apiCredentials,
    json: {
      type: 'basic',
      // Passing in the base64 encoded credentials
      value: credentials
    }
  }, function (error, response, body) {
    // If response is successful we'll continue
    if (response.statusCode !== 200) return callback();
    // A successful response will return a URL to get the user information
    var accountUrl = body.account.href;

    // Make a second request to get the user info.
    request({
      url: accountUrl,
      auth: apiCredentials,
      json: true
    }, function (errorUserInfo, responseUserInfo, bodyUserInfo) {
      // If we get a successful response, we'll process it
      if (responseUserInfo.statusCode !== 200) return callback();

      // To get the user identifier, we'll strip out the Stormpath API
      var id = bodyUserInfo.href.replace('https://api.stormpath.com/v1/accounts/', '');

      // Finally, we'll set the data we want to store in Auth0 and migrate the user
      return callback(null, {
        user_id : id,
        username: bodyUserInfo.username,
        email: bodyUserInfo.email,
        // We set the users email_verified to true as we assume if they were a valid
        // user in Stormpath, they have already verified their email
        // If this field is not set, the user will get an email asking them to verify
        // their account. You can decide how to handle this for your use case
        email_verified: true
        // Add any additional fields you would like to carry over from Stormpath
      });
    });
  });
}

Получить пользователя

Сценарий Get User выполняется, когда пользователь пытается выполнить сброс пароля, но его учетная запись не найдена в базе данных Auth0. Сценарий Get User взаимодействует с вашим хранилищем данных Stormpath и проверяет, существует ли пользователь там. Если пользователь существует, его данные отправляются обратно в Auth0, где пользователь переносится, и электронное письмо для сброса пароля отправляется из Auth0. После того, как пользователь подтвердит сброс, он сможет перейти к вашему приложению. Последующие входы будут проходить проверку подлинности в базе данных Auth0, поскольку профиль пользователя теперь хранится в Auth0.

Если вы не переносите своего пользователя из Stormpath, сценарий Get User также будет вашей собственной реализацией. Давайте посмотрим на реализацию нашего шаблона скрипта Get User для Stormpath:

 function getByEmail(email, callback) {
  // Replace the YOUR-STORMPATH-CLIENT-ID with your Stormpath ID
  var url = 'https://api.stormpath.com/v1/applications/{YOUR-STORMPATH-CLIENT-ID}/accounts';
  // Add your Stormpath API Client ID and Secret
  var apiCredentials = {
    user : 'YOUR-STORMPATH-API-ID',
    password: 'YOUR-STORMPATH-API-SECRET'
  };

  // Make a GET request to find a user by email
  request({
    url: url,
    method: 'GET',
    auth: apiCredentials,
    qs: { q: email },
    json: true
  }, function (error, response, body) {
    if (response.statusCode !== 200) return callback();

    var user = body.items[0];

    if (!user) return callback();

    var id = user.href.replace('https://api.stormpath.com/v1/accounts/', '');

    return callback(null, {
      user_id: id,
      username: user.username,
      email: user.email,
      email_verified: true
      // Add any additional fields you would like to carry over from Stormpath
    });
  });
}

С этими двумя сценариями мы настроили миграцию пользователей и готовы к работе. Чтобы проверить его и убедиться, что наш код работает, давайте создадим простое приложение, которое позволяет пользователю входить в систему и запрашивать защищенные ресурсы через API. Мы создадим внешний интерфейс с Angular, а внутренний — с Spring .

Строительство фронтенда

Мы создадим наш интерфейс с Angular 2. Мы будем использовать быстрый запуск Auth0 Angular 2, чтобы быстро начать работу. Наш исходный код можно найти здесь . Auth0 предоставляет полный набор быстрых запусков, SDK и руководств для многих популярных языков и сред. Смотрите их всех здесь .

После загрузки проекта нам нужно настроить учетные данные Auth0. Мы сделаем это в файле auth.config.js. Откройте файл и измените значения так:

 "use strict";
exports.myConfig = {
    // Your Auth0 ClientID.
    clientID: '{AUTH0-CLIENT-ID}',
    // Your Auth0 Domain
    domain: '{YOUR-AUTH0-DOMAIN}.auth0.com'
};

Оба эти значения можно найти на панели управления Auth0. На панели инструментов просто нажмите ссылку « Клиенты» в главном меню и выберите «Клиент по умолчанию», который был создан при регистрации. Если у вас уже была учетная запись Auth0, выберите клиент с подключением к базе данных с включенной настраиваемой базой данных.

 auth0.domain: {YOUR-AUTH-DOMAIN}.auth0.com
auth0.issuer: https://{YOUR-AUTH0-DOMAIN}.auth0.com/
auth0.clientId: {YOUR-AUTH0-CLIENT-ID}
auth0.securedRoute: NOT_USED
auth0.base64EncodedSecret: false
auth0.authorityStrategy: ROLES
auth0.defaultAuth0ApiSecurityEnabled: false
auth0.signingAlgorithm: HS256

 mvn spring-boot:run -Drun.arguments="--auth0.secret=YOUR_SECRET_KEY"