Merge branch 'SAML_API_doc' of github.com:BigPandaToo/elasticsearch into SAML_API_doc

Author: BigPandaToo

x-pack/docs/en/rest-api/security.asciidoc

@@ -103,6 +103,7 @@ realm when using a custom web application other than Kibana
 * <<security-api-saml-authenticate, Submit an authentication response>>
 * <<security-api-saml-logout, Logout an authenticated user>>
 * <<security-api-saml-invalidate, Submit a logout request from the IdP>>
+* <<security-api-saml-sp-metadata,Generate SAML metadata>>
 
 
 include::security/authenticate.asciidoc[]
@@ -141,4 +142,5 @@ include::security/saml-prepare-authentication-api.asciidoc[]
 include::security/saml-authenticate-api.asciidoc[]
 include::security/saml-logout-api.asciidoc[]
 include::security/saml-invalidate-api.asciidoc[]
+include::security/saml-sp-metadata.asciidoc[]
 include::security/ssl.asciidoc[]

x-pack/docs/en/rest-api/security/saml_sp_metadata.asciidoc renamed to x-pack/docs/en/rest-api/security/saml-sp-metadata.asciidoc

@@ -7,16 +7,22 @@ Generate SAML metadata for a SAML 2.0 Service Provider.
 [[security-api-saml-sp-metadata-request]]
 ==== {api-request-title}
 
-`GET /_security/saml/metadata/<realmname>`
+`GET /_security/saml/metadata/<realm_name>`
 
 [[security-api-saml-sp-metadata-desc]]
 ==== {api-description-title}
 
-The SAML 2.0 specification provides a mechanism for Service Providers to describe their
-capabilities and configuration using a metadata file.
-This API generates Service Provider metadata, based on the configuration of a SAML realm
+The SAML 2.0 specification provides a mechanism for Service Providers to
+describe their capabilities and configuration using a metadata file. This API
+generates Service Provider metadata, based on the configuration of a SAML realm
 in Elasticsearch.
 
+[[security-api-saml-sp-metadata-path-params]]
+==== {api-path-parms-title}
+
+`<realm_name>`::
+  (Required, string) The name of the SAML realm in {es}.
+
 [[security-api-saml-sp-metadata-response-body]]
 ==== {api-response-body-title}