Skip to content
DEVELOPER DOCUMENTATION
/
/Logout

ESP APIs (26.0.0)

ESP APIs provide authentication flows via SPID, CIE, CNS, and EIDAS. Use these endpoints to obtain a session key, initiate a login, and retrieve a JWT containing the user's identity attributes.

Official ESP documentation
Download OpenAPI description
openapi.json
openapi.yaml
Overview
License
Apache 2.0
Languages
Servers
Development and testing environment
https://esp-saas.test.namirialtsp.com
Production environment
https://esp-saas.namirialtsp.com

Get Key

Returns a session key (authnKey) to initiate an authentication flow with SPID, CIE, or EIDAS.

Operations

Login

Initiates the authentication flow with SPID/EIDAS, CIE, or CNS.

Operations

Logout

Initiates the SPID logout flow. Not required for Level 2 authentications.

Operations

Logout for SPID

Request

Initiates the SPID logout flow. Not required for Level 2 authentications.

Path
environment_namestringrequired

The integration name provided to the customer

Example: myintegration
Query
finalstringrequired

Redirect URL called at the end of the authentication process. Provided during the assessment phase.

Example: final=http://localhost
curl -i -X GET \
  'https://esp-saas.test.namirialtsp.com/myintegration/logout?final=http%3A%2F%2Flocalhost'

Responses

Logout successful

Get user

Exchanges the session id and key (returned after login) for a JWT containing the user's identity attributes.

Operations