magic-link-auth-companion

Manage magic-link authentication with HMAC-SHA256 signing and token revocation.

Updated May 18, 2025
One-click install
npx skills add https://github.com/ki2pixel/render_signal_server --skill magic-link-auth-companion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: magic-link-auth-companion
Source: https://github.com/ki2pixel/render_signal_server/tree/main/.windsurf/skills/magic-link-auth-companion
Command: npx skills add https://github.com/ki2pixel/render_signal_server --skill magic-link-auth-companion

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manage MagicLinkService changes across backend, storage (Redis/external), and dashboard UI while enforcing security, TTL, and revocation requirements.

Core Features & Use Cases

  • Maintain a singleton Python service for magic links, with HMAC-SHA256 signing and configurable TTL.
  • Synchronize configuration across Redis-backed storage and external backends, updating API responses and UI behavior.
  • Provide a CLI utility (revoke_magic_links.py) to revoke all tokens or a specific token.

Quick Start

Update the magic-link service configuration and run the revocation tool to revoke tokens when needed.

Frequently Asked Questions about magic-link-auth-companion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I revoke a magic link token before its TTL expires?

You can revoke a magic link token using the provided CLI utility. This tool allows you to instantly revoke a specific token or all active tokens, overriding their configured TTL and invalidating access across your backend and dashboard.

How does HMAC-SHA256 signing secure magic link authentication?

HMAC-SHA256 signing secures magic link authentication by generating a cryptographic signature for each token. This singleton service validates the signature against backend storage to prevent tampering and unauthorized access.

Can I synchronize magic link configurations between Redis and external backends?

Yes, the service synchronizes magic link configurations between Redis-backed storage and external backends. This ensures that TTL enforcement and revocation workflows consistently update API responses and UI behavior across systems.

What is the best way to enforce token TTL for magic links in a Python backend?

The best way to enforce token TTL for magic links is by using a singleton service with configurable expiration settings. It automatically manages token validation and synchronization across Redis and external backends.

Do I need Redis to manage magic link revocation and environment validation?

Redis is used as the primary storage backend for synchronizing token states. The service also performs environment validation to ensure secure HMAC-SHA256 signing and TTL enforcement before executing revocation workflows.

What are the limitations of using a singleton service for magic link authentication?

A singleton service limits magic link authentication to a single active instance per process. While it ensures consistent HMAC-SHA256 signing and TTL enforcement, you must manage synchronization carefully across distributed backend environments.