---
title: Set up Shibboleth Single Sign-On (SSO)
description: Configure and test your Shibboleth SSO integration with Perlego. Follow the steps provided to set up attribute release in Shibboleth and ensure successful login to Perlego using Shibboleth credentials.
---

[Skip to content](https://organisations.perlego.com/support/help-centre/set-up-shibboleth-single-sign-on-sso#main-content)

[Contact Us](https://organisations.perlego.com/support/help-centre/kb-tickets/new?hsLang=en)

[![Logo square format-1](https://organisations.perlego.com/hs-fs/hubfs/Logo%20square%20format-1.png?width=192&height=50&name=Logo%20square%20format-1.png)](https://www.perlego.com)

Open main navigation

Close main navigation

- [Contact Us](https://organisations.perlego.com/support/help-centre/kb-tickets/new)
- [Go to Perlego](https://www.perlego.com/)

[Go to Perlego](https://www.perlego.com/)

 How can we help?

- There are no suggestions because the search field is empty.

1. [Organisation Help Centre](https://organisations.perlego.com/support/help-centre?hsLang=en)
2. [Integrations](https://organisations.perlego.com/support/help-centre/integrations?hsLang=en)
3. [Single Sign-On (SSO)](https://organisations.perlego.com/support/help-centre/integrations?hsLang=en#single-sign-on-sso)

# Set up Shibboleth Single Sign-On (SSO)

## This guide provides all you need to know about configuring and testing your Shibboleth single sign-on (SSO) integration with Perlego.

**Included**: Enhanced, Ultimate  
**Add-on required:** Essentials  
Read more about [plans](https://26048107.hs-sites-eu1.com/knowledge-base/explore-perlegos-subscription-plans?hsLang=en) and [add-ons.](https://26048107.hs-sites-eu1.com/knowledge-base/unlock-additional-features-and-services-with-perlego-add-ons?hsLang=en)

### Table of contents

1. [Configuration](https://organisations.perlego.com/support/help-centre/set-up-shibboleth-single-sign-on-sso#configuration) 
     1. [Share your entity ID](https://organisations.perlego.com/support/help-centre/set-up-shibboleth-single-sign-on-sso#share-your-entity-id)
     2. [Attribute release](https://organisations.perlego.com/support/help-centre/set-up-shibboleth-single-sign-on-sso#attribute-release)
2. [Testing](https://organisations.perlego.com/support/help-centre/set-up-shibboleth-single-sign-on-sso#testing)

### Configuration

> Before you start the configuration make sure:
> 
> - Your organisation is on the Enhanced or Ultimate [plan](https://organisations.perlego.com/support/help-centre/explore-perlegos-subscription-plans?hsLang=en) OR you have purchased the SSO integration as an [add-on](https://organisations.perlego.com/support/help-centre/purchase-add-ons-for-your-organisation?hsLang=en).
> - You have **Shibboleth admin rights.**
> - You have a **Shibboleth account** you can test with (this might be the same email address as your admin account).
> 
> - A **Perlego [access link](https://26048107.hs-sites-eu1.com/knowledge-base/create-and-manage-access-links?hsLang=en)** to test with. You’ll either need the [**Admin Access Link**](https://26048107.hs-sites-eu1.com/knowledge-base/set-up-your-admin-account?hsLang=en) we’ve shared with you or an access link you’ve created in the **[Subscription Manager](https://26048107.hs-sites-eu1.com/knowledge-base/access-the-subscription-manager?hsLang=en).**

#### Share your entity ID

You’ll need to tell us your [**Shibboleth IdP Entity ID**](https://www.ukfederation.org.uk/content/Documents/EntityIDPolicy). It should look similar to this: `https://test-idp.ukfederation.org.uk/idp/shibboleth`.

Send us your `Entity ID` by completing the [Single Sign-On set up form](https://share-eu1.hsforms.com/1ntrBRgXGT5mR18uqd5RiAQfiauj).

If you need them, **Perlego’s Entity ID** and **metadata details** are available from [**eduGain**](https://met.refeds.org/met/entity/https%253A%252F%252Fsp.perlego.com%252Fentity/).

#### Attribute release

We’ll let you know when SSO has been added to your account. The next step will be to release the r**equired attributes**.

You must release the following attributes in the metadata:

| **Attribute** | **Documentation** | **Perlego account field** |
| --- | --- | --- |
| One of the following: \-`givenName` \-`urn:mace:dir:attributedef:givenName` \-`urn:oid:2.5.4.42` | [https://wiki.refeds.org/display/STAN/eduPerson+2020-01#eduPerson202001-givenName](https://wiki.refeds.org/display/STAN/eduPerson+2020-01#eduPerson202001-givenName) | First name |
| One of the following: \-`sn` \-`urn:mace:dir:attribute-def:sn` \-`urn:oid:2.5.4.4` | [https://wiki.refeds.org/display/STAN/eduPerson+2020-01#eduPerson202001-sn](https://wiki.refeds.org/display/STAN/eduPerson+2020-01#eduPerson202001-sn) | Last name |
| One of the following: \-`email` \-`urn:mace:dir:attribute-def:mail` \-`urn:oid:0.9.2342.19200300.100.1.3` | [https://wiki.refeds.org/display/STAN/eduPerson+2020-01#eduPerson202001-mail](https://wiki.refeds.org/display/STAN/eduPerson+2020-01#eduPerson202001-mail) | Email |

### Testing

Once you have released the attributes you are ready to test your SSO login. You’ll need an access link for your account.

- Open the **access link** and accept the `terms and conditions`.
- Click **`Create your account`**.
- You’ll be re-directed to your **Shibboleth** **authentication** page.
- Enter the **Shibboleth credentials** for your test account.
- Once entered you’ll be logged in to **Perlego**.

You can always check the account has been added by visiting the Perlego [**Organisation Subscription Manager**.](https://26048107.hs-sites-eu1.com/knowledge-base/access-the-subscription-manager?hsLang=en)

- [Getting started](https://organisations.perlego.com/support/help-centre/getting-started?hsLang=en)
- [Analytics](https://organisations.perlego.com/support/help-centre/analytics?hsLang=en)
- [Content](https://organisations.perlego.com/support/help-centre/content?hsLang=en)
- [FAQs](https://organisations.perlego.com/support/help-centre/faqs?hsLang=en)
- [General](https://organisations.perlego.com/support/help-centre/general?hsLang=en)
- [Integrations](https://organisations.perlego.com/support/help-centre/integrations?hsLang=en#main-content)

    - [Single Sign-On (SSO)](https://organisations.perlego.com/support/help-centre/integrations?hsLang=en#single-sign-on-sso)
    - [Learning Management Systems (LMS)](https://organisations.perlego.com/support/help-centre/integrations?hsLang=en#learning-management-systems-lms)
- [Library Discovery](https://organisations.perlego.com/support/help-centre/library-discovery?hsLang=en)
- [Managing Users](https://organisations.perlego.com/support/help-centre/managing-users?hsLang=en)
- [Organisation Account](https://organisations.perlego.com/support/help-centre/organisation-account?hsLang=en)
- [Support](https://organisations.perlego.com/support/help-centre/support?hsLang=en)
- [Troubleshooting](https://organisations.perlego.com/support/help-centre/troubleshooting?hsLang=en)
- [AI Tools](https://organisations.perlego.com/support/help-centre/ai-tools?hsLang=en)

[![Chill listening crop-3](https://organisations.perlego.com/hubfs/PerlegoLogoBlack-3.svg "Chill listening crop-3")](https://perlego.com)

Organisation Help Centre

Copyright © 2026, Perlego Limited