hadrian-openapi-authz

Generate Hadrian auth.yaml and roles.yaml from OpenAPI, GraphQL SDL, or gRPC proto specifications.

73|4|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/praetorian-inc/hadrian --skill hadrian-openapi-authz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hadrian-openapi-authz
Source: https://github.com/praetorian-inc/hadrian/tree/main/skills/hadrian-openapi-authz
Command: npx skills add https://github.com/praetorian-inc/hadrian --skill hadrian-openapi-authz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill generates Hadrian-ready authorization templates (auth.yaml and roles.yaml) from API specifications (OpenAPI/Swagger for REST, GraphQL SDL, or gRPC proto), eliminating manual configuration drift.

Core Features & Use Cases

  • Generates separate auth.yaml and roles.yaml files with a robust RBAC scaffolding.
  • Infers object mappings and owner_field details to support BOLA/IDOR testing and endpoint alignment.
  • Supports REST, GraphQL, and gRPC specs to produce Hadrian-ready templates for secure testing workflows.

Quick Start

Provide an API specification (OpenAPI/Swagger, GraphQL SDL, or gRPC proto) and run the skill to generate Hadrian-ready auth.yaml and roles.yaml.

Frequently Asked Questions about hadrian-openapi-authz

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

FAQPage Schema
How do I generate Hadrian auth.yaml and roles.yaml from an OpenAPI spec?

To generate Hadrian auth.yaml and roles.yaml from an OpenAPI spec, provide your API specification to the skill. It outputs separate RBAC scaffolding files, placing credentials in auth.yaml and roles in roles.yaml for automated authorization checks.

What is BOLA testing and how do API specs support it?

BOLA testing identifies Broken Object Level Authorization vulnerabilities. API specs support it by providing endpoint parameters and object mappings, which this skill uses to infer owner_field details and generate role mappings for targeted authorization checks.

Can I use GraphQL SDL to create RBAC scaffolding for security testing?

Yes, you can use GraphQL SDL to create RBAC scaffolding. The skill processes GraphQL SDL alongside REST OpenAPI and gRPC proto inputs to generate Hadrian-ready auth.yaml and roles.yaml files for security testing.

How do I separate credentials and roles when testing API authorization?

To separate credentials and roles when testing API authorization, use this skill to generate distinct auth.yaml and roles.yaml files. This ensures separation of concerns by isolating credentials in auth.yaml and role mappings in roles.yaml.

Does gRPC proto work for generating role mappings and authorization checks?

Yes, gRPC proto works for generating role mappings and authorization checks. The skill accepts gRPC proto definitions to infer object mappings and produce Hadrian-ready templates, validating owner_field on parameterized endpoints.