playwright-client-certificate-login v0.0.3

Playwright Client Certificate Authentication

A Node.js utility for authenticating using client certificates via Playwright.

Installation

npm install playwright-client-certificate-login

Usage

const { CertificateAuthSession } = require('playwright-client-certificate-login');

// Using PFX/PKCS12 certificate
const options = {
  origin: 'https://your-domain.com',
  url: 'https://your-domain.com/path',
  pfxPath: '/path/to/your/certificate.pfx',
  passphrase: 'your-certificate-passphrase'
};

// Or using separate cert and key files
const options = {
  origin: 'https://your-domain.com',
  url: 'https://your-domain.com/path',
  certPath: '/path/to/your/certificate.pem',
  keyPath: '/path/to/your/private-key.pem',
  passphrase: 'your-key-passphrase'
};

async function authenticate() {
  const session = new CertificateAuthSession(options);
  try {
    await session.authenticate();
    
    // Access authenticated session data
    const cookies = session.getCookies();
    const headers = session.getHeaders();
    const browser = session.getBrowser();
    const context = session.getContext();
    const page = session.getPage();
    
    console.log('Authentication successful:', cookies);
    
    // Don't forget to close the session
    await session.close();
  } catch (error) {
    console.error('Authentication failed:', error);
  }
}

API Reference

Class: CertificateAuthSession

Constructor Options

* You must provide either:

• pfxPath or pfxBuffer, OR
• Both certPath and keyPath, OR
• Both certBuffer and keyBuffer

Methods

Error Handling

The class will throw an error if:

• Required options are missing
• Certificate files cannot be read
• Authentication process fails
• Page load timeout is exceeded