Dōrvis

Pieslēgties

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

Drupal Smart-ID, eParaksts un Latvijas banku pieslēgšanos iestata ar OpenID Connect moduli un Generic klientu, kas norāda uz Dorvis. Drupal izveido vai sasaista lietotāja kontu, bet personas kodu, ja vietnei tas vajadzīgs, saglabā neliels pielāgots modulis.

Kuru moduļa versiju izmantot

OpenID Connect modulim ir divas uzturētas versiju līnijas (2026. gada oktobris):

Versiju līnijaDrupal kodolsStatuss
3.0.0-alpha9 (^3.0@alpha)^10.2 vai ^11Alfa versija; vienīgā, kas atbalsta Drupal 11
8.x-1.5 (^1.5)^9.5 vai ^10Stabila; tās drošības atjauninājumus nodrošina Drupal drošības komanda

Generic klienta iestatīšana

  1. Instalējiet moduli

    Drupal 11 vidē izpildiet composer require 'drupal/openid_connect:^3.0@alpha' (Drupal 10 vidē stabilajai versijai – ^1.5), tad ieslēdziet moduli ar drush en openid_connect.

  2. Reģistrējiet novirzīšanas adresi Dorvis portālā

    Modulis atgriež lietotājus uz https://jusu-vietne.lv/openid-connect/KLIENTS, kur KLIENTS ir klienta mašīnnosaukums, piemēram, https://jusu-vietne.lv/openid-connect/dorvis. Pievienojiet šo adresi savai integrācijai Dorvis portālā un nokopējiet client ID un secret.

  3. Izveidojiet klientu

    Atveriet Configuration → People → OpenID Connect (/admin/config/people/openid-connect) un pievienojiet vai ieslēdziet Generic tipa klientu. Ievadiet Client ID, Client secret un Dorvis adreses no tabulas zemāk.

  4. Izvēlieties lietotāju iestatījumus

    Moduļa iestatījumos ieslēdziet Save user claims on every login, lai vārda izmaiņas tiktu pārņemtas. Automatically connect existing users atstājiet izslēgtu: tas sasaista kontus pēc e-pasta, bet Dorvis to nesūta. Ieslēdziet Override registration settings: citādi darbojas Drupal reģistrācijas iestatījums, un jaunus Dorvis lietotājus Drupal noraida (*Administrators only*) vai izveido bloķētus (*Visitors, but administrator approval is required*). Laukā Show external providers in user login form izvēlieties *Above* vai *Below*; 3.x versijā noklusējums ir *Hidden*, un lapā /user/login Dorvis poga neparādās.

  5. Aizstājiet trūkstošo e-pastu

    Lai izveidotu Drupal kontu, modulim nepieciešama e-pasta adrese. Pievienojiet zemāk parādīto nelielo moduli, kas iestata aizvietojošu adresi un saglabā personas kodu.

  6. Notestējiet pieslēgšanos

    Izrakstieties un lapā /user/login izmantojiet pogu "Log in with …". Jauno kontu pārbaudiet sadaļā People.

Generic klienta vērtības Dorvis pakalpojumam

LauksVērtība
Authorization endpointhttps://dorvis.eu/oidc/oauth2/auth
Token endpointhttps://dorvis.eu/oidc/oauth2/token
UserInfo endpointhttps://dorvis.eu/oidc/userinfo
End session endpointhttps://dorvis.eu/oidc/oauth2/sessions/logout
Scopesopenid profile
Issuer URL ar ieslēgtu Use well-known endpoints (aizpilda trīs augstāk minētās adreses)https://dorvis.eu/oidc/ (slīpsvītra beigās ir obligāta, citādi modulis norāda, ka issuer adrese nav derīga)

Pielāgots modulis: aizvietojoša e-pasta adrese un person_code

Ievietojiet šo failā mymodule.module. Alter hook darbojas pirms konta izveides, save hook saņem lietotāja entītiju un datus. Lauku field_person_code veidojiet tikai tad, ja personas koda glabāšanai ir mērķis. Hook signatūras starp alfa versijām var mainīties, tāpēc salīdziniet tās ar openid_connect.api.php savā versijā.

<?php

use Drupal\user\UserInterface;

/**
 * Implements hook_openid_connect_userinfo_alter().
 */
function mymodule_openid_connect_userinfo_alter(array &$userinfo, array $context) {
  // Dorvis e-pastu neatgriež; Drupal kontam tas nepieciešams.
  if (empty($userinfo['email']) && !empty($userinfo['sub'])) {
    $userinfo['email'] = $userinfo['sub'] . '@users.jusu-vietne.lv';
  }
}

/**
 * Implements hook_openid_connect_userinfo_save().
 */
function mymodule_openid_connect_userinfo_save(UserInterface $account, array $context) {
  $userinfo = $context['userinfo'];
  if ($account->hasField('field_person_code') && !empty($userinfo['person_code'])) {
    $account->set('field_person_code', $userinfo['person_code']);
  }
}

Kā uzreiz atvērt Smart-ID vai eParakstu (acr_values)

Bez acr_values Dorvis rāda izvēlni ar visiem integrācijā ieslēgtajiem eID rīkiem, tāpēc pietiek ar vienu Drupal klientu un vienu pogu.

Ja katram eID rīkam vajadzīga sava poga, izveidojiet atsevišķu Generic klientu katram no tiem (piemēram, dorvis_smartid un dorvis_eparaksts) un pievienojiet acr_values autorizācijas adresei: https://dorvis.eu/oidc/oauth2/auth?acr_values=idp:smartid. Drupal veido novirzīšanu ar savu URL API, kas saglabā adresē jau esošos vaicājuma parametrus. Katram klientam ir sava novirzīšanas adrese, tāpēc reģistrējiet tās visas Dorvis portālā.

Katrs klients arī atsevišķi glabā saiti starp Dorvis lietotāju un Drupal kontu. Ja persona pieslēdzas ar vienu pogu un vēlāk ar citu, Drupal to uzskata par jaunu lietotāju, un ar augstāk aprakstīto aizvietojošo e-pastu otrā pieslēgšanās tiek noraidīta ar kļūdu "The email address is already taken". Atsevišķus klientus katram eID rīkam izmantojiet tikai tad, ja lietotāji vienmēr izvēlas vienu un to pašu rīku vai kontus sasaistāt paši; citādi atstājiet vienu klientu un ļaujiet Dorvis rādīt izvēlni.

Vērtības: idp:smartid, idp:eparaksts-mobile, idp:eparaksts, idp:swedbank, idp:seb, idp:citadele, idp:luminor vai idp:edim (Digimaks); katrā pieprasījumā viena vērtība. Ja ērtāk to risināt ar kodu, nevis konfigurāciju, acr_values autorizācijas pieprasījumam var pievienot arī klienta spraudnis, kas paplašina Generic klientu.

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