For the complete documentation index, see llms.txt. You can also append .md to any page URL to get its markdown version.
Skip to main content
For the complete documentation index, see llms.txt.

For the complete documentation index, see llms.txt

Try it out

This guide shows you how to set up a test wallet and test an authentication flow with the EUDI Wallet.

Prerequisites​

Before you begin testing, make sure you meet the following requirements:

  • Enabled EUDI Wallet: You need to add the EUDI Wallet to your Signicat account. For instructions, see Configure the EUDI Wallet.
  • Configured authentication protocol: You need to set up a connection using OpenID Connect, Authentication REST API or SAML 2.0.
  • Mobile phone: You need a physical mobile device, such as a smartphone, to install the wallet application.
  • Email address: You need a valid email address to receive and accept your test credentials.

Set up your test wallet​

Because identity wallets are decentralised and store data directly on your mobile device, you cannot use simulated web credentials. Instead, you need to download a wallet application on your smartphone to issue mock Person Identification Data (PID).

Signicat supports testing with the iGrant Data Wallet app in combination with the EUDI Wallet connector in the sandbox environment. Then, you can issue the PID into the iGrant wallet using the iGrant issuing service.

1. Download the iGrant Data Wallet​

You first need to download the iGrant Data Wallet on your test mobile device:

For more details on the application, visit the iGrant Data Wallet website.

2. Issue a test PID to your wallet​

The iGrant issuing service allows you to issue mock PID credentials to your wallet. You can complete this using either a cross-device flow or a same-device flow.

  1. On your desktop computer, go to the iGrant PID issuing page and click Next.
  2. Under Request Test PID, choose PID Rulebook (1.7) as your data model.
  3. Fill in your email address. Optionally, you can edit the other data fields to match the test user profiles you use in your own systems.
  4. Click Request PID to submit your request. You will receive an email from iGrant containing your test credentials.
  5. Check your email and open the email from the iGrant Services. Note the QR code with the PID credentials to add to your wallet.
  6. On your mobile device, open the iGrant Data Wallet app. Alternatively, you can open the app directly from the email link if you open the email from your mobile device.
  7. In the iGrant Data Wallet app, scan the QR code you received in the email. Alternatively, go to Connections, tap the plus icon (+) to add a new connection and scan the QR code you received in the email.
  8. On the WE BUILD Consortium window, select Connect
  9. Enter the PIN you received in the email. Then, review your connection and select Accept.
  10. On the desktop computer return to the iGrant website, then click Next. You can return to this page by clicking the link provided in step 2 of the email.
  11. In your wallet app, navigate to Data Wallet and select Scan to scan the QR code displayed on the desktop screen to complete the issuing. Select Confirm to agree to share the test data.
Wallet configuration complete

You have now successfully configured your wallet app. You can use the iGrant Data Wallet app when testing your flows with the eID and Wallet Hub.

Test the authentication flow​

Once you have configured your iGrant Data Wallet and added the test PID, you can test the authentication flow through your configured protocol.

Important

Make sure that your authentication request includes at least one requested attribute, as described in the table below.

To complete the test authentication flow:

  1. Start an authentication request using your configured protocol (through OAuth Tools, Postman or your application) and select EUDI Wallet if prompted.
  2. Signicat displays a QR code on your desktop browser. Open the iGrant Data Wallet app on your mobile device and scan the QR code.
  3. On your mobile device, review the attribute sharing request, then approve the authentication by entering your personal code or by verifying with biometrics.
  4. Return to your desktop browser or API client to review the returned user attributes in the response payload.
Need help?

If you require assistance or need to report an issue, you can contact us by creating a support ticket in the Signicat Dashboard.

Next steps​

To explore the supported attributes and claims for the EUDI Wallet, see the attributes reference: