authentication-patterns

## Table of Contents - [Overview](#overview) - [When to Use](#when-to-use) - [Authentication Methods](#authentication-methods) - [Quick Start](#quick-start) - [Verify Authentication](#verify-authentication) - [Smoke Test](#smoke-test) - [Standard Flow](#standard-flow) - [Step 1: Check Environment](#step-1:-check-environment) - [Step 2: Verify with Service](#step-2:-verify-with-service) - [Step 3: Handle Failures](#step-3:-handle-failures) - [Integration Pattern](#integration-pattern) - [Detailed Resources](#detailed-resources) - [Exit Criteria](#exit-criteria) # Authentication Patterns ## Overview Common authentication patterns for integrating with external services. Provides consistent approaches to credential management, verification, and error handling. ## When To Use - Integrating with external APIs - Need credential verification - Managing multiple auth methods - Handling auth failures gracefully ## When NOT To Use - Project doesn't use the leyline infrastructure patterns - Simple scripts without service architecture needs ## Authentication Methods | Method | Best For | Environment Variable | |--------|----------|---------------------| | API Key | Simple integrations | `{SERVICE}_API_KEY` | | OAuth | User-authenticated | Browser-based flow | | Token | Session-based | `{SERVICE}_TOKEN` | | None | Public APIs | N/A | ## Quick Start ### Verify Authentication ```python from leyline.auth import verify_auth, AuthMethod # API Key verification status = verify_auth(...