Dōrvis

Pieslēgties

Microsoft Entra Smart-ID un eParaksts pieslēgšanās External ID vidē

Microsoft Entra Smart-ID, eParaksts un Latvijas banku pieslēgšanos External ID vidē pievieno, reģistrējot Dorvis pakalpojumu ārējā (external) tenant kā pielāgotu OpenID Connect identitātes sniedzēju un pievienojot to reģistrēšanās un pieslēgšanās lietotāja plūsmai. Klienti Entra pieslēgšanās lapā izvēlas "Smart-ID, eParaksts vai banka" un atgriežas ar pārbaudītu vārdu un uzvārdu.

Kas nepieciešams pirms sākšanas

  • Microsoft Entra External ID ārējais tenant un lietotājs ar vismaz External Identity Provider Administrator lomu. OpenID Connect identitātes sniedzēju atbalsts ir vispārēji pieejams (GA) kopš 2025. gada 18. marta.
  • Dorvis integrācija pašapkalpošanās portālā. Smart-ID, eParaksts un banku pieslēgšanai nepieciešams maksas plāns.
  • Piekļuve Microsoft Graph (piemēram, Graph Explorer), lai e-pasta atribūtu padarītu neobligātu, jo Dorvis e-pastu neatgriež.

Kā pievienot Dorvis pakalpojumu kā pielāgotu OpenID Connect sniedzēju

  1. Reģistrējiet Entra novirzīšanas adreses Dorvis portālā

    Dorvis portālā pievienojiet abas adreses: https://TENANT-SUBDOMAIN.ciamlogin.com/TENANT-ID/federation/oauth2 un https://TENANT-SUBDOMAIN.ciamlogin.com/TENANT-SUBDOMAIN.onmicrosoft.com/federation/oauth2. Nokopējiet client ID un client secret.

  2. Atveriet pielāgotos sniedzējus

    Microsoft Entra administrēšanas centrā atveriet Entra ID → External Identities → All identity providers, cilni Custom un izvēlieties Add new → Open ID Connect.

  3. Aizpildiet pamatdatus

    Norādiet Display name (lietotāji to redz uz pieslēgšanās pogas), Well-known endpoint https://dorvis.eu/oidc/.well-known/openid-configuration, OpenID Issuer URI https://dorvis.eu/oidc, Dorvis Client ID un Client Secret.

  4. Izvēlieties autentifikāciju, scope un atbildes tipu

    Laukā Client Authentication izvēlieties client_secret_post (Entra neatbalsta client_secret_basic, un private_key_jwt pagaidām nav atbalstīts). Laukā Scope ierakstiet openid profile. Laukā Response type jābūt code.

  5. Kartējiet datus

    Izvēlieties Next: Claims mapping un kartējiet vērtības kā tabulā zemāk. Email atstājiet nekartētu, tad izvēlieties Review + create.

  6. Pievienojiet lietotāja plūsmai

    Atveriet savu reģistrēšanās un pieslēgšanās lietotāja plūsmu, pievienojiet Dorvis sniedzēju tās identitātes sniedzējiem un saglabājiet. Tad padariet e-pasta atribūtu neobligātu, kā aprakstīts zemāk.

Dorvis datu kartēšana

Entra lauksDorvis vērtībaPiezīme
SubsubPersonas pastāvīgs identifikators konkrētajā integrācijā
NamenameRedzams kontu izvēlē
Given namegiven_namePārbaudījis e-identitātes sniedzējs
Family namefamily_namePārbaudījis e-identitātes sniedzējs
Emailatstājiet tukšuDorvis e-pastu nesūta; padariet atribūtu neobligātu lietotāja plūsmā
Personas kodsnav pieejamsExternal ID kartēšanā nav lauka pielāgotām vērtībām, piemēram, person_code

Kā padarīt e-pastu neobligātu lietotāja plūsmā

Bez šīs izmaiņas reģistrēšanās ar Dorvis pakalpojumu beidzas ar kļūdu AADSTS901011: No email address was obtained from the external oidc identity provider. Nosūtiet pilnu atribūtu ievades lauku sarakstu, ne tikai e-pastu, un ņemiet vērā, ka izmaiņa attiecas uz visām lietotnēm, kas izmanto šo plūsmu.

PATCH https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/{user-flow-id}
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow",
  "onAttributeCollection": {
    "@odata.type": "#microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp",
    "attributeCollectionPage": {
      "views": [{
        "inputs": [
          { "attribute": "email", "label": "Email Address", "inputType": "text", "required": false, "...": "..." },
          { "...": "visi pārējie plūsmas lauki bez izmaiņām" }
        ]
      }]
    }
  }
}
Vispirms ar GET nolasiet šo pašu lietotāja plūsmu un mainiet tikai e-pasta lauka "required" vērtību.

Pielāgotā OIDC sniedzēja ierobežojumi

eID rīku nevar izvēlēties iepriekš. Entra autorizācijas pieprasījumu veido no Dorvis metadatiem, un dokumentācijā nav apraksta, kā pievienot acr_values, tāpēc lietotāji redz Dorvis izvēlni ar visiem integrācijā ieslēgtajiem eID rīkiem. Ja nepieciešams tikai Smart-ID, šajā Dorvis integrācijā ieslēdziet tikai Smart-ID.

Personas kods Entra nav pieejams. Datu kartēšana aptver tikai standarta vērtības. Ja lietotnei nepieciešams person_code, šim solim tā var pati pieslēgties Dorvis pakalpojumam ar OpenID Connect. Esošie B2C klienti var izmantot Azure AD B2C pielāgotās politikas.

Issuer maiņa. Microsoft norāda: ja Issuer URI vēlāk maina, izmaiņa var nestāties spēkā, līdz sniedzēju lietotāja plūsmā atslēdz, plūsmu saglabā, sniedzēju atkal ieslēdz un plūsmu saglabā vēlreiz.

Alternatīva esošiem Azure AD B2C tenant: pielāgotā politika

Kopš 2025. gada 1. maija Microsoft Azure AD B2C jauniem klientiem nepārdod; esošos tenant tā atbalstīs vismaz līdz 2030. gada maijam. B2C pielāgotajā politikā OpenID Connect tehniskais profils var nosūtīt acr_values kā ievades vērtību un nolasīt person_code kā izvades vērtību. Aprakstiet acr_values un personCode savā ClaimsSchema un Dorvis portālā reģistrējiet novirzīšanas adresi https://TENANT.b2clogin.com/TENANT.onmicrosoft.com/oauth2/authresp.

<TechnicalProfile Id="Dorvis-SmartId">
  <DisplayName>Smart-ID</DisplayName>
  <Protocol Name="OpenIdConnect" />
  <Metadata>
    <Item Key="METADATA">https://dorvis.eu/oidc/.well-known/openid-configuration</Item>
    <Item Key="client_id">DORVIS_CLIENT_ID</Item>
    <Item Key="response_types">code</Item>
    <Item Key="scope">openid profile</Item>
    <Item Key="HttpBinding">POST</Item>
    <Item Key="UsePolicyInRedirectUri">false</Item>
  </Metadata>
  <CryptographicKeys>
    <Key Id="client_secret" StorageReferenceId="B2C_1A_DorvisClientSecret" />
  </CryptographicKeys>
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="acr_values" DefaultValue="Smartid" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="sub" />
    <OutputClaim ClaimTypeReferenceId="givenName" PartnerClaimType="given_name" />
    <OutputClaim ClaimTypeReferenceId="surname" PartnerClaimType="family_name" />
    <OutputClaim ClaimTypeReferenceId="personCode" PartnerClaimType="person_code" />
    <OutputClaim ClaimTypeReferenceId="identityProvider" DefaultValue="dorvis.eu" />
    <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" />
  </OutputClaims>
  <UseTechnicalProfileForSessionManagement ReferenceId="SM-SocialLogin" />
</TechnicalProfile>

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