Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Api auth required openapi #10971

Draft
wants to merge 2 commits into
base: develop
Choose a base branch
from
Draft

Api auth required openapi #10971

wants to merge 2 commits into from

Conversation

jp-tosca
Copy link
Contributor

What this PR does / why we need it:
There was a conversation on zullip at for the need of documenting the authentication requirements on the OpenAPI specification.

Which issue(s) this PR closes:

@jp-tosca jp-tosca self-assigned this Oct 25, 2024
@jp-tosca jp-tosca added Size: 3 A percentage of a sprint. 2.1 hours. Size: 0.5 A percentage of a sprint. 0.35 hours and removed Size: 3 A percentage of a sprint. 2.1 hours. labels Oct 25, 2024
@coveralls
Copy link

Coverage Status

coverage: 20.88% (-0.001%) from 20.881%
when pulling 8de2956 on api_auth_required_openapi
into 03538f0 on develop.

@@ -1269,6 +1270,7 @@ private String getWebappImageResource(String imageName) {
})
@Tag(name = "saveAuxiliaryFileWithVersion",
description = "Save Auxiliary File With Version")
@SecurityRequirement(name = "api_token")
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why is it "api_token" and not "API token" or "API_Token" or whatever else? Is it arbitrary?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems that we also have to define the "security schema" and we name that security schema, we also set a type. The security schema could be named something else but in this case api_key is the name

@cmbz cmbz added the FY25 Sprint 9 FY25 Sprint 9 (2024-10-23 - 2024-11-06) label Oct 30, 2024
@cmbz cmbz added the FY25 Sprint 10 FY25 Sprint 10 (2024-11-06 - 2024-11-20) label Nov 12, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
FY25 Sprint 9 FY25 Sprint 9 (2024-10-23 - 2024-11-06) FY25 Sprint 10 FY25 Sprint 10 (2024-11-06 - 2024-11-20) Size: 0.5 A percentage of a sprint. 0.35 hours
Projects
Status: In Progress 💻
Development

Successfully merging this pull request may close these issues.

OpenAPI authentication docs
4 participants