オートメーションユーザーの MFA の課題の完了

サードパーティ認証アプリケーションをユーザーアカウントに接続すると、Salesforce は TOTP を生成できる秘密鍵を共有します。このキーを使用して、TOTP を使用して人の操作なしで MFA を完了するためのスクリプトを作成できます。

重要 システム管理者プロファイルまたは「すべてのデータの編集」、「すべてのデータの参照」、「アプリケーションのカスタマイズ」、または「Apex ユーザーの作成」権限を持つユーザー・アカウントでは、プログラムによる TOTP チャレンジを使用しないでください。これらのアカウントでは、2026 年 6 月以降、 フィッシングに強い MFA 方法 (組み込み Authenticator やセキュリティキーなどのパスキー) を使用する必要 があります。 フィッシングに強い MFA 要件が適用されると、これらのユーザーアカウントは認証アプリケーションを使用できなくなります。

サードパーティ認証アプリケーションを接続し、TOTP を生成できる鍵を取得する方法を次に示します。鍵の取得は、1 回のみ実行する手動プロセスです。

メモ 次の手順は、Salesforce Authenticatorではサポートされていません。

プログラムで TOTP チャレンジを完了するには、キーを使用して TOTP を生成するスクリプトを記述します。自動生成された TOTP を取得して UI ログインを完了する方法を含めます。npm のオープンソース otplib ライブラリを使用する JavaScript の例を次に示します。この例では、秘密鍵は AUTOMATION_TOTP_SECRET 変数に保存されます。このコードサンプルはデモ用です。必ず独自のカスタムコードを作成してテストしてください。

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