Elektroniskā paraksta nodrošinātāja API

Iegūstiet parakstīšanas identitātes informāciju

Ir divu veidu parakstīšanas identitātes — viena elektroniskajai parakstīšanai un otra autentifikācijai

Pieprasījums

GET /trustedx-resources/esigp/v1/sign_identities/{sign_identity_id}

Autorizācija

Pieprasījumā ir jāietver nesēja piekļuves marķieris, ko ģenerējis tā pakalpojuma uzticams autorizācijas serveris, no kura tiek pieprasīta informācija par parakstīšanas identitāti, un kas ir saistīts ar domēnu, kuram pieder identitāte. Šis marķieris ir jāizmanto atbilstoši RFC 6750. Tam ir jābūt urn:safelayer:eidas:sign:identity:profile tvērumam (scope).

Marķieris ir jāiekļauj HTTP autorizācijas galvenē šādi:

Authorization: Bearer <token>

Piekļuves marķieri var iegūt, izmantojot autorizācijas koda piešķiršanu vai pakalpojumu sniedzēja akreditācijas datu piešķiršanas OAuth 2.0 plūsmu.

Piemērs

GET /trustedx-resources/esigp/v1/sign_identities/12345678 HTTP/1.1
Authorization: Bearer mF_9.B5f-4.1JqM

Atbilde

Atbildes pamatteksta attēlojums JSON formātā ir norādīts tālāk

{
 "id" : {string},
 "self" : {string},
 "description" : {string},
 "labels" : [ {string} ],
 "type" : {string},
 "device_id" : {string},
 "domain" : {string},
 "access" : [ {
     "user_id" : {string}
 } ]
 "details" : {
      "certificate" : {string},
      "activation_mode": {string},
      "public_key" : {string}
 },
 "links" :  {
      <operation_alias> : {
           "auth" : {
               "oauth2": {
                  "scopes": [ {string} ]
               }
           }
      }   
      },
 "status" : {
    "value" : {string},
    "reason" : {string}
 }
}

Izveidojiet digitālo parakstu serverī

Apraksts

Izveido datu ciparparakstu (PKCS #1), izmantojot parakstīšanas identitāti serverī. Kā ievadi var saņemt datu jaucējvērtību (hash) vai baitu virkni, kas jāparaksta neapstrādātā veidā.

Paraksts tiek izveidots ar parakstīšanas identitāti serverī, kas norādīts pieprasījumā. Šai identitātei ir jāpieder galalietotājam, kura vārdā tiek veikta darbība.

Pieprasījums

POST /trustedx-resources/esigp/v1/signatures/server/raw

Content-type galvene

Content-Type: application/json

Pamatteksts (body)

{
 "digest_value" : {string},
 "signature_algorithm" : {string},
 "sign_identity_id" : {string}
}

Piemērs

POST /trustedx-resources/esigp/v1/signatures/server/raw
Host: eidas.eparaksts.lv
Content-Type: application/json
Authorization: Bearer cbc...6daf
Content-Length: 213
{
   "digest_value" : "n4bQgYhMfWWaL+qgxVrQFaO/TxsrC4Is0V1sFbDwCgg",
   "signature_algorithm" : "rsa-sha256",
   "sign_identity_id" : "nio...omq"
}

Atbilde

Atbilde satur PKCS #1 paraksta bināro vērtību.

Serverī izveidojiet digitālā paraksta partiju

Apraksts

Izveido digitālu parakstu partiju no datu jaucējvērtībām (hash), kas jāparaksta, izmantojot servera parakstīšanas identitāti.

Paraksts tiek izveidots ar parakstīšanas identitāti serverī, kas norādīts pieprasījumā. Šai identitātei ir jāpieder galalietotājam, kura vārdā tiek veikta darbība.

Apraksts

POST /trustedx-resources/esigp/v1/signatures/server/raw/batch

Content-type galvener

Content-Type: application/json

Pamatteksts (body)

{
    "sign_identity_id" : {string},
    "signature_algorithm" : {string},
    "requests" : [
        {
            "digest_value" : {string},
            "signature_algorithm" : {string}
        }
    ]
}

Piekļuves kontrole

Pieprasījumā ir jāietver nesēja piekļuves marķieris (bearer access token), ko ģenerējis uzticams autorizācijas serveris, kas ir saistīts ar paraksta identitātes domēnu, ko jāizmanto paraksta ģenerēšanai. Šim marķierim (token) ir jābūt tvērumam (scope), kas ietver parakstīšanas identitātei konfigurēto vērtību (pēc noklusējuma urn:safelayer:eidas:sign:identity:use:server ), un tas ir jāizmanto atbilstoši RFC 6750. Būtībā marķieris ir jāiekļauj Autorizācijas galvenē šādi:

Authorization: Bearer <token>

Piekļuves marķieris ir jāiegūst, izmantojot autorizācijas koda piešķiršanas OAuth 2.0 plūsmu.

Piemērs

POST /trustedx-resources/esigp/v1/signatures/server/raw/batch
Host: eidas.eparaksts.lv
Content-Type: application/json
Authorization: Bearer cbc...6daf
Content-Length: 213
{
    "sign_identity_id": "12345678",
    "signature_algorithm": "rsa-sha1",
    "requests": [
        {
            "digest_value": "RXN0byBlcyB1biBoYXNoIFNoYTE=",
            "signature_algorithm": "rsa-sha1"
        },
        {
            "digest_value": "siHZ27CDp/M0KNfCo8MZiuklYU1wIQ4ocWzKp81N23k",
            "signature_algorithm": "rsa-sha256"
        }
    ]
}

Atbilde

Pamatteksts (body)

{
    "signatures" : [ {string} ]
}