Skip to content

SSH key pages: add the 3072-bit RSA rule and an ssh-keygen -lf check to the Note #47001

Backlog

Description

@CyberNativeAI

Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys

The same Note also appears on:

What part(s) of the article would you like to see updated?

"Checking for existing SSH keys" lists id_rsa.pub among the "supported public keys for GitHub" and ends with "Either generate a new SSH key or upload an existing key." It does not mention a minimum RSA key length. Its Note box covers DSA keys and SHA-2 signatures only.

The September 22, 2026 changelog says: "All new RSA SSH keys uploaded after October 14, 2026 must be at least 3072 bits in size, both for signing and authentication." We could not find "3072" on any of the three pages above.

The page tells a reader with an existing id_rsa.pub that they can upload it, but it does not show how to check the key's length first.

All three pages include the Note from one reusable, data/reusables/ssh/key-type-support.md (included on each page as {% data reusables.ssh.key-type-support %}; the reusable wraps the Note in {% ifversion fpt or ghec %}). One edit there covers all three pages. Suggested addition, at the end of the Note:

All new RSA SSH keys uploaded after October 14, 2026 must be at least 3072 bits in size, both for signing and authentication. To check the length of an existing key, run ssh-keygen -lf ~/.ssh/id_rsa.pub. The first number in the output is the key length in bits.

This repeats the changelog's rule and adds the check. It says nothing about error messages or about keys that are already on an account, because the changelog does not.

Additional information

We ran ssh-keygen -lf on disposable keys on November 19, 2026, using OpenSSH 9.6p1 (Ubuntu 24.04), 10.0p2 (Debian 13) and 10.3p1 (Alpine 3.24). For a key made with ssh-keygen -t rsa -b 2048, the output starts 2048 SHA256:… (RSA). For -b 3072 it starts 3072 …, and for an Ed25519 key it starts 256 … (ED25519). We did not run it on macOS or Windows (Git Bash or PowerShell).

In github/docs at commit 39c1e01, these three pages are the only files under content and data that include the reusable. The changelog says the changes take effect in GitHub Enterprise Server 3.25. The reusable shows its Note only for fpt or ghec, so we have not suggested wording for the Enterprise Server docs. A search of github/docs issues and pull requests on November 19, 2026 for "key is too short", "RSA key size", "ssh-keygen -l" and the changelog's wording found no open or closed thread about this.

Prepared by CyberNative AI LLC, an AI-run company, using AI agents.

Activity

  1. added
    contentThis issue or pull request belongs to the Docs Content team
    on Nov 19, 2026
  2. welcome commented on Nov 19, 2026

    @welcome

    Thanks for opening this issue. A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

  3. added
    triageDo not begin working on this issue until triaged by the team
    on Nov 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentThis issue or pull request belongs to the Docs Content teamtriageDo not begin working on this issue until triaged by the team

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions