Skip to content

Commit b00ec3e

Browse files
diwoodruffwfacutuescath3cooprawktron
authored
Document additional Trusted Publishers (#15192)
* docs/user: empty sections for more publishers Signed-off-by: William Woodruff <[email protected]> * Fix headings * Add provider TODOs to using-a-publisher.md * Move images into provider-specific directories * Update GitHub screenshots * Fix asset links * Update admonition to match * Remove unnecessary quoting * Google Trusted Publishing docs (#15195) * Google Trusted Publishing docs * Update docs/user/trusted-publishers/security-model.md Co-authored-by: Facundo Tuesca <[email protected]> * Update docs/user/trusted-publishers/security-model.md Co-authored-by: Facundo Tuesca <[email protected]> * Apply suggestions from code review Co-authored-by: William Woodruff <[email protected]> * Apply suggestions from code review --------- Co-authored-by: Facundo Tuesca <[email protected]> Co-authored-by: William Woodruff <[email protected]> * Add Google screenshots * Fix provider-specific screenshots * Add GitLab Trusted Publishing docs (#15283) * Add GitLab Trusted Publishing docs * Add screenshots to GitLab Trusted Publishing docs * Fix instructions for GitLab CI with Trusted Publishing * Add activestate OIDC docs (#15548) * First draft of ActiveState Trusted Publishing docs * Add ActiveState Security Model and Considerations * Adding examples * Add link to ActiveState hosted OIDC docs * Add updated docs from Andrew * MD tweaks and some images * Add remaining screenshots and embbed them in MD * Tweaking instructions for publishing * Update warehouse/templates/manage/account/publishing.html Co-authored-by: William Woodruff <[email protected]> * Review edit Co-authored-by: Dustin Ingram <[email protected]> * Review edits Co-authored-by: Dustin Ingram <[email protected]> * Review edits Co-authored-by: Dustin Ingram <[email protected]> * Review edits Co-authored-by: Dustin Ingram <[email protected]> * Review edits Co-authored-by: Dustin Ingram <[email protected]> * Translations * Fix build script tokens, link to supported platforms * Revise and reformat ActiveState using instructions --------- Co-authored-by: Pete Garcin <[email protected]> Co-authored-by: William Woodruff <[email protected]> Co-authored-by: Dustin Ingram <[email protected]> * Slugify tab anchors * Add blogpost announcing more trusted publishers (#15656) * Fix old byline * Add blogpost announcing more trusted publishers * Update docs/blog/posts/2024-04-20-expanding-trusted-publisher-support.md Co-authored-by: Mike Fiedler <[email protected]> * Apply suggestions from code review --------- Co-authored-by: Mike Fiedler <[email protected]> * Updating ActiveState publishing docs (#15739) * Updating ActiveState publishing docs * Update docs/user/trusted-publishers/using-a-publisher.md Co-authored-by: Dustin Ingram <[email protected]> --------- Co-authored-by: Dustin Ingram <[email protected]> * Update publish date * Update line for consistency * Update tabbed headings to not appear in ToC * Wrap long lines * Consistency fix * Line break * Strip out leading $ * Make note conform * Translations * Add border to images * Update screenshot * Dark mode CSS doesn't work as expected * Add alt text * Update publication date * Fix ActiveState getting started Trusted Publisher links (#15801) * Fix ActiveState getting started Trusted Publisher links * REALLY fix ActiveState getting started Trusted Publisher links --------- Signed-off-by: William Woodruff <[email protected]> Co-authored-by: William Woodruff <[email protected]> Co-authored-by: Facundo Tuesca <[email protected]> Co-authored-by: William Woodruff <[email protected]> Co-authored-by: Carey Hoffman <[email protected]> Co-authored-by: Pete Garcin <[email protected]> Co-authored-by: Mike Fiedler <[email protected]> Co-authored-by: Pete Garcin <[email protected]>
1 parent 91d632e commit b00ec3e

35 files changed

+660
-86
lines changed

docs/blog/posts/2023-04-20-introducing-trusted-publishers.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -112,8 +112,7 @@ providing valuable feedback to improve this feature along the way.
112112

113113
---
114114

115-
_Dustin Ingram is a maintainer of the Python Package Index and a director of
116-
the Python Software Foundation._
115+
_Dustin Ingram is a maintainer of the Python Package Index._
117116

118117
[^1]: Currently, information such as this are provided by the uploader and are not verified as accurate by PyPI.
119118
[OpenID Connect (OIDC)]: https://openid.net/connect/
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
title: Expanding Trusted Publisher Support
3+
description: Announcing additional Trusted Publishing providers
4+
authors:
5+
- di
6+
date: 2024-04-17
7+
tags:
8+
- publishing
9+
- security
10+
- oidc
11+
---
12+
13+
Starting today, PyPI package maintainers can publish via Trusted Publishing
14+
from three additional providers:
15+
16+
* GitLab CI/CD
17+
* Google Cloud
18+
* ActiveState
19+
20+
These providers join existing support for publishing from GitHub Actions without
21+
long-lived passwords or API tokens, which [we announced last year], and bring
22+
support for Trusted Publishing to even more hosted providers.
23+
24+
<!-- more -->
25+
26+
### About Trusted Publishing
27+
28+
Trusted Publishing is our term for using the [OpenID Connect (OIDC)] standard
29+
to exchange short-lived identity tokens between a trusted third-party service
30+
and PyPI. This method can be used in automated environments and eliminates the
31+
need to use username/password combinations or long-lived, manually generated
32+
API tokens to authenticate with PyPI when publishing.
33+
34+
Instead, maintainers can configure PyPI to trust an identity provided by a
35+
given OpenID Connect Identity Provider (IdP). This allows allows PyPI to verify
36+
and delegate trust to that identity, which is then authorized to request
37+
short-lived, tightly-scoped API tokens from PyPI. These API tokens never need
38+
to be stored or shared, rotate automatically by expiring quickly, and provide a
39+
verifiable link between a published package and its source.
40+
41+
### Get started today
42+
43+
To get started with using trusted publishers on PyPI, see our documentation
44+
here: <https://docs.pypi.org/trusted-publishers/>.
45+
46+
### Acknowledgements
47+
48+
Funding for work implementing Google Cloud and GitLab support was provided by
49+
the Google Open Source Security Team, and much of the development work was
50+
performed by [Trail of Bits], with special thanks to contributors [William
51+
Woodruff] and [Facundo Tuesca].
52+
53+
ActiveState support was provided by ActiveState, with special thanks to
54+
contributors [Carey Hoffman] and [Pete Garcin].
55+
56+
---
57+
58+
_Dustin Ingram is a maintainer of the Python Package Index._
59+
60+
[we announced last year]: 2023-04-20-introducing-trusted-publishers.md
61+
[William Woodruff]: https://github.com/woodruffw
62+
[Facundo Tuesca]: https://github.com/facutuesca
63+
[Carey Hoffman]: https://github.com/th3coop
64+
[Pete Garcin]: https://github.com/rawktron
65+
[OpenID Connect (OIDC)]: https://openid.net/connect/
66+
[Trail of Bits]: https://www.trailofbits.com/

docs/mkdocs-user-docs.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ markdown_extensions:
1414
- pymdownx.superfences
1515
- pymdownx.tabbed:
1616
alternate_style: true
17+
slugify: !!python/object/apply:pymdownx.slugs.slugify {kwds: {case: lower}}
1718
- tables
1819
theme:
1920
name: material
-113 KB
Binary file not shown.
-116 KB
Binary file not shown.
-92.4 KB
Binary file not shown.
-114 KB
Binary file not shown.
151 KB
Loading
209 KB
Loading
113 KB
Loading

0 commit comments

Comments
 (0)