Idfyed Playground is a set of instructions, documentation and tools that can be used by an Idfyed customer during evaluation of the services. It is not a complete integration instruction. Using the playground it is possible to develop a web application that uses Idfyed for authentication and identification of users.
The Idfyed Playground is intended primarily for technically minded persons that need to understand the technical structure of the Idfyed service and how to integrate it in the customer environment.
A good starting point is to get familiar with the different integration points is through the API documentation. A number of concepts and terms referred to in the remainder of this document are explained in the documentation:
Install the App
To install the app you can either click the icons above in your browser of your device or open the App store or Play Store App on the device and search for Idfyed.
Playground Relying Party
To allow evaluation and practical test of the API and the service a test relying party (RP) has been set up in the production environment. The RP is the fictitious company ACME Inc.
Relying Party Configuration
The playground relying party uses Idfyed for authentication.
|Company MAC Key||N/A||LW4eUhQkJfwJGgQU8JCT/g==|
The playground relying party will request the following information from users logging in:
|Fictitious loyalty number||
||Optional - verified|
||Mandatory - non-verified|
||Mandatory - non-verified|
To be able to integrate with the playground the API endpoint
https://login.idfyed.com/main-eapi/begin should be
used. This is necessary for the playground login to work properly with the playground version of the app and the relying
Using the form at https://login.idfyed.com/test-eapi/ a login can be emulated. This webform performs an operation that normally would be done by the application integrating Idfyed for authentication and identification.
In the form the CompanyName
playground, and the key
LW4eUhQkJfwJGgQU8JCT/g== should be entered. All other values
can be kept as default.
In some scenarios, adding an attribute to a user where the RP decides the value is required. This scenario is called a
connect. For example if you join a loyalty program, the RP might want to add the loyalty program number to your
The playground RP has been equipped with the possibility to connect the attribute
acme_loyaltyNumber and this can be
done in two ways.
- Frontend connect - Adding the new parameter in the EAPI request. This is the fastest integration choice and also the only choice in any case where the user is previously unknown to the RP.
- Back-end connect - the application calls an authenticated back-end channel over REST adding the attribute to the user. User will then be prompted to add the attribute to the Idfyed profile.
Try Frontend connect
Using the form at https://login.idfyed.com/test-eapi/ as in "Try Login" plus filling out the
Ambassador part of the
form, frontend connect can be emulated. Try to add
Ambassador field to accomplish
the task to add 1234 as loyalty number.
For more information, see EAPI documentation mentioned above under the section with
Try Back-end connect
Using the form at (https://login.idfyed.com/test-rp-mgmt/attributes.jsp) back-end connect can be emulated. The web-form is a simple wrapper for the REST API call that exposes back-end connect API.
This call will notify the user with userid
77063... to add
rp_acme_loyaltyNumber to the profile. The userId is fetched
from a previous authentication of the user in "Try Login".
This is the preferred way to add and the only way to do remove of user attributes and is also the most user friendly way for connect.
Back-end connect requires a number of parameters seen in the screen dump, below is a description of each. See documentation for more details.
|UserID||The user id returned when user logs into
|action||ADD/REMOVE. Note: it is only the
|attribute(value)||loyalty number of your choice|
A sample web application that demonstrates the different possibilities exposed by the service.
You need sample code for a platform not listed? Let us know!
Contact & Feedback
If you have any questions, improvement suggestions or any other reason to talk to us; please don’t hesitate to contact us: