ld-permissions

Centralize Lightdash CASL-based authorization scopes, roles, and enforcement workflows.

6.0k|759|Updated Mar 19, 2021
One-click install
npx skills add https://github.com/lightdash/lightdash --skill ld-permissions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ld-permissions
Source: https://github.com/lightdash/lightdash/tree/main/.claude/skills/ld-permissions
Command: npx skills add https://github.com/lightdash/lightdash --skill ld-permissions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Permissions & Authorization Guide consolidates Lightdash's CASL-based authorization concepts, helping teams understand and implement scopes, permissions, and custom roles across both backend and frontend contexts.

Core Features & Use Cases

  • Centralizes scope definitions, role mappings, and CASL integration to streamline access control design.
  • Aids debugging when a user cannot access a resource by verifying scopes, roles, and conditions.
  • Enables building new permissions and testing enforcement in both server and client code paths.

Quick Start

Ask the AI to walk through adding a new scope and to verify that a user with a specific role can access a Dashboard within a project.

Frequently Asked Questions about ld-permissions

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

FAQPage Schema
How do I add a new permission scope in Lightdash using CASL?

To add a new permission scope in Lightdash using CASL, you centralize the scope definitions within the authorization guidelines. This involves updating the role mappings and CASL integration to enforce the new access control rules across both backend and frontend workflows.

Why does a user with a specific role lack access to a Dashboard in Lightdash?

A user lacks Dashboard access in Lightdash when their assigned role does not include the required CASL permission scopes or conditions. Debugging involves verifying the user's role mappings and checking the enforced authorization rules within the project context.

How does CASL authorization work across frontend and backend in Lightdash?

CASL authorization in Lightdash works by centralizing scope definitions and role mappings to enforce access controls. It applies these permission rules consistently across both frontend and backend code paths to ensure secure resource management.

Do I need external dependencies to manage custom roles in Lightdash?

No external installation is required to manage custom roles in Lightdash. The authorization guidelines reference existing code locations like packages/common/src/authorization to apply role management and CASL controls directly.

Can I test CASL permission enforcement in server and client code paths?

Yes, you can test CASL permission enforcement in both server and client code paths. The centralized authorization guidelines enable building new permissions and verifying enforcement scenarios across the entire Lightdash workflow.

What is the best way to design custom roles for Lightdash projects?

The best way to design custom roles for Lightdash projects is by using the centralized CASL authorization guidelines. This approach streamlines access control design by mapping scopes to specific roles and verifying enforcement conditions.