Skip to content

Enroll disposable certificate with eID assertion

Request

Enrolls a disposable certificate using an eID assertion. Returns certificate details and OTP identifier (if otpType=SMS or otpType=EMAIL). See enrollDisposableWitheIDAssertion and How to enroll with eID assertion.

Security
basicAuth and sslCertificate
Path
lraIdstringrequired

Local Registration Authority (LRA) identifier.

Bodyapplication/jsonrequired
eidAssertionHolderobject(DisposableeIDAssertionHolder)required

eID assertion holder data. Contains the eID type, country, and base64-encoded assertion.

certificateobject(DisposableCertificate)required

Certificate configuration. Specifies password, security code, certificate type, and OTP type.

contactsobject(DisposableContacts)

Contact information. Required if certificate.otpType=SMS (provide mobile) or certificate.otpType=EMAIL (provide email).

buReIdstring

Business relation identifier (optional).

Enroll with IT-EIDNAMIRIAL eID assertion. The assertion is a base64-encoded JSON with current iat timestamp.

curl -i -X POST \
  -u '<username>:<password>' \
  'https://lean.namirialtsp.com/RAWS_DISPOSABLE/api/certificate/{lraId}/enrollDisposableWitheIDAssertion' \
  -H 'Content-Type: application/json' \
  -d '{
    "eidAssertionHolder": {
      "country": "IT",
      "eIDType": "EIDNAMIRIAL",
      "assertion": "eyJnaXZlbl9uYW1lIjoiTWFyaW8iLCJmYW1pbHlfbmFtZSI6IlJvc3NpIiwicGVyc29uX2lkZW50aWZpZXIiOiJUSU5JVC1SU1NNUkE4MEEwMUg1MDFVIiwiYmlydGhfZGF0ZSI6IjE5ODAtMDEtMDEiLCJkb2NfdHlwZSI6Ik5BVElPTkFMX0lERU5USVRZX0NBUkQiLCJjb3VudHJ5IjoiSVQiLCJycF9uYW1lIjoiTmFtaXJpYWwgVGVzdCBSUCIsInJwX2lkIjoidGVzdC1ycC0wMDEiLCJvcmlnaW5hbF9hc3NlcnRpb24iOiJiYXNlNjRfZW5jb2RlZF9zYW1sX2Fzc2VydGlvbl9oZXJlIiwiaWF0IjoxNzA5NTY4MDAwfQ=="
    },
    "contacts": {
      "mobile": "+390000000000"
    },
    "certificate": {
      "fullData": false,
      "otpType": "SMS",
      "password": "Password01",
      "securityCode": "Security01",
      "type": "DISPOSABLE"
    }
  }'

Responses

Disposable certificate enrolled successfully. Returns certificate details and OTP identifier (if applicable). See DisposableIssued.

Bodyapplication/json
certstring, (binary)

Base64-encoded DER certificate.

certTypestring(DisposableType)

Certificate type, as specified in disposableCertificate.type.

Enum:"DISPOSABLE""DISPOSABLE_30_DAYS""LONG_LIVED""DISPOSABLE_FEA"
certUsageLimitstring

Limitation of use (LoU) text embedded in the certificate.

certSerialNumberstring

Certificate serial number (hex).

Example:"60F2373BFCEB569E"
certIdOtpinteger or null, (int32)

OTP certificate identifier. Pass this value to sendOtp and validate. null if otpType=NO_OTP or otpType=EXTERNAL_OTP.

Example:1234567
deviceCodestring

Device code associated with the issued certificate. Pass this value to sendOtp and validate.

Example:"RHIDP0000000000000"
Response
{ "cert": "string", "certType": "DISPOSABLE", "certUsageLimit": "string", "certSerialNumber": "60F2373BFCEB569E", "certIdOtp": 1234567, "deviceCode": "RHIDP0000000000000" }