Skip to content

docs(security): consolidate deployment and integration guidance - #597

Merged
nijel merged 1 commit into
masterfrom
security
Oct 20, 2026
Merged

nijel merged 1 commit into
masterfrom
security

Conversation

@nijel

@nijel nijel commented Oct 20, 2026

Copy link
Copy Markdown
Member

Give operational security guidance a canonical home outside the package threat models. Fill signed-flow and configuration gaps and link shared requirements to their detailed topic pages.

Give operational security guidance a canonical home outside the package threat models. Fill signed-flow and configuration gaps and link shared requirements to their detailed topic pages.
@nijel nijel self-assigned this Oct 20, 2026
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 20, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-20T12:49:10.180644Z 49c73c7 PR opened
🔒 Security Review ✅ Completed 2026-10-20T12:40:31.840852Z 49c73c7 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@read-the-docs-community

Copy link
Copy Markdown

@nijel
nijel merged commit 46f32d7 into master Oct 20, 2026
6 checks passed
@nijel
nijel deleted the security branch October 20, 2026 12:45

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 49c73c77a7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +550 to +552
email and username login forms have no provider callback proof: submit them to
``social:complete`` using a CSRF-protected POST instead. Do not exempt these
forms or expose an alternate completion route bypassing validation.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Route local forms through a genuinely CSRF-protected view

The documented social:complete view cannot provide the promised CSRF protection: social_django.views.complete is decorated with @csrf_exempt for every backend, so Django ignores a submitted CSRF token. An application following this advice for the legacy email or username backends therefore remains vulnerable to login CSRF despite appearing correctly configured. Document a separate @csrf_protect completion view for these local forms, or change the integration before recommending this route.

Useful? React with 👍 / 👎.

Applications requiring login-CSRF or account-linking replay protection must add
an application-controlled initiation and single-use binding before completing
the login or association. Preserve the initiating authenticated local user
through account linking. Serve the application and widget callback over HTTPS.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Use HTTPS in the Telegram callback examples

This new requirement conflicts with both canonical callback examples immediately above, which still use http://example.com/complete/telegram/, including the copyable data-auth-url. A user following the setup steps can therefore transmit a replayable signed callback over cleartext despite the security section requiring HTTPS; update both examples to use https://.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant