debian-mirror-gitlab/doc/security/password_storage.md

45 lines
2.8 KiB
Markdown
Raw Normal View History

2019-12-04 20:38:33 +05:30
---
2021-09-04 01:27:46 +05:30
stage: Manage
2022-04-04 11:22:00 +05:30
group: Authentication and Authorization
2022-11-25 23:54:43 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2019-12-04 20:38:33 +05:30
type: reference
---
2022-11-25 23:54:43 +05:30
# Password and OAuth token storage **(FREE)**
GitLab administrators can configure how passwords and OAuth tokens are stored.
## Password storage
2019-12-04 20:38:33 +05:30
2023-01-13 00:05:48 +05:30
> - PBKDF2+SHA512 [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/360658) in GitLab 15.2 [with flags](../administration/feature_flags.md) named `pbkdf2_password_encryption` and `pbkdf2_password_encryption_write`. Disabled by default.
> - Feature flags [removed](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/101691) in GitLab 15.6 and PBKDF2+SHA512 was made available to all GitLab instances running in [FIPS mode](../development/fips_compliance.md).
2022-08-13 15:12:31 +05:30
2021-09-04 01:27:46 +05:30
GitLab stores user passwords in a hashed format to prevent passwords from being
stored as plain text.
2019-12-04 20:38:33 +05:30
2021-09-04 01:27:46 +05:30
GitLab uses the [Devise](https://github.com/heartcombo/devise) authentication
library to hash user passwords. Created password hashes have these attributes:
2019-12-04 20:38:33 +05:30
2022-08-13 15:12:31 +05:30
- **Hashing**:
2023-03-04 22:38:38 +05:30
- **bcrypt**: By default, the [`bcrypt`](https://en.wikipedia.org/wiki/Bcrypt) hashing
2022-11-25 23:54:43 +05:30
function is used to generate the hash of the provided password. This cryptographic hashing function is
strong and industry-standard.
2023-01-13 00:05:48 +05:30
- **PBKDF2+SHA512**: PBKDF2+SHA512 is supported:
- In GitLab 15.2 to GitLab 15.5 when `pbkdf2_password_encryption` and `pbkdf2_password_encryption_write` [feature flags](../administration/feature_flags.md) are enabled.
- In GitLab 15.6 and later when [FIPS mode](../development/fips_compliance.md) is enabled (feature flags are not required).
2021-09-04 01:27:46 +05:30
- **Stretching**: Password hashes are [stretched](https://en.wikipedia.org/wiki/Key_stretching)
to harden against brute-force attacks. By default, GitLab uses a stretching
2023-03-04 22:38:38 +05:30
factor of 10 for bcrypt and 20,000 for PBKDF2 + SHA512.
2021-09-04 01:27:46 +05:30
- **Salting**: A [cryptographic salt](https://en.wikipedia.org/wiki/Salt_(cryptography))
is added to each password to harden against pre-computed hash and dictionary
attacks. To increase security, each salt is randomly generated for each
password, with no two passwords sharing a salt.
2022-11-25 23:54:43 +05:30
## OAuth access token storage
> - PBKDF2+SHA512 [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/364110) in GitLab 15.3 [with flag](../administration/feature_flags.md) named `hash_oauth_tokens`.
2023-01-13 00:05:48 +05:30
> - [Enabled by default](https://gitlab.com/gitlab-org/gitlab/-/issues/367570) in GitLab 15.5.
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/367570) in GitLab 15.6.
2022-11-25 23:54:43 +05:30
2023-01-13 00:05:48 +05:30
OAuth access tokens are stored in the database in PBKDF2+SHA512 format. As with PBKDF2+SHA512 password storage, access token values are [stretched](https://en.wikipedia.org/wiki/Key_stretching) 20,000 times to harden against brute-force attacks.