Escenarios de migración de usuarios

A continuación, se presentan algunos escenarios de ejemplo para migrar usuarios de Gigya, Okta y Stormpath a Auth0. Cada uno de estos escenarios asume que tiene cuentas en esas plataformas.

Requisitos previos

Configure la conexión de base de datos personalizada.

Cree una nueva conexión de base de datos en Dashboard > Authentication > Database. Asegúrese de seleccionar la vista Custom Database y de activar el interruptor Use my own database.
Conecte la base de datos a la aplicación: en la configuración de la conexión de base de datos, seleccione la vista Applications. Busque la sección Applications Using This Connection y habilite la conexión de base de datos para cada aplicación.

Escenario 1: Migrar usuarios de Gigya a Auth0

Exporte los usuarios de Gigya: Use IdentitySync de Gigya para transformar y exportar los datos de usuario para que coincidan con un esquema de destino. Para obtener más información sobre este proceso, consulte Gigya IdentitySync: Using IdentitySync.

Siga las instrucciones para transformar los datos de usuario de la base de datos de Gigya al esquema correcto y exportar los datos transformados en formato JSON.
Importe sus usuarios de Gigya a Auth0: Puede importar usuarios con la Extensión de importación/exportación de usuarios o con la Management API.
- Extensión de importación/exportación de usuarios: Vaya a Auth0 Dashboard > Extensions, seleccione la extensión User Import / Export e instálela. Una vez instalada, puede hacer clic en ella para abrir una interfaz de importación/exportación.
  
  Arrastre el archivo JSON exportado con los usuarios de Gigya al área de carga designada y seleccione la base de datos que creó anteriormente. Seleccione Start Importing Users para iniciar la importación. Para obtener más información, consulte Extensión de importación/exportación de usuarios.
- Management API: Cree un trabajo para importar sus usuarios a Auth0. Para obtener instrucciones detalladas, consulte Importación masiva de usuarios.

Escenario 2: Migrar usuarios de Okta a Auth0

Habilite la importación de usuarios: vaya a Auth0 Dashboard > Authentication > Database y seleccione la conexión de base de datos. En Settings, habilite la opción Import Users to Auth0.

Cree el script de Login: el script de Login se ejecuta cuando un usuario intenta iniciar sesión, pero su cuenta no se encuentra en la base de datos de Auth0. Debe crear un script que llame al endpoint de Autenticación primaria de Okta y pase el correo electrónico y la contraseña como parámetros username y password. Si la autenticación se realiza correctamente, Okta devolverá un objeto Authentication Transaction que contiene el perfil del usuario en los recursos incrustados. Luego, puede extraer la información del usuario y pasarla a Auth0 en la función de callback.

En la vista Custom Database de tu conexión de base de datos, busca Database Action Scripts y selecciona Login.

function login (email, password, callback) {
  // Reemplaza {yourOktaDomain} con tu propio dominio de Okta
  var url = 'https:/{yourOktaDomain}/api/v1/authn';

  // Realiza la solicitud POST para autenticar a un usuario
  request({
    url: url,
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json'
    },
    body: {
      username: email,
      password: password,
      options: {
        multiOptionalFactorEnroll: false,
        warnBeforePasswordExpired: false
      }
    },
    json: true
  }, function (error, response, body) {
    // Verifica que la respuesta sea exitosa
    if (response.statusCode !== 200) return callback();

    // Obtén el usuario del cuerpo de la respuesta
    var user = body._embedded.user;

    // Define los datos que deseas almacenar en Auth0 y migra el usuario
    return callback(null, {
        user_id : user.id,
        username: user.profile.login,
        email: user.profile.login,
        // Establecemos email_verified en true porque asumimos que, si eran
        // usuarios válidos en Okta, ya han verificado su correo electrónico.
        // Si este campo no se establece, el usuario recibirá un correo electrónico
        // pidiéndole que verifique su cuenta
        email_verified: true,
        name: user.profile.firstName + ' ' + user.profile.lastName
      });
  });
}

Haz clic en el botón Try sobre el script para comprobar si funciona.

Cree el script Get User: el script Get User se ejecuta cuando el usuario intenta restablecer su contraseña, pero no se encuentra su cuenta en la base de datos de Auth0. Deberá crear un script que llame al endpoint Get User with Login de Okta, pasando el correo electrónico del usuario como parámetro login. También deberá crear un token de API, que debe enviarse a este endpoint en el encabezado Authorization. Si la operación se realiza correctamente, Okta devolverá un objeto de usuario con la información del usuario. Una vez más, puede extraer la información del usuario y pasarla a Auth0 en la función de callback.

En la vista Custom Database de tu conexión de base de datos, busca Database Action Scripts y selecciona Get User.

function getByEmail(email, callback) {
  // Reemplaza {yourOktaDomain} con tu propio dominio de Okta
  var url = 'https://{yourOktaDomain}/api/v1/users/' + encodeURIComponent(email);

  // Realiza una solicitud GET para encontrar un usuario por correo electrónico
  // Reemplaza {yourOktaApiToken} con un token de API de Okta 
  // (consulta https://developer.okta.com/docs/api/getting_started/getting_a_token.html) 
  request({
    url: url,
    method: 'GET',
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json',
      'Authorization': 'SSWS ' + '{yourOktaApiToken}'
    },
    json: true
  }, function (error, response, body) {
    // Asegúrate de que la respuesta sea exitosa
    if (response.statusCode !== 200) return callback();

    // Define los datos que se almacenarán en Auth0 y migra el usuario
    return callback(null, {
      user_id: body.id,
      username: body.profile.login,
      email: body.profile.login,
      email_verified: true,
      name: body.profile.firstName + ' ' + body.profile.lastName
    });
  });
}

Haz clic en el botón Try situado encima del script para comprobar que el script funciona.

Pruebe la conexión de base de datos personalizada: haga clic en Try connection. Aparecerá el widget Lock de Auth0. Introduzca el correo electrónico y la contraseña del usuario de Okta y haga clic en Log In. Debería ver una página web que indique que la conexión funciona, con información del usuario.
Para ver los usuarios importados recientemente, vaya a Auth0 Dashboard > Gestión de usuarios > Usuarios.

Escenario 3: Migrar usuarios de Stormpath a Auth0

Habilite la importación de usuarios: vaya a Auth0 Dashboard > Authentication > Database y seleccione su conexión de base de datos. En Settings, habilite la opción Import Users to Auth0.
Habilite aplicaciones para su conexión: seleccione la pestaña Aplicaciones. Habilite las aplicaciones que usarán la conexión de base de datos.

Cree el script de Login: el script Login se ejecuta cuando un usuario intenta iniciar sesión, pero no se encuentra su cuenta en la base de datos de Auth0. Deberá crear un script que llame a la API de Stormpath para autenticar al usuario y pasar sus credenciales como parámetros username y password.

Tras una autenticación correcta, la respuesta de Stormpath incluirá la URL de la cuenta del usuario. Haga una segunda solicitud a la URL de la cuenta para obtener la información del usuario. Luego, puede extraer la información del usuario y pasarla a Auth0 en la función de callback.

function login(username, password, callback) {
  // Reemplaza el atributo {yourStormpathClientId} con tu ID de Stormpath
  var url = 'https://api.stormpath.com/v1/applications/{yourStormpathClientId}/loginAttempts';

  // Stormpath requiere que las credenciales del usuario se pasen como un mensaje codificado en base64
  var message = username + ':' + password;
  var pass = new Buffer(message).toString('base64');

  // Aquí realizamos la solicitud POST para autenticar a un usuario
  request({
    url: url,
    method: 'POST',
    auth: {
      // Tu ID de cliente de API
      user: '{yourStormpathClientId}',
      // Tu secreto de cliente de API
      password: '{yourStormpathClientSecret}'
    },
    headers: {
      'Content-Type': 'application/json'
    },
    json: {
      type: 'basic',
      // Se pasan las credenciales codificadas en base64
      value: pass
    }
  }, function (error, response, body) {
    // Si la respuesta es exitosa, continuamos
    if (response.statusCode !== 200) return callback();
    // Una respuesta exitosa devolverá una URL para obtener la información del usuario
    var accountUrl = body.account.href;

    // Realizamos una segunda solicitud para obtener la información del usuario. Esta vez será una solicitud GET
    request({
      url: accountUrl,
      method: 'GET',
      auth: {
        // Tu ID de cliente de API
        user: '{yourStormpathClientId}',
        // Tu secreto de cliente de API
        password: '{yourStormpathClientSecret}'
      }
    }, function (errorUserInfo, responseUserInfo, bodyUserInfo) {
      // Si obtenemos una respuesta exitosa, la procesamos
      if (responseUserInfo.statusCode !== 200) return callback();

      var parsedBody = JSON.parse(bodyUserInfo);
      // Para obtener el identificador del usuario, eliminamos la ruta de la API de Stormpath
      var id = parsedBody.href.replace('https://api.stormpath.com/v1/accounts/', '');

      // Por último, definimos los datos que queremos almacenar en Auth0 y migramos al usuario
      return callback(null, {
        user_id : id,
        username: parsedBody.username,
        email: parsedBody.email,
        // Establecemos email_verified en true porque asumimos que, si el usuario era válido
        // en Stormpath, ya verificó su correo electrónico
        // Si este campo no se establece, el usuario recibirá un correo electrónico solicitándole
        // que verifique su cuenta
        email_verified: true,
        // Agrega cualquier campo adicional que desees trasladar desde Stormpath
      });
    });
  });
}

Haga clic en el botón Try situado encima del script para probarlo y verificar si funciona.

Cree el script Get User: el script Get User se ejecuta cuando el usuario intenta restablecer la contraseña, pero su cuenta no se encuentra en la base de datos de Auth0. Deberá crear un script que llame al endpoint /accounts de la API de Stormpath y pase el correo electrónico del usuario como parámetro email. Si la operación se realiza correctamente, Stormpath devolverá la información del usuario. Puede extraer esa información y pasarla a Auth0 en la función de callback.

function getByEmail(email, callback) {
  // Reemplaza el atributo {yourStormpathClientId} con tu ID de Stormpath
  var url = 'https://api.stormpath.com/v1/applications/{yourStormpathClientId}/accounts';

  request({
    url: url,
    method: 'GET',
    auth: {
      // Tu ID de cliente de API
      user: '{yourStormpathClientId}',
      // Tu secreto del cliente de API
      password: '{yourStormpathClientSecret}'
    },
    qs: { q: email }
  }, function (error, response, body) {
    if (response.statusCode !== 200) return callback();

    var parsedBody = JSON.parse(body);
    var user = parsedBody.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,
      // Agrega los campos adicionales que desees migrar desde Stormpath
    });
  });
}

Haz clic en el botón Try situado encima del script para probarlo y comprobar que funciona.

Pruebe la conexión de base de datos personalizada: haga clic en Try connection. Aparecerá el widget Auth0 Lock. Introduzca el correo electrónico y la contraseña del usuario de Stormpath y haga clic en Log In. Debería ver una página web que indique que la conexión funciona, con información sobre el usuario.
Para ver los usuarios recién importados, ve a Dashboard > User Management > Users.

​Requisitos previos

​Escenario 1: Migrar usuarios de Gigya a Auth0

​Escenario 2: Migrar usuarios de Okta a Auth0

​Escenario 3: Migrar usuarios de Stormpath a Auth0

Requisitos previos

Escenario 1: Migrar usuarios de Gigya a Auth0

Escenario 2: Migrar usuarios de Okta a Auth0

Escenario 3: Migrar usuarios de Stormpath a Auth0