2.6 KiB
| type | stage | group | info |
|---|---|---|---|
| reference, howto | Manage | Access | To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments |
Restrict allowed SSH key technologies and minimum length (FREE SELF)
ssh-keygen allows users to create RSA keys with as few as 768 bits, which
falls well below recommendations from certain standards groups (such as the US
NIST). Some organizations deploying GitLab need to enforce minimum key
strength, either to satisfy internal security policy or for regulatory
compliance.
Similarly, certain standards groups recommend using RSA, ECDSA, or ED25519 over the older DSA, and administrators may need to limit the allowed SSH key algorithms.
GitLab allows you to restrict the allowed SSH key technology as well as specify the minimum key length for each technology:
-
On the top bar, select Menu > Admin.
-
On the left sidebar, select Settings > General (
/admin/application_settings/general). -
Expand the Visibility and access controls section:
If a restriction is imposed on any key type, users cannot upload new SSH keys that don't meet the requirement. Any existing keys that don't meet it are disabled but not removed and users cannot to pull or push code using them.
An icon is visible to the user of a restricted key in the SSH keys section of their profile:
Hovering over this icon tells you why the key is restricted.
Default settings
By default, the GitLab.com and self-managed settings for the supported key types are:
- RSA SSH keys are allowed.
- DSA SSH keys are forbidden (since GitLab 11.0).
- ECDSA SSH keys are allowed.
- ED25519 SSH keys are allowed.