Skip to content

Add description on how 3rd-party dependency security issues are handled#61956

Merged
potiuk merged 3 commits intoapache:mainfrom
potiuk:add-description-on-handling-3rd-party-dependencies
Feb 16, 2026
Merged

Add description on how 3rd-party dependency security issues are handled#61956
potiuk merged 3 commits intoapache:mainfrom
potiuk:add-description-on-handling-3rd-party-dependencies

Conversation

@potiuk
Copy link
Member

@potiuk potiuk commented Feb 15, 2026

Our users seem to not have a good idea on how 3rd-party dependencies are handled and how they should approach it and open issues that are often closed and we need to explain them what is expected of them - they have pretty unrealistic expecations that every single CVE in every single dependency will be addressed when they open an issue.

This description clarifies how handling of 3rd-party dependency issues should be done and what are responsibilities and expectations of the users, and what they can expect from the maintainers.

This will help us to direct such users to this process without spending our time on explaining it over and over again.


Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

  • Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
  • For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst or {issue_number}.significant.rst, in airflow-core/newsfragments.

Copy link
Collaborator

@aritra24 aritra24 left a comment

Choose a reason for hiding this comment

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

A few typos/sentence restructuring. Lgtm in general

@potiuk
Copy link
Member Author

potiuk commented Feb 15, 2026

Applied all comments - also added a more detailed information on how to look at some dependency issues.

Not many people know that we have great tool that can aid with finding out what is holding some dependencies:

breeze release-management constraints-version-check --python 3.10 --package PACKAGE_NAME --explain-why

This one can be used by whoever wants to look at specific dependency to know why it cannot be upgraded - and while its pretty technical, it's a goog start to make our users engaged in solving the issues - if they will open the discussion where they will run the tool and submit the output - even if they wont' be the able to understand exactly why - we can explain them and ask them to work on fixing it.

@potiuk potiuk force-pushed the add-description-on-handling-3rd-party-dependencies branch from 261bc69 to a4be6ca Compare February 15, 2026 18:10
Copy link
Collaborator

@aritra24 aritra24 left a comment

Choose a reason for hiding this comment

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

Looks good to me, a good addition to get the community engaged in the right direction!

@potiuk
Copy link
Member Author

potiuk commented Feb 15, 2026

Also .. it turned out that we have very similar (but more generic) approach ASF-wide https://security.apache.org/report-dependency/ (I did not know)

I will refer to it :)

Our users seem to not have a good idea on how 3rd-party dependencies
are handled and how they should approach it and open issues that are
often closed and we need to explain them what is expected of them -
they have pretty unrealistic expecations that every single CVE in
every single dependency will be addressed when they open an issue.

This description clarifies how handling of 3rd-party dependency
issues should be done and what are responsibilities and expectations
of the users, and what they can expect from the maintainers.

This will help us to direct such users to this process without
spending our time on explaining it over and over again.

Apply suggestions from code review

Co-authored-by: Jens Scheffler <95105677+jscheffl@users.noreply.github.com>
@potiuk potiuk force-pushed the add-description-on-handling-3rd-party-dependencies branch from a4be6ca to fcecb1f Compare February 15, 2026 19:38
…encies.rst

Co-authored-by: Shahar Epstein <60007259+shahar1@users.noreply.github.com>
…encies.rst

Co-authored-by: Amogh Desai <amoghrajesh1999@gmail.com>
@potiuk potiuk merged commit caa02fd into apache:main Feb 16, 2026
65 checks passed
@potiuk potiuk deleted the add-description-on-handling-3rd-party-dependencies branch February 16, 2026 12:46
potiuk added a commit that referenced this pull request Feb 16, 2026
…ed (#61956)

* Add description on how 3rd-party dependency security issues are handled

Our users seem to not have a good idea on how 3rd-party dependencies
are handled and how they should approach it and open issues that are
often closed and we need to explain them what is expected of them -
they have pretty unrealistic expecations that every single CVE in
every single dependency will be addressed when they open an issue.

This description clarifies how handling of 3rd-party dependency
issues should be done and what are responsibilities and expectations
of the users, and what they can expect from the maintainers.

This will help us to direct such users to this process without
spending our time on explaining it over and over again.

Apply suggestions from code review

Co-authored-by: Jens Scheffler <95105677+jscheffl@users.noreply.github.com>

* Update airflow-core/docs/security/vulnerabilities-in-3rd-party-dependencies.rst

Co-authored-by: Shahar Epstein <60007259+shahar1@users.noreply.github.com>

* Update airflow-core/docs/security/vulnerabilities-in-3rd-party-dependencies.rst

Co-authored-by: Amogh Desai <amoghrajesh1999@gmail.com>

---------

Co-authored-by: Jens Scheffler <95105677+jscheffl@users.noreply.github.com>
Co-authored-by: Shahar Epstein <60007259+shahar1@users.noreply.github.com>
Co-authored-by: Amogh Desai <amoghrajesh1999@gmail.com>
(cherry picked from commit caa02fd)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:production-image Production image improvements and fixes kind:documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants