3. Solis: Parakstīšanas autorizācija

Jaucējvērtības (Hash) parakstīšanas PAR pieprasījums

Izsaukums izveido autorizācijas pieprasījumu, kas piesaistīts konkrētajai parakstīšanas identitātei (credential), jaucējvērtības (hash) algoritmam un vienam vai vairākām dokumentu jaucējvērtībām (hash).

HTTP pieprasījums

POST {{csc_base_url}}/oauth2/pushed_authorize
Authorization: Basic BASE64(client_id:client_secret)
Content-Type: application/x-www-form-urlencoded
 
response_type=code
client_id={{client_id}}
redirect_uri={{redirect_uri}}
scope=credential
state={{oauth_state}}
credentialID={{credential_id}}
numSignatures=1
hashes={{hash_base64}}
hashAlgorithmOID={{hash_algorithm_oid}}
acr_values={{acr_values}}
code_challenge_method=S256
code_challenge={{code_challenge}}

Ieejas parametri:

Atbildes struktūra ir tāda pati kā credential PAR pieprasījumam:

{
"request_uri": "urn:ietf:params:oauth:request_uri:<identifier>",
"expires_in": 60
}

No request_uri izveido jaunu authorize_url un pārlūkā veic parakstīšanas apstiprināšanu.

Callback parametrā saņemtā state vērtība jāsalīdzina ar tieši šīs parakstīšanas plūsmas oauth_state.

Pieprasījumā ir atļauta vienreizējā parakstīšanās (Single Sign-On) izmantošana, tādēļ autentifikācija netiek prasīta atkārtoti, ja lietotājam jau ir derīga autentifikācijas sesija. Savukārt paraksta apstiprināšana tiek pieprasīta katrā parakstīšanas reizē.

Parakstīšanas autorizācijas koda apmaiņa pret marķieri (tokenu)

Izsaukums apmaina parakstīšanas apstiprināšanas callback kodu pret konkrētajiem hash
piesaistītu īslaicīgu Bearer tokenu.

HTTP pieprasījums

POST {{csc_base_url}}/oauth2/token
Authorization: Basic BASE64(client_id:client_secret)
Content-Type: application/x-www-form-urlencoded
 
grant_type=authorization_code
client_id={{client_id}}
code={{authorization_code}}
redirect_uri={{redirect_uri}}
code_verifier={{code_verifier}}

Ieejas parametri

Ieejas parametri ir identiski sadaļā "Autorizācijas koda apmaiņa" aprakstītajiem. Jāizmanto parakstīšanas plūsmas jaunais authorization_code un tieši tai ģenerētais code_verifier , nevis credential
iegūšanas plūsmas vērtības.

Atbildes piemērs:

{
"access_token": "<redacted>",
"token_type": "Bearer",
"expires_in": 120,
"authorization_details": [
{
"type": "digest_signing",
"digests": [
{
"value": "<SHA-384-hash-in-Base64>",
"algorithm": "SHA-384"
}
],
"sign_identity_id": "<credential-id>",
"num_signatures": 1
}
]
}

Atbildes parametri un validācija

⚠️

Svarīgi

Pirms signHash izsaukuma integratoram jāpārbauda, ka tokenā norādītās digests.value, hash algoritma, credential_id un num_signatures vērtības atbilst lietotāja apstiprinātajām vērtībām PAR/autorizācijas plūsmā.