Date: Thu, 28 Mar 2024 21:11:34 +0000 (UTC) Message-ID: <1824525691.1.1711660294930@3b37fb8988c8> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_0_52761549.1711660294917" ------=_Part_0_52761549.1711660294917 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
The EDS is made available as a noarch RPM. This allows you to manage you= r installation and perform upgrades in an automated fashion. Given that the= EDS is entirely in "webspace", you can certainly choose to deploy it yours= elf (see the section on Other Platforms).
The RPM repositories for each platform we support are available by acces=
sing the web form at https://shibboleth.net/downloads/service-provider/RPMS/ t=
o generate the appropriate file to place in your repository directory (typi=
cally /etc/yum.repos.d/
).
You can turn the repository on and off by adjusting the "enabled" proper= ty in the file, such as to prevent automated updates and maintain manual co= ntrol. While enabled, the yum command will "see" the Shibb= oleth packages when you perform standard operations, and installing the EDS= should require only a single command:
$ yum i= nstall shibboleth-embedded-ds
If you prefer to install by hand, you can find the source distribution a= t ht= tps://shibboleth.net/downloads/embedded-discovery-service/
The Installation places the files you will need to configure the EDS into /etc/shibboleth-ds
=
.
It then configures the Apache webserver to serve the EDS files (includin= g the ones you use to configure) as:
/shibboleth-ds/idpselect_config.js
/shibboleth-ds/=
idpselect.js
/shibboleth-ds/idpselect.css
/=
shibboleth-ds/index.html
used for testing
The Embedded Discovery Service (EDS) is a set of CSS and Javascript file= s. To install them you'll need to serve these files up via your web server.= Refer to your web server documentation if you're unsure how to serve up st= atic documents.
Because of browser security, the files need to be located on the same do= main as the SP.
Download the Embedded Disco= very Service Distribution
Unzip the distribution
Copy the Javascript files (idpselect_config.js
and id=
pselect.js
, and the CSS (idpselect.css
) files in to the=
location from where your web server is serving static content.
For testing purposes you may chose to copy the index.html
f=
ile to the same location.
Once complete, open a browser and test to make sure each file is reachab= le.
There are two ways to go about setting up the web page that will act as = the actual discovery service.
The first way, useful for testing, is to use the index.html
=
file that comes with the EDS distribution.
If, however, you'd like to embed the discovery service in to an existing= page template you have for your site (the behavior we'd expect for an prod= uction install) then make the following modifications to your HTML page:
Within the head
element add a link to the discovery service=
CSS page similar to:
<lin= k rel=3D"stylesheet" type=3D"text/css" href=3D"idpselect.css">
Within the body
element add the following div
=
element in the location you wish to use for the upper-left corner of the di=
scovery service (i.e., where you want it to start rendering):
<div= id=3D"idpSelect"></div>
At the bottom of the body
element (just before the closing =
tag) add the following script definitions:
<!--= Load languages scripts --> <script src=3D"idpselect_config.js" type=3D"text/javascript" language=3D= "javascript"></script> <script src=3D"idpselect.js" type=3D"text/javascript" language=3D"javasc= ript"></script>
The <script>
element must appear after the <=
div>
element in the document.
Now, if you're testing against a brand new Service Provider 2.4 install = you can test at this point (since 2.4 comes with the discovery data feed co= nfigured by default). If you upgraded to 2.4 from a previous version you wi= ll need to complete the Service Provider configuration steps given in the n= ext section before you can test.
So, if you want to and can test at this point, then open a web browser a= nd go to the embedded discovery service page. If everything is working okay= you'll see the discovery service rendered.