Skip to content

Commit c6bfc96

Browse files
BigPandaTooelasticmachine
BigPandaToo
and
elasticmachine
authored
Adding API for generating SAML SP metadata (#64517) (#64731)
* Adding API for generating SAML SP metadata Resolve #49018 * Adding API for generating SAML SP metadata Resolves #49018 * Adding API for generating SAML SP metadata Resolves #49018 * Adding API for generating SAML SP metadata Resolves #49018 * Adding API for generating SAML SP metadata Resolves #49018 * Adding API for generating SAML SP metadata Resolves #49018 * Adding API for generating SAML SP metadata Resolves #49018 Co-authored-by: Elastic Machine <[email protected]> Co-authored-by: Elastic Machine <[email protected]>
1 parent be1a568 commit c6bfc96

File tree

12 files changed

+327
-10
lines changed

12 files changed

+327
-10
lines changed

‎x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/saml/SamlSpMetadataAction.java‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
/*
2+
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
3+
* or more contributor license agreements. Licensed under the Elastic License;
4+
* you may not use this file except in compliance with the Elastic License.
5+
*/
6+
7+
package org.elasticsearch.xpack.core.security.action.saml;
8+
9+
import org.elasticsearch.action.ActionType;
10+
11+
public class SamlSpMetadataAction extends ActionType<SamlSpMetadataResponse> {
12+
public static final String NAME = "cluster:monitor/xpack/security/saml/metadata";
13+
public static final SamlSpMetadataAction INSTANCE = new SamlSpMetadataAction();
14+
15+
private SamlSpMetadataAction() {
16+
super(NAME, SamlSpMetadataResponse::new);
17+
}
18+
}

‎x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/saml/SamlSpMetadataRequest.java‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
/*
2+
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
3+
* or more contributor license agreements. Licensed under the Elastic License;
4+
* you may not use this file except in compliance with the Elastic License.
5+
*/
6+
7+
package org.elasticsearch.xpack.core.security.action.saml;
8+
9+
import org.elasticsearch.action.ActionRequest;
10+
import org.elasticsearch.action.ActionRequestValidationException;
11+
import org.elasticsearch.common.Strings;
12+
import org.elasticsearch.common.io.stream.StreamInput;
13+
import org.elasticsearch.common.io.stream.StreamOutput;
14+
15+
import java.io.IOException;
16+
17+
import static org.elasticsearch.action.ValidateActions.addValidationError;
18+
19+
public class SamlSpMetadataRequest extends ActionRequest {
20+
21+
private String realmName;
22+
23+
public SamlSpMetadataRequest(StreamInput in) throws IOException {
24+
super(in);
25+
realmName = in.readOptionalString();
26+
}
27+
28+
public SamlSpMetadataRequest(String realmName) {
29+
this.realmName = realmName;
30+
}
31+
32+
@Override
33+
public ActionRequestValidationException validate() {
34+
ActionRequestValidationException validationException = null;
35+
if (Strings.hasText(realmName) == false) {
36+
validationException = addValidationError("Realm name may not be empty", validationException);
37+
}
38+
return validationException;
39+
}
40+
41+
public String getRealmName() {
42+
return realmName;
43+
}
44+
45+
public void setRealmName(String realmName) {
46+
this.realmName = realmName;
47+
}
48+
49+
@Override
50+
public String toString() {
51+
return getClass().getSimpleName() + "{" +
52+
"realmName=" + realmName +
53+
'}';
54+
}
55+
56+
@Override
57+
public void writeTo(StreamOutput out) throws IOException {
58+
super.writeTo(out);
59+
out.writeOptionalString(realmName);
60+
}
61+
}

‎x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/action/saml/SamlSpMetadataResponse.java‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
/*
2+
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
3+
* or more contributor license agreements. Licensed under the Elastic License;
4+
* you may not use this file except in compliance with the Elastic License.
5+
*/
6+
7+
package org.elasticsearch.xpack.core.security.action.saml;
8+
9+
import org.elasticsearch.action.ActionResponse;
10+
import org.elasticsearch.common.io.stream.StreamInput;
11+
import org.elasticsearch.common.io.stream.StreamOutput;
12+
13+
import java.io.IOException;
14+
15+
/**
16+
* Response containing a SAML SP metadata for a specific realm as XML.
17+
*/
18+
public class SamlSpMetadataResponse extends ActionResponse {
19+
public String getXMLString() {
20+
return XMLString;
21+
}
22+
23+
private String XMLString;
24+
25+
public SamlSpMetadataResponse(StreamInput in) throws IOException {
26+
super(in);
27+
XMLString = in.readString();
28+
}
29+
30+
public SamlSpMetadataResponse(String XMLString) {
31+
this.XMLString = XMLString;
32+
}
33+
34+
@Override
35+
public void writeTo(StreamOutput out) throws IOException {
36+
out.writeString(XMLString);
37+
}
38+
}

‎x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/privilege/ClusterPrivilegeResolver.java‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@
2323
import org.elasticsearch.xpack.core.ilm.action.StopILMAction;
2424
import org.elasticsearch.xpack.core.security.action.DelegatePkiAuthenticationAction;
2525
import org.elasticsearch.xpack.core.security.action.GrantApiKeyAction;
26+
import org.elasticsearch.xpack.core.security.action.saml.SamlSpMetadataAction;
2627
import org.elasticsearch.xpack.core.security.action.token.InvalidateTokenAction;
2728
import org.elasticsearch.xpack.core.security.action.token.RefreshTokenAction;
2829
import org.elasticsearch.xpack.core.security.action.user.HasPrivilegesAction;
@@ -46,7 +47,7 @@ public class ClusterPrivilegeResolver {
4647
private static final Set<String> ALL_SECURITY_PATTERN = Collections.singleton("cluster:admin/xpack/security/*");
4748
private static final Set<String> MANAGE_SAML_PATTERN = Collections.unmodifiableSet(
4849
Sets.newHashSet("cluster:admin/xpack/security/saml/*",
49-
InvalidateTokenAction.NAME, RefreshTokenAction.NAME));
50+
InvalidateTokenAction.NAME, RefreshTokenAction.NAME, SamlSpMetadataAction.NAME));
5051
private static final Set<String> MANAGE_OIDC_PATTERN = Collections.singleton("cluster:admin/xpack/security/oidc/*");
5152
private static final Set<String> MANAGE_TOKEN_PATTERN = Collections.singleton("cluster:admin/xpack/security/token/*");
5253
private static final Set<String> MANAGE_API_KEY_PATTERN = Collections.singleton("cluster:admin/xpack/security/api_key/*");

‎x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/action/saml/SamlSpMetadataRequestTests.java‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
/*
2+
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
3+
* or more contributor license agreements. Licensed under the Elastic License;
4+
* you may not use this file except in compliance with the Elastic License.
5+
*/
6+
7+
package org.elasticsearch.xpack.core.security.action.saml;
8+
9+
import org.elasticsearch.action.ActionRequestValidationException;
10+
import org.elasticsearch.common.io.stream.BytesStreamOutput;
11+
import org.elasticsearch.common.io.stream.StreamInput;
12+
import org.elasticsearch.test.ESTestCase;
13+
14+
import java.io.IOException;
15+
16+
import static org.hamcrest.Matchers.containsString;
17+
18+
public class SamlSpMetadataRequestTests extends ESTestCase {
19+
20+
public void testValidateFailsWhenRealmEmpty() {
21+
final SamlSpMetadataRequest samlSPMetadataRequest = new SamlSpMetadataRequest("");
22+
final ActionRequestValidationException validationException = samlSPMetadataRequest.validate();
23+
assertThat(validationException.getMessage(), containsString("Realm name may not be empty"));
24+
}
25+
26+
public void testValidateSerialization() throws IOException {
27+
final SamlSpMetadataRequest samlSPMetadataRequest = new SamlSpMetadataRequest("saml1");
28+
try (BytesStreamOutput out = new BytesStreamOutput()) {
29+
samlSPMetadataRequest.writeTo(out);
30+
try (StreamInput in = out.bytes().streamInput()) {
31+
final SamlSpMetadataRequest serialized = new SamlSpMetadataRequest(in);
32+
assertEquals(samlSPMetadataRequest.getRealmName(), serialized.getRealmName());
33+
}
34+
}
35+
}
36+
37+
public void testValidateToString() {
38+
final SamlSpMetadataRequest samlSPMetadataRequest = new SamlSpMetadataRequest("saml1");
39+
assertThat(samlSPMetadataRequest.toString(), containsString("{realmName=saml1}"));
40+
}
41+
}

‎x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,7 @@
109109
import org.elasticsearch.xpack.core.security.action.saml.SamlLogoutAction;
110110
import org.elasticsearch.xpack.core.security.action.saml.SamlCompleteLogoutAction;
111111
import org.elasticsearch.xpack.core.security.action.saml.SamlPrepareAuthenticationAction;
112+
import org.elasticsearch.xpack.core.security.action.saml.SamlSpMetadataAction;
112113
import org.elasticsearch.xpack.core.security.action.token.CreateTokenAction;
113114
import org.elasticsearch.xpack.core.security.action.token.InvalidateTokenAction;
114115
import org.elasticsearch.xpack.core.security.action.token.RefreshTokenAction;
@@ -175,6 +176,7 @@
175176
import org.elasticsearch.xpack.security.action.saml.TransportSamlLogoutAction;
176177
import org.elasticsearch.xpack.security.action.saml.TransportSamlCompleteLogoutAction;
177178
import org.elasticsearch.xpack.security.action.saml.TransportSamlPrepareAuthenticationAction;
179+
import org.elasticsearch.xpack.security.action.saml.TransportSamlSpMetadataAction;
178180
import org.elasticsearch.xpack.security.action.token.TransportCreateTokenAction;
179181
import org.elasticsearch.xpack.security.action.token.TransportInvalidateTokenAction;
180182
import org.elasticsearch.xpack.security.action.token.TransportRefreshTokenAction;
@@ -244,6 +246,7 @@
244246
import org.elasticsearch.xpack.security.rest.action.saml.RestSamlLogoutAction;
245247
import org.elasticsearch.xpack.security.rest.action.saml.RestSamlCompleteLogoutAction;
246248
import org.elasticsearch.xpack.security.rest.action.saml.RestSamlPrepareAuthenticationAction;
249+
import org.elasticsearch.xpack.security.rest.action.saml.RestSamlSpMetadataAction;
247250
import org.elasticsearch.xpack.security.rest.action.user.RestChangePasswordAction;
248251
import org.elasticsearch.xpack.security.rest.action.user.RestDeleteUserAction;
249252
import org.elasticsearch.xpack.security.rest.action.user.RestGetUserPrivilegesAction;
@@ -822,6 +825,7 @@ public void onIndexModule(IndexModule module) {
822825
new ActionHandler<>(SamlLogoutAction.INSTANCE, TransportSamlLogoutAction.class),
823826
new ActionHandler<>(SamlInvalidateSessionAction.INSTANCE, TransportSamlInvalidateSessionAction.class),
824827
new ActionHandler<>(SamlCompleteLogoutAction.INSTANCE, TransportSamlCompleteLogoutAction.class),
828+
new ActionHandler<>(SamlSpMetadataAction.INSTANCE, TransportSamlSpMetadataAction.class),
825829
new ActionHandler<>(OpenIdConnectPrepareAuthenticationAction.INSTANCE,
826830
TransportOpenIdConnectPrepareAuthenticationAction.class),
827831
new ActionHandler<>(OpenIdConnectAuthenticateAction.INSTANCE, TransportOpenIdConnectAuthenticateAction.class),
@@ -884,6 +888,7 @@ public List<RestHandler> getRestHandlers(Settings settings, RestController restC
884888
new RestSamlLogoutAction(settings, getLicenseState()),
885889
new RestSamlInvalidateSessionAction(settings, getLicenseState()),
886890
new RestSamlCompleteLogoutAction(settings, getLicenseState()),
891+
new RestSamlSpMetadataAction(settings, getLicenseState()),
887892
new RestOpenIdConnectPrepareAuthenticationAction(settings, getLicenseState()),
888893
new RestOpenIdConnectAuthenticateAction(settings, getLicenseState()),
889894
new RestOpenIdConnectLogoutAction(settings, getLicenseState()),

‎x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/action/saml/TransportSamlSpMetadataAction.java‎

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
/*
2+
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
3+
* or more contributor license agreements. Licensed under the Elastic License;
4+
* you may not use this file except in compliance with the Elastic License.
5+
*/
6+
7+
package org.elasticsearch.xpack.security.action.saml;
8+
9+
import org.apache.logging.log4j.message.ParameterizedMessage;
10+
import org.elasticsearch.action.ActionListener;
11+
import org.elasticsearch.action.support.ActionFilters;
12+
import org.elasticsearch.action.support.HandledTransportAction;
13+
import org.elasticsearch.common.inject.Inject;
14+
import org.elasticsearch.tasks.Task;
15+
import org.elasticsearch.transport.TransportService;
16+
import org.elasticsearch.xpack.core.security.action.saml.SamlSpMetadataAction;
17+
import org.elasticsearch.xpack.core.security.action.saml.SamlSpMetadataRequest;
18+
import org.elasticsearch.xpack.core.security.action.saml.SamlSpMetadataResponse;
19+
import org.elasticsearch.xpack.security.authc.Realms;
20+
import org.elasticsearch.xpack.security.authc.saml.SamlRealm;
21+
import org.elasticsearch.xpack.security.authc.saml.SamlSpMetadataBuilder;
22+
import org.elasticsearch.xpack.security.authc.saml.SamlUtils;
23+
import org.elasticsearch.xpack.security.authc.saml.SpConfiguration;
24+
import org.opensaml.saml.saml2.core.AuthnRequest;
25+
import org.opensaml.saml.saml2.metadata.EntityDescriptor;
26+
import org.opensaml.saml.saml2.metadata.impl.EntityDescriptorMarshaller;
27+
import org.w3c.dom.Element;
28+
29+
import javax.xml.transform.Transformer;
30+
import javax.xml.transform.dom.DOMSource;
31+
import javax.xml.transform.stream.StreamResult;
32+
import java.io.StringWriter;
33+
import java.util.List;
34+
import java.util.Locale;
35+
36+
import static org.elasticsearch.xpack.security.authc.saml.SamlRealm.findSamlRealms;
37+
38+
/**
39+
* Transport action responsible for generating a SAML SP Metadata.
40+
*/
41+
public class TransportSamlSpMetadataAction
42+
extends HandledTransportAction<SamlSpMetadataRequest, SamlSpMetadataResponse> {
43+
44+
private final Realms realms;
45+
46+
@Inject
47+
public TransportSamlSpMetadataAction(TransportService transportService, ActionFilters actionFilters, Realms realms) {
48+
super(SamlSpMetadataAction.NAME, transportService, actionFilters, SamlSpMetadataRequest::new
49+
);
50+
this.realms = realms;
51+
}
52+
53+
@Override
54+
protected void doExecute(Task task, SamlSpMetadataRequest request,
55+
ActionListener<SamlSpMetadataResponse> listener) {
56+
List<SamlRealm> realms = findSamlRealms(this.realms, request.getRealmName(), null);
57+
if (realms.isEmpty()) {
58+
listener.onFailure(SamlUtils.samlException("Cannot find any matching realm for [{}]", request.getRealmName()));
59+
} else if (realms.size() > 1) {
60+
listener.onFailure(SamlUtils.samlException("Found multiple matching realms [{}] for [{}]", realms, request.getRealmName()));
61+
} else {
62+
prepareMetadata(realms.get(0), listener);
63+
}
64+
}
65+
66+
private void prepareMetadata(SamlRealm realm, ActionListener<SamlSpMetadataResponse> listener) {
67+
try {
68+
final EntityDescriptorMarshaller marshaller = new EntityDescriptorMarshaller();
69+
final SpConfiguration spConfig = realm.getServiceProvider();
70+
final SamlSpMetadataBuilder builder = new SamlSpMetadataBuilder(Locale.getDefault(), spConfig.getEntityId())
71+
.assertionConsumerServiceUrl(spConfig.getAscUrl())
72+
.singleLogoutServiceUrl(spConfig.getLogoutUrl())
73+
.encryptionCredentials(spConfig.getEncryptionCredentials())
74+
.signingCredential(spConfig.getSigningConfiguration().getCredential())
75+
.authnRequestsSigned(spConfig.getSigningConfiguration().shouldSign(AuthnRequest.DEFAULT_ELEMENT_LOCAL_NAME));
76+
final EntityDescriptor descriptor = builder.build();
77+
final Element element = marshaller.marshall(descriptor);
78+
final StringWriter writer = new StringWriter();
79+
final Transformer serializer = SamlUtils.getHardenedXMLTransformer();
80+
serializer.transform(new DOMSource(element), new StreamResult(writer));
81+
listener.onResponse(new SamlSpMetadataResponse(writer.toString()));
82+
} catch (Exception e) {
83+
logger.error(new ParameterizedMessage(
84+
"Error during SAML SP metadata generation for realm [{}]", realm.name()), e);
85+
listener.onFailure(e);
86+
}
87+
}
88+
}

‎x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/saml/SamlRealm.java‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -208,6 +208,10 @@ public static SamlRealm create(RealmConfig config, SSLService sslService, Resour
208208
return realm;
209209
}
210210

211+
public SpConfiguration getServiceProvider() {
212+
return serviceProvider;
213+
}
214+
211215
// For testing
212216
SamlRealm(
213217
RealmConfig config,

‎x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/saml/SamlSpMetadataBuilder.java‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -241,7 +241,9 @@ public EntityDescriptor build() throws Exception {
241241
if (organization != null) {
242242
descriptor.setOrganization(buildOrganization());
243243
}
244-
contacts.forEach(c -> descriptor.getContactPersons().add(buildContact(c)));
244+
if(contacts.size() > 0) {
245+
contacts.forEach(c -> descriptor.getContactPersons().add(buildContact(c)));
246+
}
245247

246248
return descriptor;
247249
}

‎x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/saml/SigningConfiguration.java‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616
/**
1717
* Encapsulates the rules and credentials for how and when Elasticsearch should sign outgoing SAML messages.
1818
*/
19-
class SigningConfiguration {
19+
public class SigningConfiguration {
2020

2121
private final Set<String> messageTypes;
2222
private final X509Credential credential;
@@ -30,7 +30,7 @@ boolean shouldSign(SAMLObject object) {
3030
return shouldSign(object.getElementQName().getLocalPart());
3131
}
3232

33-
boolean shouldSign(String elementName) {
33+
public boolean shouldSign(String elementName) {
3434
if (credential == null) {
3535
return false;
3636
}
@@ -45,7 +45,7 @@ byte[] sign(byte[] content, String algo) throws SecurityException {
4545
return XMLSigningUtil.signWithURI(this.credential, algo, content);
4646
}
4747

48-
X509Credential getCredential() {
48+
public X509Credential getCredential() {
4949
return credential;
5050
}
5151
}

0 commit comments

Comments
 (0)