f5xc-auth

Authentication library for F5 Distributed Cloud with XDG-compliant profile management.

Installation

npm install @robinmordasiewicz/f5xc-auth

Quick Start

import { HttpClient, ProfileManager } from '@robinmordasiewicz/f5xc-auth';

// Load profile
const profile = await ProfileManager.load('my-profile');

// Create authenticated HTTP client
const client = await HttpClient.create(profile);

// Make API call
const response = await client.get('/api/v1/namespace');

Features

• Multiple auth methods - API tokens, P12 certificates, cert/key pairs
• XDG-compliant storage - Profiles in ~/.config/f5xc/profiles/
• Environment override - Use env vars for CI/CD contexts
• URL normalization - Automatic tenant URL handling
• Pre-configured HTTP - Axios client with auth and retry logic
• TypeScript - Full type safety and IntelliSense support

Documentation

Full documentation: https://robinmordasiewicz.github.io/f5xc-auth/

• Authentication Guide
• API Reference
• Examples

Requirements

Node.js >= 18

Contributing

See CONTRIBUTING.md for development guidelines and automated release process.

License

MIT - see LICENSE