Kas nepieciešams pirms sākšanas
- Auth0 tenant ar plānu, kurā ir enterprise savienojumi, un Dashboard lietotājs, kas drīkst pārvaldīt savienojumus.
- Dorvis konts un integrācija pašapkalpošanās portālā. Kontu izveido Dorvis komanda; testa rekvizītus var pieprasīt bez līguma. Bezmaksas plānā pieejams Digimaks; Smart-ID, eParaksts un banku pieslēgšanai nepieciešams maksas plāns.
- Līgums ar SK ID Solutions Smart-ID produkcijas videi un līgumi ar bankām banku pieslēgšanai. Ar testa rekvizītiem var izveidot un pārbaudīt visu savienojumu, bet Smart-ID ar īstiem klientiem darbojas tikai pēc uzņēmuma paša līguma noslēgšanas. Pieteikumus uzņēmuma vietā var sagatavot Dorvis komanda, ja izvēlēts starta komplekts.
- Management API token ar
read:connectionsunupdate:connectionstiesībām datu kartēšanai unacr_valuesiestatīšanai.
Kā izveidot OpenID Connect savienojumu
Reģistrējiet Auth0 atgriešanās adresi Dorvis portālā
Dorvis portālā pievienojiet novirzīšanas adresi
https://JUSU_AUTH0_DOMENS/login/callback(vaihttps://JUSU_DOMENS/login/callback, ja Auth0 tenant izmanto pielāgotu domēnu). Nokopējiet client ID un client secret.Sāciet jaunu savienojumu
Auth0 Dashboard atveriet Authentication → Enterprise, atrodiet OpenID Connect un izvēlieties Create. Laukā Connection name ierakstiet, piemēram,
dorvis; vēlāk to mainīt nevar.Norādiet Dorvis adresi un client ID
Laukā OpenID Connect Discovery URL ievadiet
https://dorvis.eu/oidc/.well-known/openid-configuration, laukā Client ID – Dorvis client ID.Izmantojiet back channel
Laukā Communication Channel izvēlieties Back Channel un ievadiet Client Secret. Tad Auth0 izmanto autorizācijas koda plūsmu un koda apmaiņa notiek starp serveriem, kā to paredz Dorvis. Front Channel (
response_type=id_token) nav piemērots.Iestatiet scopes un profila sinhronizāciju
Cilnē Settings laukā Scopes ierakstiet
openid profileun atstājiet ieslēgtu Sync user profile attributes at each login, lai vārda izmaiņas nonāktu Auth0.Ieslēdziet savienojumu lietotnēm
Ieslēdziet savienojumu lietotnēm, kurās tam jābūt pieejamam, un cilnē Login Experience ieslēdziet Display connection button ar nosaukumu, piemēram, "Smart-ID, eParaksts vai banka".
Savienojuma iestatījumi Dorvis pakalpojumam
| Auth0 iestatījums | Vērtība | Piezīme |
|---|---|---|
| OpenID Connect Discovery URL | https://dorvis.eu/oidc/.well-known/openid-configuration | Auth0 no tā nolasa adreses un atslēgas |
| Communication Channel | Back Channel | Autorizācijas koda plūsma ar client secret |
| Callback URL (reģistrē Dorvis portālā) | https://JUSU_AUTH0_DOMENS/login/callback | Redzams savienojuma lapā |
| Scopes | openid profile | Auth0 datus nolasa no ID token, nevis no /userinfo |
| Sync user profile attributes at each login | Ieslēgts | Uztur aktuālus given_name un family_name |
options.attribute_map | use_map ar tālāk norādīto veidni | Pārnes person_code uz Auth0 profilu |
options.upstream_params | acr_values (nav obligāts) | Uzreiz atver vienu eID rīku |
Dorvis datu kartēšana un eID rīka izvēle
Abi iestatījumi atrodas savienojuma options. Datu kartējumu var labot arī savienojuma cilnes Settings laukā User Mapping, bet upstream_params iestatīšanai nepieciešams Management API. PATCH aizstāj visu options objektu, tāpēc vispirms nolasiet savienojumu ar GET, papildiniet tā options un nosūtiet tos pilnībā.
// PATCH https://JUSU_AUTH0_DOMENS/api/v2/connections/CONNECTION_ID
{
"options": {
"...": "visi esošie options no GET",
"attribute_map": {
"mapping_mode": "use_map",
"attributes": {
"given_name": "${context.tokenset.given_name}",
"family_name": "${context.tokenset.family_name}",
"name": "${context.tokenset.name}",
"person_code": "${context.tokenset.person_code}"
}
},
"upstream_params": {
"acr_values": { "value": "Smartid" }
}
}
}Atsevišķas pogas Smart-ID, eParaksts un bankām
Statiska upstream_params vērtība attiecas uz katru pieslēgšanos caur šo savienojumu. Atsevišķām pogām izveidojiet savienojumu katram eID rīkam (piemēram, dorvis-smartid ar idp:smartid, dorvis-eparaksts ar eParaksts-mobile,eParaksts) un katram savienojumam Dorvis portālā reģistrējiet to pašu Auth0 atgriešanās adresi.
Lietotnes Auth0 pieslēgšanās lapu var izlaist, pievienojot /authorize pieprasījumam connection=dorvis-smartid. Auth0 atļauj acr_values izmantot kā alias, taču norāda, ka ne visi identitātes sniedzēji atbalsta šādu parametru nodošanu. Tāpēc dinamisko variantu vispirms notestējiet savā tenant.
Vērtības: idp:smartid, idp:eparaksts-mobile, idp:eparaksts, idp:swedbank, idp:seb, idp:citadele, idp:luminor vai idp:edim (Digimaks). Vienā pieprasījumā Dorvis ņem vērā vienu vērtību.
Post-login Action: person_code tikai vienai lietotnei
Auth0 kartētos atribūtus token automātiski nepievieno. Pievienojiet pielāgotu vērtību tikai tai lietotnei, kurai personas kods tiešām nepieciešams.
exports.onExecutePostLogin = async (event, api) => {
if (event.connection.strategy !== 'oidc') return;
if (event.client.client_id !== event.secrets.APP_CLIENT_ID) return;
const personCode = event.user.person_code;
if (personCode) {
api.idToken.setCustomClaim('https://jusu-lietotne.lv/person_code', personCode);
}
};Neatradāt atbildi?
Rakstiet mums, atbildēs Dorvis izstrādātājs.






