Dōrvis

Pieslēgties

Auth0 Smart-ID un eParaksts pieslēgšanās ar Dorvis

Auth0 Smart-ID, eParaksts un Latvijas banku pieslēgšanos pievieno ar Auth0 OpenID Connect enterprise savienojumu, kas norāda uz Dorvis. Lietotnes turpina strādāt ar Auth0 kā līdz šim, un Dorvis pakalpojums apstrādā pieslēgšanos ar Latvijas e-identitātēm un atgriež pārbaudītu vārdu, uzvārdu un personas kodu.

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:connections un update:connections tiesībām datu kartēšanai un acr_values iestatīšanai.

Kā izveidot OpenID Connect savienojumu

  1. Reģistrējiet Auth0 atgriešanās adresi Dorvis portālā

    Dorvis portālā pievienojiet novirzīšanas adresi https://JUSU_AUTH0_DOMENS/login/callback (vai https://JUSU_DOMENS/login/callback, ja Auth0 tenant izmanto pielāgotu domēnu). Nokopējiet client ID un client secret.

  2. 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.

  3. 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.

  4. 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.

  5. Iestatiet scopes un profila sinhronizāciju

    Cilnē Settings laukā Scopes ierakstiet openid profile un atstājiet ieslēgtu Sync user profile attributes at each login, lai vārda izmaiņas nonāktu Auth0.

  6. 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ījumsVērtībaPiezīme
OpenID Connect Discovery URLhttps://dorvis.eu/oidc/.well-known/openid-configurationAuth0 no tā nolasa adreses un atslēgas
Communication ChannelBack ChannelAutorizācijas koda plūsma ar client secret
Callback URL (reģistrē Dorvis portālā)https://JUSU_AUTH0_DOMENS/login/callbackRedzams savienojuma lapā
Scopesopenid profileAuth0 datus nolasa no ID token, nevis no /userinfo
Sync user profile attributes at each loginIeslēgtsUztur aktuālus given_name un family_name
options.attribute_mapuse_map ar tālāk norādīto veidniPārnes person_code uz Auth0 profilu
options.upstream_paramsacr_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" }
    }
  }
}
Noņemiet upstream_params, ja eID rīku lietotājam jāizvēlas Dorvis logā. Ja "value" vietā norāda { "alias": "acr_values" }, vērtību nodod no lietotnes /authorize pieprasījuma.

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.

Uzdot jautājumu
Ielāde ir pabeigta

Mēs izmantojam sīkdatnes, lai vietne darbotos un mēs varētu to uzlabot. Plašāka informācija ir mūsu privātuma un sīkdatņu politikā.