Skip to main content

Try out SPID

In your sandbox account, you can test an authentication with the SPID Test environment.

Test SPID​

Below, you can find instructions on how to run a test authentication with SPID.

Prerequisites

Make sure SPID is active in your account. Learn more in Add SPID.

Discover your metadata URL​

When you activate SPID, a SAML metadata document gets generated and associated to your domain automatically.

The metadata is available at the following URL: https://<YOUR_SIGNICAT_DOMAIN>/idps/spid/metadata.

For example, if your sandbox domain is https://spidating.sandbox.signicat.com, your metadata URL is https://spidating.sandbox.signicat.com/idps/spid/metadata.

Register your metadata URL​

To test authentications through the official SPID demo environment, you need to register your metadata URL on the SPID demo validator website. To do this:

  1. Go to https://demo.spid.gov.it/, and select Registra Metadata Service Provider.
  2. Insert your metadata URL in the "Metadata URL" box.
  3. Select Download to register your domain with SPID. On the screen, you should see the same XML (SAML 2.0) metadata document as the one hosted at your Signicat metadata URL.

You have now registered your metadata on the SPID demo environment. Return to the Signicat Dashboard to test SPID.

Metadata and domains

Your metadata URL is associated to your Signicat domain. If you create a new domain in the Signicat Dashboard and intend to use that when connecting to SPID, then you need to register the new metadata URL with AgID.

Register metadata

We recommend registering your metadata URL with AgID every time you test your connection to SPID.

Run a test​

  1. In the Signicat Dashboard, navigate to Products > eID and Wallet Hub > eIDs.
  2. Select Test eIDs in the top right.
  3. Optional. Choose SPID, if you activated other eIDs. In production, your end-users can choose among the eIDs active in your account. Learn about how to control this in the IdP scoping documentation.
  4. Select the Entra con SPID ("Login with SPID") button to expand the list of supported identity providers. Then, select SPID Demo from the list.
  5. In the SPID demo environment, enter the credentials of a test user. For example, use:
    • Nome utente (username): lucrezia
    • Password: password123
  6. Select Entra con SPID to proceed. On the next page, select Conferma to give consent to the processing of the personal data fields displayed on screen.
How would this work in production?

In a live scenario in production, the end-user would get redirected to the redirect URL configured through an authentication protocol. Learn how to integrate with a protocol in the Set up SPID guide.

Test users​

To be able to test your SPID implementation, you need a test user. You can get a list of test users from the SPID Demo environment: https://demo.spid.gov.it/users

Here is an example of available test users:

On this page