-
Notifications
You must be signed in to change notification settings - Fork 24.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Startup check for security implicit behavior change #76879
Changes from 14 commits
f2bbff6
1ced464
0010034
b4b713c
cc472a2
b890c25
66d09eb
a8297da
a7f6421
2eba1d7
28491b6
79da522
1180f45
399fc96
80f893f
2acbd38
12bcde6
fa33a56
7bcec6c
1006559
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -28,35 +28,43 @@ public final class NodeMetadata { | |
|
||
static final String NODE_ID_KEY = "node_id"; | ||
static final String NODE_VERSION_KEY = "node_version"; | ||
static final String PREVIOUS_NODE_VERSION_KEY = "previous_node_version"; | ||
|
||
private final String nodeId; | ||
|
||
private final Version nodeVersion; | ||
|
||
public NodeMetadata(final String nodeId, final Version nodeVersion) { | ||
private final Version previousNodeVersion; | ||
|
||
public NodeMetadata(final String nodeId, final Version nodeVersion, final Version previousNodeVersion) { | ||
this.nodeId = Objects.requireNonNull(nodeId); | ||
this.nodeVersion = Objects.requireNonNull(nodeVersion); | ||
this.previousNodeVersion = Objects.requireNonNull(previousNodeVersion); | ||
} | ||
|
||
@Override | ||
public boolean equals(Object o) { | ||
public NodeMetadata(final String nodeId, final Version nodeVersion) { | ||
this(nodeId, nodeVersion, nodeVersion); | ||
} | ||
|
||
@Override public boolean equals(Object o) { | ||
if (this == o) return true; | ||
if (o == null || getClass() != o.getClass()) return false; | ||
NodeMetadata that = (NodeMetadata) o; | ||
return nodeId.equals(that.nodeId) && | ||
nodeVersion.equals(that.nodeVersion); | ||
return nodeId.equals(that.nodeId) && nodeVersion.equals(that.nodeVersion) && Objects.equals( | ||
previousNodeVersion, | ||
that.previousNodeVersion); | ||
} | ||
|
||
@Override | ||
public int hashCode() { | ||
return Objects.hash(nodeId, nodeVersion); | ||
@Override public int hashCode() { | ||
return Objects.hash(nodeId, nodeVersion, previousNodeVersion); | ||
} | ||
|
||
@Override | ||
public String toString() { | ||
return "NodeMetadata{" + | ||
"nodeId='" + nodeId + '\'' + | ||
", nodeVersion=" + nodeVersion + | ||
", previousNodeVersion=" + previousNodeVersion + | ||
'}'; | ||
} | ||
|
||
|
@@ -68,10 +76,14 @@ public Version nodeVersion() { | |
return nodeVersion; | ||
} | ||
|
||
public Version previousNodeVersion() { | ||
return previousNodeVersion; | ||
} | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I know I'm fighting against the existing conventions of this class, but is it possible to get some sort of javadoc here? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. added in 80f893f, @DaveCTurner can keep me honest or suggest enhancements There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Docs LGTM 👍 |
||
|
||
public NodeMetadata upgradeToCurrentVersion() { | ||
if (nodeVersion.equals(Version.V_EMPTY)) { | ||
assert Version.CURRENT.major <= Version.V_7_0_0.major + 1 : "version is required in the node metadata from v9 onwards"; | ||
return new NodeMetadata(nodeId, Version.CURRENT); | ||
return new NodeMetadata(nodeId, Version.CURRENT, Version.V_EMPTY); | ||
} | ||
|
||
if (nodeVersion.before(Version.CURRENT.minimumIndexCompatibilityVersion())) { | ||
|
@@ -84,12 +96,13 @@ public NodeMetadata upgradeToCurrentVersion() { | |
"cannot downgrade a node from version [" + nodeVersion + "] to version [" + Version.CURRENT + "]"); | ||
} | ||
|
||
return nodeVersion.equals(Version.CURRENT) ? this : new NodeMetadata(nodeId, Version.CURRENT); | ||
return nodeVersion.equals(Version.CURRENT) ? this : new NodeMetadata(nodeId, Version.CURRENT, nodeVersion); | ||
} | ||
|
||
private static class Builder { | ||
String nodeId; | ||
Version nodeVersion; | ||
Version previousNodeVersion; | ||
|
||
public void setNodeId(String nodeId) { | ||
this.nodeId = nodeId; | ||
|
@@ -99,6 +112,10 @@ public void setNodeVersionId(int nodeVersionId) { | |
this.nodeVersion = Version.fromId(nodeVersionId); | ||
} | ||
|
||
public void setPreviousNodeVersionId(int previousNodeVersionId) { | ||
this.previousNodeVersion = Version.fromId(previousNodeVersionId); | ||
} | ||
|
||
public NodeMetadata build() { | ||
final Version nodeVersion; | ||
if (this.nodeVersion == null) { | ||
|
@@ -107,8 +124,11 @@ public NodeMetadata build() { | |
} else { | ||
nodeVersion = this.nodeVersion; | ||
} | ||
if (this.previousNodeVersion == null) { | ||
previousNodeVersion = nodeVersion; | ||
} | ||
|
||
return new NodeMetadata(nodeId, nodeVersion); | ||
return new NodeMetadata(nodeId, nodeVersion, previousNodeVersion); | ||
} | ||
} | ||
|
||
|
@@ -125,6 +145,7 @@ static class NodeMetadataStateFormat extends MetadataStateFormat<NodeMetadata> { | |
objectParser = new ObjectParser<>("node_meta_data", ignoreUnknownFields, Builder::new); | ||
objectParser.declareString(Builder::setNodeId, new ParseField(NODE_ID_KEY)); | ||
objectParser.declareInt(Builder::setNodeVersionId, new ParseField(NODE_VERSION_KEY)); | ||
objectParser.declareInt(Builder::setPreviousNodeVersionId, new ParseField(PREVIOUS_NODE_VERSION_KEY)); | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Do we need to write this field to disk? I think we just overwrite it before ever using it. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. You're right David, we don't need to. I'm amending |
||
} | ||
|
||
@Override | ||
|
@@ -138,6 +159,7 @@ protected XContentBuilder newXContentBuilder(XContentType type, OutputStream str | |
public void toXContent(XContentBuilder builder, NodeMetadata nodeMetadata) throws IOException { | ||
builder.field(NODE_ID_KEY, nodeMetadata.nodeId); | ||
builder.field(NODE_VERSION_KEY, nodeMetadata.nodeVersion.id); | ||
builder.field(PREVIOUS_NODE_VERSION_KEY, nodeMetadata.previousNodeVersion.id); | ||
} | ||
|
||
@Override | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,55 @@ | ||
/* | ||
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one | ||
* or more contributor license agreements. Licensed under the Elastic License | ||
* 2.0; you may not use this file except in compliance with the Elastic License | ||
* 2.0. | ||
*/ | ||
|
||
package org.elasticsearch.xpack.security; | ||
|
||
import org.elasticsearch.Version; | ||
import org.elasticsearch.bootstrap.BootstrapCheck; | ||
import org.elasticsearch.bootstrap.BootstrapContext; | ||
import org.elasticsearch.env.NodeMetadata; | ||
import org.elasticsearch.license.License; | ||
import org.elasticsearch.license.LicenseService; | ||
import org.elasticsearch.xpack.core.XPackSettings; | ||
|
||
public class SecurityImplicitBehaviorBootstrapCheck implements BootstrapCheck { | ||
|
||
private final NodeMetadata nodeMetadata; | ||
|
||
public SecurityImplicitBehaviorBootstrapCheck(NodeMetadata nodeMetadata) { | ||
this.nodeMetadata = nodeMetadata; | ||
} | ||
|
||
@Override | ||
public BootstrapCheckResult check(BootstrapContext context) { | ||
if (nodeMetadata == null) { | ||
return BootstrapCheckResult.success(); | ||
} | ||
final License license = LicenseService.getLicense(context.metadata()); | ||
final Version lastKnownVersion = nodeMetadata.previousNodeVersion(); | ||
// pre v7.2.0 nodes have Version.EMPTY and its id is 0, so Version#before handles this successfully | ||
if (lastKnownVersion.before(Version.V_8_0_0) | ||
&& XPackSettings.SECURITY_ENABLED.exists(context.settings()) == false | ||
&& (license.operationMode() == License.OperationMode.BASIC || license.operationMode() == License.OperationMode.TRIAL)) { | ||
return BootstrapCheckResult.failure( | ||
"The default value for [" | ||
+ XPackSettings.SECURITY_ENABLED.getKey() | ||
+ "] has changed. See https://www.elastic.co/guide/en/elasticsearch/reference/" | ||
+ Version.CURRENT.major | ||
+ "." | ||
+ Version.CURRENT.minor | ||
+ "/security-minimal-setup.html to enable security, or explicitly disable security by " | ||
+ "setting [xpack.security.enabled] to \"false\" in elasticsearch.yml before restarting the node" | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I'm coming in late, so maybe this has been discussed, but this message feels a bit lacking. People who get this message don't necessarily realise why they're getting it now, and why it's a fatal error. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I will take another attempt at it, I'll ask @lockewritesdocs to weigh-in on the wording too There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I've rephrased it, let me know what you think. Open to suggestions |
||
); | ||
} else { | ||
return BootstrapCheckResult.success(); | ||
} | ||
} | ||
|
||
public boolean alwaysEnforce() { | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I don't love this always enabled Bootstrap check, but this is currently the only way for us to make a check on node startup that has a view ( albeit limited ) to the restored cluster state ( via the BootstrapContext ) There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I'd forgotten that we expose the metadata read from disk like this, but I think this is fine - at least it's no worse than any of the other places that make decisions based on the contents of the on-disk cluster state despite the fact that this could be stale or even uncommitted. |
||
return true; | ||
} | ||
} |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,87 @@ | ||
/* | ||
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one | ||
* or more contributor license agreements. Licensed under the Elastic License | ||
* 2.0; you may not use this file except in compliance with the Elastic License | ||
* 2.0. | ||
*/ | ||
|
||
package org.elasticsearch.xpack.security; | ||
|
||
import org.elasticsearch.Version; | ||
import org.elasticsearch.bootstrap.BootstrapCheck; | ||
import org.elasticsearch.cluster.metadata.Metadata; | ||
import org.elasticsearch.common.settings.Settings; | ||
import org.elasticsearch.core.TimeValue; | ||
import org.elasticsearch.env.NodeMetadata; | ||
import org.elasticsearch.license.License; | ||
import org.elasticsearch.license.LicensesMetadata; | ||
import org.elasticsearch.license.TestUtils; | ||
import org.elasticsearch.test.AbstractBootstrapCheckTestCase; | ||
import org.elasticsearch.test.VersionUtils; | ||
import org.elasticsearch.xpack.core.XPackSettings; | ||
|
||
import static org.hamcrest.Matchers.equalTo; | ||
import static org.hamcrest.Matchers.is; | ||
|
||
public class SecurityImplicitBehaviorBootstrapCheckTests extends AbstractBootstrapCheckTestCase { | ||
|
||
public void testFailureUpgradeFrom7xWithImplicitSecuritySettings() throws Exception { | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I think we need 2 methods:
The 2nd one seems to be missing. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. makes sense, will add now There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. added in 2acbd38 |
||
final Version previousVersion = VersionUtils.randomVersionBetween(random(), Version.V_7_2_0, Version.V_7_16_0); | ||
final NodeMetadata nodeMetadata = new NodeMetadata(randomAlphaOfLength(10), Version.CURRENT, previousVersion); | ||
BootstrapCheck.BootstrapCheckResult result = new SecurityImplicitBehaviorBootstrapCheck(nodeMetadata).check( | ||
createTestContext(Settings.EMPTY, createLicensesMetadata(previousVersion)) | ||
); | ||
assertThat(result.isFailure(), is(true)); | ||
assertThat( | ||
result.getMessage(), | ||
equalTo( | ||
"The default value for [" | ||
+ XPackSettings.SECURITY_ENABLED.getKey() | ||
+ "] has changed. See https://www.elastic.co/guide/en/elasticsearch/reference/" | ||
+ Version.CURRENT.major | ||
+ "." | ||
+ Version.CURRENT.minor | ||
+ "/security-minimal-setup.html to enable security, or explicitly disable security by " | ||
+ "setting [xpack.security.enabled] to \"false\" in elasticsearch.yml before restarting the node" | ||
) | ||
); | ||
} | ||
|
||
public void testUpgradeFrom7xWithExplicitSecuritySettings() throws Exception { | ||
final Version previousVersion = VersionUtils.randomVersionBetween(random(), Version.V_7_2_0, Version.V_7_16_0); | ||
final NodeMetadata nodeMetadata = new NodeMetadata(randomAlphaOfLength(10), Version.CURRENT, previousVersion); | ||
BootstrapCheck.BootstrapCheckResult result = new SecurityImplicitBehaviorBootstrapCheck(nodeMetadata).check( | ||
createTestContext( | ||
Settings.builder().put(XPackSettings.SECURITY_ENABLED.getKey(), true).build(), | ||
createLicensesMetadata(previousVersion) | ||
) | ||
); | ||
assertThat(result.isSuccess(), is(true)); | ||
} | ||
|
||
public void testUpgradeFrom8xWithImplicitSecuritySettings() throws Exception { | ||
final Version previousVersion = VersionUtils.randomVersionBetween(random(), Version.V_8_0_0, null); | ||
final NodeMetadata nodeMetadata = new NodeMetadata(randomAlphaOfLength(10), Version.CURRENT, previousVersion); | ||
BootstrapCheck.BootstrapCheckResult result = new SecurityImplicitBehaviorBootstrapCheck(nodeMetadata).check( | ||
createTestContext(Settings.EMPTY, createLicensesMetadata(previousVersion)) | ||
); | ||
assertThat(result.isSuccess(), is(true)); | ||
} | ||
|
||
public void testUpgradeFrom8xWithExplicitSecuritySettings() throws Exception { | ||
final Version previousVersion = VersionUtils.randomVersionBetween(random(), Version.V_8_0_0, null); | ||
final NodeMetadata nodeMetadata = new NodeMetadata(randomAlphaOfLength(10), Version.CURRENT, previousVersion); | ||
BootstrapCheck.BootstrapCheckResult result = new SecurityImplicitBehaviorBootstrapCheck(nodeMetadata).check( | ||
createTestContext( | ||
Settings.builder().put(XPackSettings.SECURITY_ENABLED.getKey(), true).build(), | ||
createLicensesMetadata(previousVersion) | ||
) | ||
); | ||
assertThat(result.isSuccess(), is(true)); | ||
} | ||
|
||
private Metadata createLicensesMetadata(Version version) throws Exception { | ||
License license = TestUtils.generateSignedLicense(randomFrom("basic", "trial"), TimeValue.timeValueHours(2)); | ||
return Metadata.builder().putCustom(LicensesMetadata.TYPE, new LicensesMetadata(license, version)).build(); | ||
} | ||
} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nit: could we make this private, and construct the instances needed in
SecurityImplicitBehaviorBootstrapCheckTests
by callingupgradeToCurrentVersion()
instead?