[UX] Design: Onboarding to fine-grained permissions

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

Release notes

Problem to solve

Once we have the ability for users to add and edit permissions on job tokens, we'll need a way to help users discover what permissions to select and apply to job tokens.

User Use Cases
Project owner and maintainer
  • When adding a group or project to allowlist
  • When editing a group or project in allowlist
  • When autopopulating all projects in allowlist
  • When autopopulating all projects in allowlist with compaction
Developer in downstream project
  • Remediate permission errors on job failures

What data is most valuable to users?

  • Historical API calls, successful and unsuccessful, last 30/60/90 days
  • Last used successful permissions
  • For groups in allowlist, add all historical or last used permissions from all projects?

Design Exploration

Figma

Flows Details

Adding a new project

Screenshot 2025-03-11 at 2.11.14 PM.png

Screenshot 2025-03-11 at 2.11.14 PM.png

  • When selecting fine-grained permissions, add information alert to show permissions data and apply suggested permissions
  • Screenshot 2025-03-11 at 1.29.28 PM.png
  • Clicking show history will bring up panel of suggested permissions
  • User can apply suggested permissions with one click and can make adjustments as needed
  • Clicking apply suggested permissions will bring up panel of suggested permissions with permissions applied
Editing a project and continuous permission suggestion
  • Permission suggestion will appear next to projects with default permissions and those projects that can reduce current permission settings

Screenshot 2025-03-11 at 2.11.14 PM.png

  • User can apply suggested permissions
Add a new group
  • When selecting fine-grained permissions, add information alert to show permissions data and apply suggested permissions

  • Suggested permissions show project detail

    Screenshot 2025-03-11 at 2.28.55 PM.png

Permission error in log
  • Permission due to job token error
With group and project autopopulation

Without compaction:

  • Select permissions for all projects
  • Screenshot 2025-03-11 at 2.14.50 PM.png

With compaction:

  • Groups must be set to default, while projects can use permission data

Screenshot 2025-03-11 at 2.16.14 PM.png

Edited by 🤖 GitLab Bot 🤖