What should I do if I receive a 401 Unauthorized error?

The skill includes a debugging checklist to help you verify if Keycloak is running, if the token has expired, or if there is a mismatch in your JWT secret configuration.

Does this skill support POST requests with data?

Absolutely. It provides specific patterns for sending JSON payloads, workflow start parameters, and even multipart form-data for file uploads.

How does this skill handle Keycloak authentication?

It uses a specialized script to fetch a refresh token from Keycloak using test credentials, signs it with a local secret from your configuration, and attaches it as a cookie to your requests.

Can I test routes that require specific user roles?

Yes, you can use the Mock Authentication feature during development to define custom user IDs and specific roles like 'admin' or 'operations' to test role-based access control.

Route Tester & Auth Validator

Name: Route Tester & Auth Validator
Author: Activer007

byActiver007

0•

Security & Testing

Automates the testing and validation of authenticated API routes using cookie-based JWT authentication and Keycloak integration.

The Route Tester skill streamlines the process of verifying protected API endpoints within your project. It provides automated patterns for generating signed JWT tokens via Keycloak, handling cookie-based authentication, and executing various HTTP methods from simple GETs to complex POST requests. Whether you are debugging 401/403 errors, testing new workflow endpoints, or verifying database changes after a request, this skill offers comprehensive guidance on using specialized scripts and mock authentication to ensure your services remain secure and functional during development.

Key Features

01Automatic generation of manual curl commands for easy issue reproduction.

02Automated cookie-based JWT token generation and signing via Keycloak.

03Comprehensive troubleshooting guides for 401, 403, 404, and 500 status codes.

04Mock authentication patterns for rapid development and role-based testing.

05Support for complex POST/PUT requests with JSON payloads and file uploads.

060 GitHub stars

Use Cases

01Verifying database integrity and state changes after executing authenticated requests.

02Debugging complex workflow submissions and multi-step form completions in a local environment.

03Testing new API endpoints before deployment to ensure proper authorization and functionality.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activer007/ordinary-claude-skills route-tester

For use in Claude.ai and ChatGPT

Download Skill