diff options
author | Christiaan Conover <cconover@gitlab.com> | 2019-08-22 00:49:04 +0300 |
---|---|---|
committer | Christiaan Conover <cconover@gitlab.com> | 2019-08-22 00:49:04 +0300 |
commit | 954c3c18320d7dcb66c4c15035594cf5e59a496e (patch) | |
tree | 1732f26625d7874c1a7a2c6253e4202cfd287aa0 | |
parent | 1d5f5aa896a38104c375ac6ddd168d03d408f05e (diff) |
Document how GitLab stores passwords
Provide details on how GitLab stores passwords, including hashing,
stretching, and salting. This was driven by a customer asking for this
information for a security compliance audit report.
-rw-r--r-- | doc/security/README.md | 1 | ||||
-rw-r--r-- | doc/security/password_storage.md | 13 |
2 files changed, 14 insertions, 0 deletions
diff --git a/doc/security/README.md b/doc/security/README.md index 5d498ac7602..e3fb07c69c2 100644 --- a/doc/security/README.md +++ b/doc/security/README.md @@ -5,6 +5,7 @@ type: index # Security +- [Password storage](password_storage.md) - [Password length limits](password_length_limits.md) - [Restrict SSH key technologies and minimum length](ssh_keys_restrictions.md) - [Rate limits](rate_limits.md) diff --git a/doc/security/password_storage.md b/doc/security/password_storage.md new file mode 100644 index 00000000000..a44fafcca14 --- /dev/null +++ b/doc/security/password_storage.md @@ -0,0 +1,13 @@ +--- +type: reference +--- + +# Password Storage + +GitLab stores user passwords in a hashed format, to prevent passwords from being visible. + +GitLab uses the [Devise](https://github.com/plataformatec/devise) authentication library, which handles the hashing of user passwords. Password hashes are created with the following attributes: + +- **Hashing**: the [bcrypt](https://en.wikipedia.org/wiki/Bcrypt) hashing function is used to generate the hash of the provided password. This is a strong, industry-standard cryptographic hashing function. +- **Stretching**: Password hashes are [stretched](https://en.wikipedia.org/wiki/Key_stretching) to harden against brute-force attacks. GitLab uses a streching factor of 10 by default. +- **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. Each salt is randomly generated for each password, so that no two passwords share a salt to further increase security.
\ No newline at end of file |