goharbor/harbor

Permission Annotations in Swagger

Aberta

#21.734 aberto em 13 de mar. de 2025

Ver no GitHubGuia do colaborador
 (3 comentários) (0 reação) (0 responsável)Go (5.235 forks)batch import
backloghelp wantedkind/questionkind/requirement

Métricas do repositório

Stars
 (28.490 estrelas)
Métricas de merge de PR
 (Métricas PR pendentes)

Description

Is your feature request related to a problem? Please describe. I am trying to write scripts using the API v2.0 and a Robot account, but I keep getting 403 Forbidden responses.

Describe the solution you'd like It would be helpful if in the Swagger file, you could identify "Permissions required: System-wide Project/List, Project-level Project/Read"

Describe the main design/architecture of your solution

Image

Describe the development plan you've considered While this may introduce a mild security risk ("I have permission to do X, therefore, I could also do Y"), it may help developers to identify where additional permission controls should be placed.

Guia do colaborador

Direção de pesquisa
Examine a especificação Swagger existente e o modelo de permissão na API do Harbor para identificar quais endpoints exigem quais permissões e, em seguida, adicione anotações ao arquivo Swagger.
Pilha de tecnologia
go
Domain
backendapi
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Swagger/OpenAPIGo
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
75