Relever les défis de la MFA pour les utilisateurs de l'automatisation

Lorsque vous connectez une application d'authentification tierce à un compte utilisateur, Salesforce partage une clé secrète qui peut générer des TOTP. Avec cette clé, vous pouvez écrire un script qui utilise des TOTP pour compléter la MFA sans aucune interaction humaine.

Important N'utilisez pas de défis TOTP par programmation pour les comptes utilisateur qui ont le profil Administrateur système ou les autorisations utilisateur Modifier toutes les données, Afficher toutes les données, Personnaliser l'application ou Auteur Apex. Ces comptes doivent utiliser des méthodes MFA résistantes à l'hameçonnage (clés telles que des authentificateurs intégrés ou des clés de sécurité) à compter de juin 2026. Lorsque l'exigence de MFA résistante à l'hameçonnage est appliquée, ces comptes utilisateur ne peuvent pas utiliser d'applications d'authentification.

Voici comment connecter une application d'authentification tierce et obtenir une clé qui peut générer des TOTP. Obtenir la clé est un processus manuel que vous effectuez une seule fois.

Remarque Salesforce Authenticator ne prend pas en charge ces étapes.

Pour réaliser des défis TOTP par programmation, écrivez un script qui utilise la clé pour générer des TOTP. Incluez une méthode pour récupérer les TOTP automatiquement générés et compléter les connexions à l'interface utilisateur. Voici un exemple JavaScript qui utilise la bibliothèque open-source otplib de npm. Dans cet exemple, la clé secrète est stockée dans la variable AUTOMATION_TOTP_SECRET. Cet exemple de code sert uniquement de démonstration. Assurez-vous d'écrire et de tester votre propre code personnalisé.

// 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 };