MFA-uitdagingen voltooien voor automatiseringsgebruikers

Wanneer u een externe authenticator-app verbindt met een gebruikersaccount, deelt Salesforce een geheime sleutel die TOTP's kan genereren. Met deze sleutel kunt u een script schrijven dat TOTP's gebruikt om MFA te voltooien zonder menselijke tussenkomst.

Belangrijk Gebruik geen programmatische TOTP-uitdagingen voor gebruikersaccounts die het profiel Systeembeheerder of de gebruikersmachtigingen Alle gegevens wijzigen, Alle gegevens weergeven, Toepassing aanpassen of Apex auteur hebben. Deze accounts zijn verplicht om phishingbestendige MFA-methoden (wachtwoorden zoals ingebouwde authenticators of beveiligingssleutels) te gebruiken vanaf juni 2026.Wanneer de phishingbestendige MFA-vereiste wordt afgedwongen, kunnen deze gebruikersaccounts geen authenticator-apps gebruiken.

U verbindt als volgt een externe authenticator-app en krijgt een sleutel die TOTP's kan genereren. Het verkrijgen van de sleutel is een handmatig proces dat u één maal uitvoert.

Opmerking Deze stappen worden niet ondersteund voor Salesforce Authenticator.

Schrijf voor het programmatisch voltooien van TOTP-uitdagingen een script dat de sleutel gebruikt om TOTP's te genereren. Neem een methode op om de automatisch gegenereerde TOTP's op te halen en UI-logins te voltooien. Hier is een JavaScript-voorbeeld dat de open-source otplib-bibliotheek van npm gebruikt. In dit voorbeeld wordt de geheime sleutel opgeslagen in de variabele AUTOMATION_TOTP_SECRET. Dit codevoorbeeld is alleen voor demonstratie. Zorg ervoor dat u uw eigen aangepaste code schrijft en test.

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