Completar retos de MFA para usuarios de automatización

Cuando conecta una aplicación de autenticación externa a una cuenta de usuario, Salesforce comparte una clave secreta que puede generar TOTP. Con esta clave, puede redactar una secuencia de comandos que utiliza TOTP para completar MFA sin ninguna interacción humana.

Importante No utilice retos TOTP programáticos para cuentas de usuario que tienen el perfil Administrador del sistema o los permisos de usuario Modificar todos los datos, Ver todos los datos, Personalizar aplicación o Apex de autor. Estas cuentas están obligadas a utilizar métodos de MFA resistentes a phishing (contraseñas como autenticadores integrados o llaves de seguridad) a partir de junio de 2026. Cuando se aplica el requisito de MFA resistente a phishing, estas cuentas de usuario no pueden utilizar aplicaciones de autenticador.

A continuación le mostramos cómo conectar una aplicación de autenticación externa y obtener una clave que puede generar TOTP. Obtener la clave es un proceso manual que completa una vez.

Nota Estos pasos no son compatibles con Salesforce Authenticator.

Para completar retos TOTP de forma programática, escriba una secuencia de comandos que utilice la clave para generar TOTP. Incluya un método para recuperar los TOTP generados automáticamente y completar los inicios de sesión en la interfaz de usuario. Este es un ejemplo de JavaScript que utiliza la biblioteca otplib de código abierto desde npm. En este ejemplo, la clave secreta se almacena en la variable AUTOMATION_TOTP_SECRET. Esta muestra de código es solo para demostración: asegúrese de redactar y probar su propio código personalizado.

// This example assumes the otplib package has been installed ($ npm i otplib)
const { authenticator } = require('otplib');

// Store the Base32 secret securely (environment variable, secrets manager, etc.)
// This should be the "Key" shown in the UI after clicking "I Can't Scan the QR Code"
const TOTP_SECRET = process.env.AUTOMATION_TOTP_SECRET;

function getTotpCode() {
  if (!TOTP_SECRET) {
    throw new Error('Missing AUTOMATION_TOTP_SECRET');
  }

  // otplib's authenticator expects a Base32 secret by default;
  // 30s step, 6 digits, SHA1 are the common defaults
  return authenticator.generate(TOTP_SECRET);
}

// Example usage in an auth flow:
async function completeMfaChallenge({ enterCode }) {
  const code = getTotpCode();
  await enterCode(code); // customer supplies their UI interaction
}

module.exports = { getTotpCode, completeMfaChallenge };