Opbygning af skræddersyede arbejdsgange med MitID Erhverv

Det nye MitID Erhverv („MitID til virksomheder“) giver medarbejdere en sikker og praktisk måde at varetage forskellige digitale opgaver på vegne af deres organisationer. Det omfatter blandt andet at læse digital post, anmelde barselsorlov og sygdom samt at benytte offentlige tjenester.

Men det stopper ikke her!

Forestil dig den ekstra bekvemmelighed ved at bruge MitID Erhverv til digital underskrivning af dokumenter på tværs af organisationen med eID-verifikation.

Med Idura Signatures kan organisationer oprette tilpassede signaturworkflows, der giver medarbejderne mulighed for at underskrive en bred vifte af PDF-dokumenter, såsom kontrakter, formularer, aftaler, fakturaer og kvitteringer.

I dagens blogindlæg vil vi se nærmere på, hvordan man opbygger en tilpasset signaturworkflow til din virksomheds brugsscenarie med Idura Signatures API og MitID Erhverv. Vi vil vejlede udviklere i at aktivere virksomhedslogin og tilpasse signaturstemplet i applikationer, der er drevet af vores produkt. Til sidst viser vi et visuelt eksempel på en erhvervsbrugers underskriftsoplevelse og det resulterende underskriftsstempel med tilpasset indhold.

Hvis du ønsker at gøre underskrivningen af digitale dokumenter til en smidig og effektiv oplevelse for hele din organisation, så læs videre.

Opsætning af en signaturworkflow: forudsætninger og struktur

For at opsætte en signaturworkflow til MitID Erhverv-erhvervsbrugere har vi brug for:

• En Idura Signatures-applikation
• Et passende udviklingsmiljø, en eksempelapplikation eller en kode-sandkasse, hvor du kan integrere vores Signatures API. Hvis du følger med, kan du også bare prøve denne interaktive rundvisning i vores dokumentation.

For at oprette en signaturworkflow skal vi følge disse fire trin:

1. Opret en signaturordre
2. Tilføj underskrivere
3. Underskriverne underskriver dokumenterne
4. Afslut signaturordren

For at tilpasse arbejdsgangen til MitID Erhverv-brugere foretager vi følgende justeringer i det første og det andet trin:

1. Når der oprettes en underskriftsordre, vil vi aktivere virksomhedslogin til vores applikation.
   Vi vil også ændre identifikatoren på underskriftsstemplet, så den viser virksomhedens CVR-nummer.
   
   
2. Når der tilføjes en underskriver, tilpasser vi indholdet af underskriftsstemplet med organisationens navn.

Er du nysgerrig efter at se, hvordan det gøres? Lad os tage et kig på koden.

Vi giver kodeeksempler til Node.js. Men bare rolig, hvis du bruger et andet programmeringssprog: Du kan finde kodeuddrag til GraphGL og .NET i vores dokumentation .

Aktivering af virksomhedslogin med MitID

For at aktivere virksomhedslogin ændrer vi indstillingen for Idura Verify-bevisudbyderen ved at tilføje en loginHint -variabel, når der oprettes en signaturordre:

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" giver brugerne mulighed for at vælge mellem at logge ind som privatperson eller som virksomhedsbruger (hvis de er registreret i CVR), når de er klar til at underskrive.

Hvis du kun kræver virksomhedslogin, kan du udelade loginHint: "business_optional" og blot bruge de relevante acr_values.

Konfiguration af signaturens udseende, så virksomhedens CVR-nummer vises

Sådan kan signaturstemplet se ud, når dokumentet er blevet underskrevet med MitID:

Som standard viser identifikatoren nederst på seglet en GUID. Dette kan ændres ved at ændre inputobjektet signatureAppearance, når du opretter en signaturordre.

Eksemplet nedenfor viser, hvordan du kan ændre identifikatoren, så den i stedet viser virksomhedens CVR-nummer.

// 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'],
  },
});

Og her er det resulterende segl, der indeholder virksomhedens CVR-nummer:

Tilpasning af visningsnavnet på signaturstemplet

Som standard viser signaturstemplet et navn ved hjælp af standard JWT-navneangivelsen. Dette kan tilpasses for hver person, der underskriver dokumenterne, når du tilføjer en underskriver. Der er to muligheder:

1. At overskrive navnet fuldstændigt, ELLER
2. Oprette en ny navnesyntaks ud fra de tilgængelige krav

Følgende eksempel viser, hvordan du kan vise et firmanavn sammen med brugernavnet (og falde tilbage til et ikke-forretningsmæssigt scenarie):

// 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 denne ændring vil seglet, når en medarbejder underskriver dokumentet, indeholde både medarbejderens navn og virksomhedens navn i det format, vi netop har defineret.

Og så er det klar!

Underskriftsworkflowet kan nu bruges sammen med MitID Erhverv til at underskrive dokumenter på en papirløs, sikker og praktisk måde.

Se videoen nedenfor for at se , hvordan en medarbejder oplever at underskrive ,når vedkommendes organisation bruger denne nye loginløsning til virksomheder:

Med Idura Signatures kan du nemt udvikle løsninger til underskrivelse af PDF-dokumenter ved hjælp af en række nationale eID'er, herunder den danske MitID Erhverv og mange flere.

Du kan nemt integrere Idura Signatures i din applikation på en måde, der garanteret overholder gældende lovgivning som GDPR og den nyere Schrems II-dom.

Læs mere om MitID Erhverv og digitale signaturer på vores produktside.

Criipto hedder nu Idura!

Du vil muligvis støde på navnet "criipto" i vores domænenavne og kodeeksempler. Det er helt normalt, da vi har skiftet navn!

Læs hele historien i vores meddelelse.