diff --git a/server_admin/topics/clients/saml/entity-descriptors.adoc b/server_admin/topics/clients/saml/entity-descriptors.adoc deleted file mode 100644 index b81e9170fa..0000000000 --- a/server_admin/topics/clients/saml/entity-descriptors.adoc +++ /dev/null @@ -1,13 +0,0 @@ - -==== SAML Entity Descriptors - -Instead of manually registering a SAML 2.0 client, you can import it via a standard SAML Entity Descriptor XML file. -There is an `Import` option on the Add Client page. - -.Add Client -image:{project_images}/add-client-saml.png[] - -Click the `Select File` button and load your entity descriptor file. You should review all the information there to make sure everything is set up correctly. - -Some SAML client adapters like _mod-auth-mellon_ need the XML Entity Descriptor for the IDP. You can obtain this by -going to this public URL: `root/auth/realms/{realm}/protocol/saml/descriptor` diff --git a/server_admin/topics/clients/saml/proc-using-an-entity-descriptor.adoc b/server_admin/topics/clients/saml/proc-using-an-entity-descriptor.adoc new file mode 100644 index 0000000000..cdd8eba690 --- /dev/null +++ b/server_admin/topics/clients/saml/proc-using-an-entity-descriptor.adoc @@ -0,0 +1,23 @@ +[id="proc-using-an-entity-descriptors_{context}"] + +==== Using an entity descriptor to create a client + +Instead of registering a SAML 2.0 client manually, you can import the client using a standard SAML Entity Descriptor XML file. + +The Add Client page includes an `Import` option. + +.Add Client +image:{project_images}/add-client-saml.png[] + +.Procedure +. Click the `Select File` button. +. Load the file that contains the XML entity descriptor information. +. Review the information to ensure everything is set up correctly. + +Some SAML client adapters, such as _mod-auth-mellon_, need the XML Entity Descriptor for the IDP. You can find this descriptor by going to this URL: + +[source, subs="attributes"] +---- +root/auth/realms/{realm}/protocol/saml/descriptor +---- +where _realm_ is the realm of your client.