Skapa anpassade signeringsflöden med MitID Erhverv

Det nya MitID Erhverv ("MitID för företag") ger anställda ett säkert och bekvämt sätt att hantera olika digitala uppgifter på uppdrag av sina organisationer. Det handlar bland annat om att läsa digital post, anmäla föräldraledighet och sjukdom samt få tillgång till offentliga tjänster.

Men det tar inte slut där!

Föreställ dig bekvämligheten i att signera dokument med MitID Erhverv med verifiering via e-legitimation.

Med Idura Signatures kan organisationer skapa egna signeringsflöden där anställda kan signera olika typer av PDF-dokument, som avtal, formulär, kontrakt, fakturor och kvitton.

I detta inlägg kommer vi visa hur du bygger ett anpassat signeringsflöde för ditt use case med Idura Signatures API och MitID Erhverv. Vi guidar utvecklare i hur de kan aktivera företagsinloggningar och anpassa signaturstämpeln i applikationer. Slutligen visar vi ett visuellt exempel på en företagsanvändares signeringsupplevelse och den resulterande signaturstämpeln med anpassat innehåll.

Fortsätt läsa om du vill göra signeringen av digitala dokument till en smidig och effektiv upplevelse för hela din organisation.

Bygga ett signeringsflöde: förutsättningar och struktur

För att bygga ett signeringsflöde för MitID Erhverv-företagsanvändare behöver vi:

• En Idura Signatures-applikation
• En utvecklingsmiljö, en testapplikation eller en kodsandbox där du kan integrera vårt Signatures API
• Om du följer guiden kan du också använda den interaktiva genomgången i vår dokumentation

För att sätta upp ett signeringsflöde följer du fyra steg:

1. Skapa en signeringsorder
2. Lägg till undertecknare
3. Undertecknaren signerar dokumenten
4. Stäng signeringsordern

För att skräddarsy flödet för MitID Erhverv-användare gör vi följande justeringar i det första och andra steget:

1. När vi skapar en signeringsorder aktiverar vi företagsinloggningar för vår applikation.
   Vi ändrar också identifieraren på signaturstämpeln så att den visar företagets CVR.
   
   
2. När vi lägger till en undertecknare anpassar vi innehållet i signaturförseglingen med organisationens namn.

Nyfiken på hr det fungerar? Låt oss titta på koden.

Vi visar kodexempel för Node.js. Men oroa dig inte om du använder ett annat programmeringsspråk: du kan hänvisa till vår dokumentation för GraphGL- och .NET-kodsnuttarna.

Aktivera företagsinloggningar med MitID

För att aktivera företagsinloggningar ändrar vi inställningen för Idura Verify bevisleverantör genom att lägga till en loginHint-variabel när vi skapar en signaturorder:

import CriiptoSignatures from '@criipto/signatures';

const client = new CriiptoSignatures('{YOUR_IDURA_CLIENT_ID}', '{YOUR_IDURA_CLIENT_SECRET}');

// Create signature order
const signatureOrder = await client.createSignatureOrder({
  title: 'Sample Signature Order',
  documents: [
    {
      pdf: {
        title: 'Sample Agreement',
        blob: Buffer.from('...'),
        storageMode: 'Temporary',
      },
    },
  ],
  evidenceProviders: [
    {
      criiptoVerify: {
        acrValues: ['urn:grn:authn:dk:mitid:business'],
        loginHint: 'business_optional',
      },
    },
  ],
});

loginHint: "business_optional" gör det möjligt för användare att välja mellan att logga in som privatperson eller företagsanvändare (om registrerade i CVR) när de ska signera.

Om du endast kräver företagsinloggning kan du utelämna loginHint: "business_optional " och istället använda rätt acr_values.

Konfigurera signaturens utseende för att visa företagets CVR

Så här kan signaturstämpeln se ut när dokumentet har signerats med MitID:

Som standard visas en GUID som identifierare längst ned i signeringsstämpeln. Detta kan ändras genom att ändra inmatningsobjektet signatureAppearance när du skapar en signeringsorder.

Exemplet nedan visar hur du kan ändra identifieraren så att den visar företagets CVR-nummer istället.

// Create signature order
const signatureOrder = await client.createSignatureOrder({
  title: 'Sample Signature Order',
  documents: [
    {
      pdf: {
        title: 'Sample Agreement',
        blob: Buffer.from('...'),
        storageMode: 'Temporary',
      },
    },
  ],
  signatureAppearance: {
    identifierFromEvidence: ['cvrNumberIdentifier'],
  },
});

Och här är det resulterande sigillet som innehåller företagets CVR-nummer:

Anpassa signaturförseglingens visningsnamn

Som standard återger signaturförseglingen ett namn med hjälp av standard JWT-namnanspråket. Detta kan anpassas för varje person som undertecknar dokumenten när du lägger till en undertecknare. Det finns två alternativ:

1. Skriva över namnet helt, ELLER
2. Skapa ett nytt namnformat baserat på tillgängliga claims

Exemplet nedan visar hur du kan återge ett företagsnamn tillsammans med användarnamnet (och återgå till ett icke-företagsscenario):

// Add signatory
var signatory = await client.addSignatory(signatureOrder.id, {
  signatureAppearance: {
    identifierFromEvidence: [],
    displayName: [
      {
        template: '{(name}} of {}',
        replacements: [
          {
            placeholder: 'name',
            fromEvidence: ['name', 'http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name'],
          },
          {
            placeholder: 'company',
            fromEvidence: ['2.5.4.10'],
          },
        ],
      },
      {
        template: '{(name}}',
        replacements: [
          {
            placeholder: 'name',
            fromEvidence: ['name', 'http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name'],
          },
        ],
      },
    ],
  },
});

Med den här ändringen kommer stämpeln att innehålla både den anställdes namn och företagets namn när en anställd undertecknar dokumentet, i det format som vi just har definierat.

Det är allt som krävs!

Signeringsflödet kan nu användas tillsammans med MitID Erhverv för att signera dokument digitalt, säkert och utan manuella steg. 

Se videon nedan för att ta del av hur signeringsprocessen ser ut för en anställd när organisationen använder denna lösning för företagsinloggning. 

Med Idura Signatures kan du enkelt bygga lösningar för att signera PDF-dokument med olika nationella e-legitimationer, inklusive danska MitID Erhverv.

Du kan enkelt integrera Idura Signatures i din applikation på ett sätt som garanterar att du följer befintliga regler som GDPR och det domstolsbeslutet Schrems II.

Läs mer om MitID Erhverv och digitala signaturer på vår produktsida.

Criipto är nu Idura!

Du kanske stöter på criipto i våra domännamn och kodprover. Detta är väntat eftersom vi har bytt namn!

Läs hela historien i vårt tillkännagivande.