Plantillas de scripts de eliminación

Describe las plantillas de scripts de acción de base de datos personalizada para la eliminación de usuarios.

El script Delete implementa la función definida para eliminar un usuario especificado de una base de datos externa. Recomendamos llamar a esta función deleteUser.

El script solo se usa en un escenario de autenticación heredado y es necesario si quiere eliminar un usuario de Auth0 y de su base de datos externa en la misma operación.

​

Función DeleteUser

La función deleteUser debe:

• Eliminar el usuario especificado de la base de datos externa.
• Devolver un valor null si la eliminación se realiza correctamente.
• Devolver un error si la eliminación falla.

​

Definición

La función deleteUser recibe dos parámetros y devuelve una función callback:

deleteUser(id, callback): function

Parámetro	Tipo	Descripción
id	String	user_id de identidad del usuario. No comienza con auth0.
callback	Function	Se usa para pasar errores o datos del perfil a través del flujo.

​

Ejemplo

Este es un ejemplo en seudo-JavaScript de cómo podría implementar la función deleteUser. Para ver ejemplos específicos de cada lenguaje, consulte Ejemplos de scripts específicos de cada lenguaje.

function deleteUser(id, callback) {
  // Enviar el identificador de usuario a la API de base de datos externa
  let options = {
    url: "https://example.com/api/deleteUser",
    body: {
      id: id
    }
  };

  send(options, (err, profileData) => {
    // Devolver error en el callback si la eliminación falló
    if (err) {
      return callback(new Error("My custom error message."));
    }

    // Devolver valor nulo en el callback si la eliminación fue exitosa
    return callback(null);
  });
}

​

Función de devolución de llamada

La función callback acepta un parámetro y devuelve una función.

​

Definición

callback(error): function

Parámetro	Tipo	Obligatorio	Descripción
error	Objeto	Obligatorio	Contiene los datos del error.

​

Devolver un resultado exitoso

Si el usuario se eliminó correctamente de su base de datos externa, devuelva la función callback y pase un valor null en el parámetro error.

​

Ejemplo

return callback(null);

​

Devolver un error

Si se produce un error, llama a la función callback y pasa la información relevante del error al parámetro error.

​

Ejemplo

return callback(new Error("My custom error message."));

​

Ejemplos de scripts específicos para cada lenguaje

Auth0 proporciona scripts de ejemplo para los siguientes lenguajes/tecnologías:

• JavaScript
• Proveedor de membresía de ASP.NET (MVC3 - Universal Providers)
• Proveedor de membresía de ASP.NET (MVC4 - Simple Membership)
• MongoDB
• MySQL
• PostgreSQL
• SQL Server
• Base de datos SQL de Windows Azure

​

JavaScript

function remove (id, callback) {
  // Este script elimina un usuario de su base de datos existente.
  // Se ejecuta cada vez que se elimina un usuario desde la Management API o el Auth0 Dashboard.
  //
  // Hay dos formas en que este script puede finalizar:
  // 1. El usuario fue eliminado correctamente:
  //     callback(null);
  // 2. Algo salió mal al intentar conectarse a su base de datos:
  //     callback(new Error("my error message"));
  var msg = "Please implement the Delete script for this database " +
       "connection at https://manage.auth0.com/#/connections/database";
  return callback(new Error(msg));
}

​

Proveedor de membresía de ASP.NET (MVC3 - Proveedores universales)

function remove(id, callback) {
  const sqlserver = require('tedious@1.11.0');
  const Connection = sqlserver.Connection;
  const Request = sqlserver.Request;
  const TYPES = sqlserver.TYPES;
  const connection = new Connection({
    userName: 'the username',
    password: 'the password',
    server: 'the server',
    options: {
      database: 'the db name',
      encrypt: true,
      // Necesario para recuperar el userId requerido para la creación de la entidad Membership
      rowCollectionOnRequestCompletion: true
    }
  });
  connection.on('debug', function(text) {
    // si tienes problemas de conexión, descomenta esto para obtener información más detallada
    // console.log(text);
  }).on('errorMessage', function(text) {
    // esto mostrará cualquier error al conectarse a la base de datos SQL o con las sentencias SQL
    console.log(JSON.stringify(text));
  });
  connection.on('connect', function(err) {
    if (err) return callback(err);
    executeDelete(['Memberships', 'Users'], function(err) {
      if (err) return callback(err);
      callback(null);
    });
  });
  function executeDelete(tables, callback) {
    const query = tables.map(function(table) {
      return 'DELETE FROM ' + table + ' WHERE UserId = @UserId';
    }).join(';');
    const request = new Request(query, function(err) {
      if (err) return callback(err);
      callback(null);
    });
    request.addParameter('UserId', TYPES.VarChar, id);
    connection.execSql(request);
  }
}

​

Proveedor de membresía de ASP.NET (MVC4 - Simple Membership)

function remove(id, callback) {
  const sqlserver = require('tedious@1.11.0');
  const Connection = sqlserver.Connection;
  const Request = sqlserver.Request;
  const TYPES = sqlserver.TYPES;
  const connection = new Connection({
    userName: 'the username',
    password: 'the password',
    server: 'the server',
    options: {
      database: 'the db name',
      encrypt: true,
      // Necesario para recuperar el userId requerido para la creación de la entidad Membership
      rowCollectionOnRequestCompletion: true
    }
  });
  connection.on('debug', function (text) {
    // si tienes problemas de conexión, descomenta esto para obtener información más detallada
    // console.log(text);
  }).on('errorMessage', function (text) {
    // esto mostrará cualquier error al conectarse a la base de datos SQL o con las sentencias SQL
    console.log(JSON.stringify(text));
  });
  connection.on('connect', function (err) {
    if (err) return callback(err);
    executeDelete(['webpages_Membership', 'UserProfile'], function (err) {
      if (err) return callback(err);
      callback(null);
    });
  });
  function executeDelete(tables, callback) {
    const query = tables.map(function (table) {
      return 'DELETE FROM ' + table + ' WHERE UserId = @UserId';
    }).join(';');
    const request = new Request(query, function (err) {
      if (err) return callback(err);
      callback(null);
    });
    request.addParameter('UserId', TYPES.VarChar, id);
    connection.execSql(request);
  }
}

​

MongoDB

function remove(id, callback) {
  const MongoClient = require('mongodb@3.1.4').MongoClient;
  const client = new MongoClient('mongodb://user:[e-mail]');
  client.connect(function (err) {
    if (err) return callback(err);
    const db = client.db('db-name');
    const users = db.collection('users');
    users.remove({ _id: id }, function (err) {
      client.close();
      if (err) return callback(err);
      callback(null);
    });
  });
}

​

MySQL

function remove(id, callback) {
  const mysql = require('mysql');
  const connection = mysql({
    host: 'localhost',
    user: 'me',
    password: 'secret',
    database: 'mydb'
  });
  connection.connect();
  const query = 'DELETE FROM users WHERE id = ?';
  connection.query(query, [ id ], function(err) {
    if (err) return callback(err);
    callback(null);
  });
}

​

PostgreSQL

function remove(id, callback) {
  //este ejemplo usa la librería "pg"
  //más información aquí: https://github.com/brianc/node-postgres
  const postgres = require('pg');
  const conString = 'postgres://user:pass@localhost/mydb';
  postgres.connect(conString, function (err, client, done) {
    if (err) return callback(err);
    const query = 'DELETE FROM users WHERE id = $1';
    client.query(query, [id], function (err) {
      // NOTA: siempre llama a `done()` aquí para cerrar
      // la conexión a la base de datos
      done();
      return callback(err);
    });
  });
}

​

SQL Server

function remove(id, callback) {
  // este ejemplo usa la biblioteca "tedious"
  // más información aquí: http://pekim.github.io/tedious/index.html
  const sqlserver = require('tedious@1.11.0');
  const Connection = sqlserver.Connection;
  const Request = sqlserver.Request;
  const TYPES = sqlserver.TYPES;
  const connection = new Connection({
    userName:  'test',
    password:  'test',
    server:    'localhost',
    options:  {
      database: 'mydb'
    }
  });
  const query = 'DELETE FROM dbo.Users WHERE id = @UserId';
  connection.on('debug', function (text) {
    console.log(text);
  }).on('errorMessage', function (text) {
    console.log(JSON.stringify(text, null, 2));
  }).on('infoMessage', function (text) {
    console.log(JSON.stringify(text, null, 2));
  });
  connection.on('connect', function (err) {
    if (err) return callback(err);
    const request = new Request(query, function (err) {
      if (err) return callback(err);
      callback(null);
    });
    request.addParameter('UserId', TYPES.VarChar, id);
    connection.execSql(request);
  });
}

​

Base de datos SQL de Windows Azure

function remove (id, callback) {
  // este ejemplo usa la biblioteca "tedious"
  // más información aquí: http://pekim.github.io/tedious/index.html
  var Connection = require('tedious@1.11.0').Connection;
  var Request = require('tedious@1.11.0').Request;
  var TYPES = require('tedious@1.11.0').TYPES;
  var connection = new Connection({
    userName: '[e-mail]',
    password: 'the-password',
    server: 'your-server-id.database.windows.net',
    options: {
      database: 'mydb',
      encrypt: true
    }
  });
  connection.on('debug', function (text) {
    console.log(text);
  }).on('errorMessage', function (text) {
    console.log(JSON.stringify(text, null, 2));
  }).on('infoMessage', function (text) {
    console.log(JSON.stringify(text, null, 2));
  });
  connection.on('connect', function (err) {
    if (err) { return callback(err); }
    var query = 'DELETE FROM users WHERE id = @UserId';
    var request = new Request(query, function (err) {
      if (err) { return callback(err); }
      callback(null);
    });
    request.addParameter('UserId', TYPES.VarChar, id);
    connection.execSql(request);
  });
}

​

Más información

• Plantillas de scripts para cambiar la contraseña
• Plantillas de scripts para crear usuarios
• Plantillas de scripts para obtener usuarios
• Plantillas de scripts de inicio de sesión
• Plantillas de scripts de verificación
• Plantilla de script para cambiar el correo electrónico