Synthetics (Scripted Browser) で Passkey（パスキー）認証が必要なサイトを監視する方法

const { VirtualAuthenticatorOptions, Protocol, Transport } =
  require('selenium-webdriver/lib/virtual_authenticator');

// ---- 仮想認証器のセットアップ ----
const options = new VirtualAuthenticatorOptions();
options.setProtocol(Protocol.CTAP2);        // パスキー (FIDO2)
options.setTransport(Transport.INTERNAL);   // platform authenticator（パスキー/UVPA 用）
options.setHasResidentKey(true);            // Discoverable Credential
options.setHasUserVerification(true);       // UV 有効
options.setIsUserConsenting(true);          // 常に同意
options.setIsUserVerified(true);            // UV 済みとして扱う（UV 必須操作を成功させる）

await $webDriver.addVirtualAuthenticator(options);

const credentialList = await $webDriver.getCredentials();
if (credentialList.length === 0) {
  throw new Error('Passkey registration did not complete');
}
console.log('credentials:', credentialList);
console.log('Successfully signed in and created a passkey!');

// バイナリデータ(credentialId / userHandle / privateKey)のみ base64 化し、それぞれ個別に保存する
const cred = credentialList[0];
const passkeyCredentialId = Buffer.from(cred._id).toString('base64');
const passkeyUserHandle = cred._userHandle ? Buffer.from(cred._userHandle).toString('base64') : '';
const passkeyPrivateKey = Buffer.from(cred._privateKey, 'binary').toString('base64');
const passkeySignCount = cred._signCount;
const passkeyRpId = cred._rpId;
const passkeyIsResidentCredential = cred._isResidentCredential;

console.log('PASSKEY_CREDENTIAL_ID=' + passkeyCredentialId);
console.log('PASSKEY_USER_HANDLE=' + passkeyUserHandle);
console.log('PASSKEY_PRIVATE_KEY=' + passkeyPrivateKey);
console.log('PASSKEY_SIGN_COUNT=' + passkeySignCount);
console.log('PASSKEY_RP_ID=' + passkeyRpId);
console.log('PASSKEY_IS_RESIDENT_CREDENTIAL=' + passkeyIsResidentCredential);

await $webDriver.removeVirtualAuthenticator();

const { VirtualAuthenticatorOptions, Protocol, Transport, Credential } =
  require('selenium-webdriver/lib/virtual_authenticator');

// パスキーの各データを復元
// 一部に関してはSecure Credential(推奨)を利用すること推奨
const PASSKEY_CREDENTIAL_ID = 'BASE64_CREDENTIAL_ID'; //TODO 取得した値を設定
const PASSKEY_USER_HANDLE = 'BASE64_USER_HANDLE'; //TODO 取得した値を設定
const PASSKEY_PRIVATE_KEY = 'BASE64_PRIVATE_KEY'; //TODO 取得した値を設定
const PASSKEY_SIGN_COUNT = 1; //TODO 取得した値を設定
const PASSKEY_RP_ID = 'RP ID'; //TODO 取得した値を設定
const PASSKEY_IS_RESIDENT_CREDENTIAL = true; //TODO 取得した値を設定

// ---- 仮想認証器を用意（この時点では credential は登録しない） ----
const options = new VirtualAuthenticatorOptions();
options.setProtocol(Protocol.CTAP2);
options.setTransport(Transport.INTERNAL);
options.setHasResidentKey(true);
options.setHasUserVerification(true);
options.setIsUserConsenting(true);
options.setIsUserVerified(true);

await $webDriver.addVirtualAuthenticator(options);

// 個別の base64 値から Credential を復元する
function restoreCredential() {
  const id = new Uint8Array(Buffer.from(PASSKEY_CREDENTIAL_ID, 'base64'));
  const userHandle = PASSKEY_USER_HANDLE
    ? new Uint8Array(Buffer.from(PASSKEY_USER_HANDLE, 'base64'))
    : null;
  // privateKey は元がバイナリ文字列なので base64 → 'binary' 文字列に戻す
  const privateKey = Buffer.from(PASSKEY_PRIVATE_KEY, 'base64').toString('binary');
  return PASSKEY_IS_RESIDENT_CREDENTIAL
    ? Credential.createResidentCredential(id, PASSKEY_RP_ID, userHandle, privateKey, PASSKEY_SIGN_COUNT)
    : Credential.createNonResidentCredential(id, PASSKEY_RP_ID, privateKey, PASSKEY_SIGN_COUNT);
}

await $webDriver.addCredential(restoreCredential());

await $webDriver.removeVirtualAuthenticator();