Fuldfør MFA-udfordringer for automatiseringsbrugere

Når du tilslutter en godkendelsesapp fra tredjepart til en brugerkonto, deler Salesforce en hemmelig nøgle, der kan generere TOTP'er. Med denne nøgle kan du skrive et script, der bruger TOTP'er til at fuldføre MFA uden nogen menneskelig interaktion.

Vigtigt Brug ikke programmeringsmæssige TOTP-udfordringer til brugerkonti, der har profilen Systemadministrator eller brugertilladelserne Rediger alle data, Vis alle data, Tilpas applikation eller Forfatter Apex. Disse konti kræves for at bruge phishing-resistente MFA-metoder (adgangsnøgler som indbyggede godkendere eller sikkerhedsnøgler) fra og med juni 2026. Når MFA-kravet til phishing-resistens håndhæves, kan disse brugerkonti ikke bruge godkendelsesapps.

Sådan tilslutter du en godkendelsesapp fra tredjepart og får en nøgle, der kan generere TOTP'er. Hentning af nøglen er en manuel proces, som du fuldfører en gang.

Bemærk Disse trin understøttes ikke for Salesforce Authenticator.

Hvis du vil fuldføre TOTP-udfordringer programmeringsmæssigt, skal du skrive et script, der bruger nøglen til at generere TOTP'er. Inkluder en metode til at hente de automatisk genererede TOTP'er og fuldføre brugergrænsefladelogins. Her er et JavaScript-eksempel, der bruger otplib-biblioteket fra npm. I dette eksempel gemmes den hemmelige nøgle i AUTOMATION_TOTP_SECRET. Dette kodeeksempel er kun til demonstration – sørg for at skrive og teste din egen tilpassede kode.

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