You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _install-and-configure/install-opensearch/docker.md
+26-1Lines changed: 26 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -102,7 +102,6 @@ Before continuing, you should verify that Docker is working correctly by deployi
102
102
```
103
103
For OpenSearch 2.12 or greater, set a new custom admin password before installation using the following command:
104
104
```bash
105
-
# Password requires a minimum of 8 characters and must contain at least one uppercase letter, one lowercase letter, one digit, and one special character. Password strength can be tested here: https://lowe.github.io/tryzxcvbn
1. Send a request to port 9200. The default username and password are `admin`.
@@ -178,6 +177,32 @@ Starting with OpenSearch 2.12, a custom admin password is required to set up a d
178
177
179
178
- Create an `.env` file in the same folder as your `docker-compose.yml` file with the `OPENSEARCH_INITIAL_ADMIN_PASSWORD` and a strong password value.
180
179
180
+
### Password requirements
181
+
182
+
OpenSearch enforces strong password security by default, using the [`zxcvbn`](https://github.com/dropbox/zxcvbn) password strength estimation library developed by Dropbox.
183
+
184
+
This library evaluates passwords based on entropy, rather than rigid complexity rules, using the following guidelines:
185
+
186
+
- **Focus on entropy, not only rules**: Instead of only adding numbers or special characters, prioritize overall unpredictability. Longer passwords composed of random words or characters provide higher entropy, making them more secure than short passwords that meet conventional complexity rules.
187
+
188
+
- **Avoid common patterns and dictionary words**: The `zxcvbn` library detects commonly used words, dates, sequences (for example, `1234` or `qwerty`), and even predictable character substitutions (for example, `3`for`E`). To ensure strong security, avoid using these patternsin your passwords.
189
+
190
+
- **Length matters**: Longer passwords generally offer greater security. For example, a passphrase such as `correct horse battery staple` is considered to be strong because of its length and randomness, even though it does not contain special characters or numbers.
191
+
192
+
- **Unpredictability is key**: Whether you choose a string of random characters or a passphrase made of unrelated words, the key to password security is unpredictability. Higher entropy significantly increases the number of required guesses, making the password more resistant to attacks.
193
+
194
+
To learn more about `zxcvbn`, see [this Dropbox blog post](https://dropbox.tech/security/zxcvbn-realistic-password-strength-estimation). To experiment with password strength, use [this demo](https://lowe.github.io/tryzxcvbn).
195
+
{: .tip}
196
+
197
+
OpenSearch uses the following default password requirements:
198
+
199
+
- Minimum password length: 8 characters.
200
+
- Maximum password length: 100 characters.
201
+
- No requirements for special characters, numbers, or uppercase letters.
202
+
- Passwords must be rated `strong` using the `zxcvbn` entropy-based calculation.
203
+
204
+
You can customize the default password requirements by updating the [password cluster settings]({{site.url}}{{site.baseurl}}/security/configuration/yaml/#password-settings).
0 commit comments