Skip to content

Conversation

@vincbeck
Copy link
Contributor

@vincbeck vincbeck commented Mar 26, 2025

Add documentation to explain how to generate a JWT token needed to call Airflow public API. I also enabled the authentication section in the openapi documentation. I added a description in it to help users to authenticate their calls.

As part of this PR, I also mandate auth managers to provide an endpoint to generate a JWT token. This endpoint must be POST /auth/token. Forcing auth managers to have this specific endpoint will help users to generate a JWT token. Having different endpoints across auth managers would not be consistent and would be confusing for users.

Screenshot 2025-03-26 at 2 51 10 PM

^ Add meaningful description above
Read the Pull Request Guidelines for more information.
In case of fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
In case of a new dependency, check compliance with the ASF 3rd Party License Policy.
In case of backwards incompatible changes please leave a note in a newsfragment file, named {pr_number}.significant.rst or {issue_number}.significant.rst, in airflow-core/newsfragments.

@boring-cyborg boring-cyborg bot added area:API Airflow's REST/HTTP API kind:documentation labels Mar 26, 2025
@vincbeck vincbeck requested review from jedcunningham and pierrejeambrun and removed request for pierrejeambrun March 26, 2025 18:55
@vincbeck vincbeck force-pushed the vincbeck/doc_token branch from 9641cb0 to f067d2e Compare March 27, 2025 14:26
Copy link
Member

@pierrejeambrun pierrejeambrun left a comment

Choose a reason for hiding this comment

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

Nice thanks, just a few suggestions but non blocking

Co-authored-by: Pierre Jeambrun <pierrejbrun@gmail.com>
@vincbeck vincbeck merged commit d596f4d into apache:main Mar 27, 2025
89 checks passed
@vincbeck vincbeck deleted the vincbeck/doc_token branch March 27, 2025 17:46
pankajkoti pushed a commit to astronomer/airflow that referenced this pull request Mar 28, 2025
shubham-pyc pushed a commit to shubham-pyc/airflow that referenced this pull request Apr 2, 2025
nailo2c pushed a commit to nailo2c/airflow that referenced this pull request Apr 4, 2025
simonprydden pushed a commit to simonprydden/airflow that referenced this pull request Apr 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:API Airflow's REST/HTTP API kind:documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants