Brukerstyrt signering
Slik setter du opp brukerstyrt signering i tjenesten din.
Could not find section content. File does not exist: content/altinn-studio/guides/development/restricted-data/shared/style.css.md
Hva betyr brukerstyrt signering?
Could not find section content. File does not exist: content/altinn-studio/guides/development/signing/runtime-delegated-signing/intro.nb.md
Avhengigheter
Maskinporten
Maskinporten kreves av både meldingstjenesten og for interaksjon med beskyttede data.
Hvis du trenger hjelp med oppsett av Maskinporten i din app, finner du all informasjonen du trenger i denne guiden.
Meldingstjenesten
Brukerstyrt signering avhenger av Meldingstjenesten (Correspondence) i Altinn, som krever et separat oppsett.
Meldingstjenesten brukes for å gi beskjed til de som skal signere om at de må signere et skjema i Altinn, og for å sende en kvittering til innboksen deres når de har signert.
Slik kommer du i gang med meldingstjenesten.
Eksempel på konfigurasjon
I dette repoet ligger det et eksempel på en app som har brukerstyrt signering.
Flyten i appen er slik:
- Den som fyller ut skjemaet oppgir fødselsnummer og etternavn, eller eventuelt organisasjonsnummer hvis den som skal signere representerer en virksomhet.
- Når skjemaet er ferdig utfylt, klikker den som fyller ut på “Til signering”. Det beveger prosessen til neste steg, som er signeringssteget.
- Når signeringssteget blir startet, kaller appen opp en implementering av grensesnittet
ISigneeProviderfor å finne ut hvem som må få tillatelse til å signere. - De som skal signere får delegert de rettighetene de trenger, og de blir varslet om at de har en signeringsoppgave.
- Skjemaet de skal signere kommer i innboksen slik at de kan åpne det, se over informasjonen og signere.
- Innsenderen signerer også, hvis appen er satt opp til det, og deretter blir skjemaet sendt inn.
Merk: Vi støtter ikke automatisk innsending enda.
Følg trinnene under for å sette opp en slik app.
1. Legg til en signeringsoppgave i appens prosess, med tilhørende konfigurasjon
2. Legg til layout-set for signering
3. Valgfritt - Egendefinert validering
Could not find section content. File does not exist: content/altinn-studio/guides/development/signing/runtime-delegated-signing/backend-manual/custom-validation.nb.md
4. Oppgi hvem som skal signere
5. Valgfritt - Legg til tekstressurser
Denne seksjonen er kun relevant for deg dersom du ønsker å endre på standardtekstene i kommunikasjon med signatarer - de som skal signere.
Standardverdiene som brukes dersom kommunikasjonstekstene ikke overstyres er som følger:
| Tekst | StandardVerdi |
|---|---|
| Innboksmelding til signatar - tittel | “{appName}: Oppgave til signering” |
| Innboksmelding til signatar - undertittel | “Din signatur ventes for {appName}.” |
| Innboksmelding til signatar - innhold | “Du har en oppgave som venter på din signatur. <a href="{instanceUrl}">Klikk her for å åpne applikasjonen. Hvis du lurer på noe, kan du kontakte {appOwner}.” |
| Sms til signatar - innhold | “Din signatur ventes for {appName}. Åpne Altinn-innboksen din for å fortsette.” |
| E-post til signatar - emne | “{appName}: Oppgave til signering” |
| E-post til signatar - innhold | “Din signatur ventes for {appName}. Åpne Altinn-innboksen din for å fortsette. Hvis du lurer på noe, kan du kontakte {appOwner}.” |
| Kvittering til signatar - tittel | “{appName}: Signeringen er bekreftet” |
| Kvittering til signatar - undertittel | “Du har signert for {appName}.” |
| Kvittering til signatar - innhold | “Dokumentene du har signert er vedlagt. Disse kan lastes ned om ønskelig. Hvis du lurer på noe, kan du kontakte {appOwner}.” |
| Tekst | StandardVerdi |
|---|---|
| Innboksmelding til signatar - tittel | “{appName}: Oppgåve til signering” |
| Innboksmelding til signatar - undertittel | “Signaturen din vert venta for {appName}.” |
| Innboksmelding til signatar - innhold | “Du har ei oppgåve som ventar på signaturen din. <a href="{instanceUrl}">Klikk her for å opne applikasjonen. Om du lurer på noko, kan du kontakte {appOwner}.” |
| Sms til signatar - innhold | “Signaturen din vert venta for {appName}. Opne Altinn-innboksen din for å gå vidare.” |
| E-post til signatar - emne | “{appName}: Oppgåve til signering” |
| E-post til signatar - innhold | “Signaturen din vert venta for {appName}. Opne Altinn-innboksen din for å gå vidare. Om du lurer på noko, kan du kontakte {appOwner}.” |
| Kvittering til signatar - tittel | “{appName}: Signeringa er stadfesta” |
| Kvittering til signatar - undertittel | “Du har signert for {appName}.” |
| Kvittering til signatar - innhold | “Dokumenta du har signert er vedlagde. Dei kan lastast ned om ønskeleg. Om du lurer på noko, kan du kontakte {appOwner}.” |
| Tekst | StandardVerdi |
|---|---|
| Innboksmelding til signatar - tittel | “{appName}: Task for signing” |
| Innboksmelding til signatar - undertittel | “Your signature is requested for {appName}.” |
| Innboksmelding til signatar - innhold | “You have a task waiting for your signature. <a href="{instanceUrl}">Click here to open the application. If you have any questions, you can contact {appOwner}.” |
| Sms til signatar - innhold | “Your signature is requested for {appName}. Open your Altinn inbox to proceed.” |
| E-post til signatar - emne | “{appName}: Task for signing” |
| E-post til signatar - innhold | “Your signature is requested for {appName}. Open your Altinn inbox to proceed. If you have any questions, you can contact {appOwner}.” |
| Kvittering til signatar - tittel | “{appName}: Signature confirmed” |
| Kvittering til signatar - undertittel | “Your signature has been registered for {appName}.” |
| Kvittering til signatar - innhold | “The signed documents are attached. They may be downloaded. If you have any questions, you can contact {appOwner}.” |
6. Valgfritt - skreddersy hvordan signatarene varsles
Legg merke til at CommunicationConfig er valgfritt. Her kan du overstyre standardtekster brukt i kommunikasjon med signatarene,
som beskrevet i forrige punkt. Du kan også overstyre e-post adresse og telefonnummer for signatarene.
Om ikke overstyrt, vil e-postadressene og telefonnumrene populeres som beskrevet i Recipient lookup og Address lookup.
Dette er de mulige overstyringskonfigurasjonene for kommunikasjon med signatarer:
| Property | Description | Type |
|---|---|---|
| CommunicationConfig | Objektet for kommunikasjonskonfigurasjon | Object |
| CommunicationConfig.InboxMessage | Objektet for innboksmeldingskonfigurasjon | Object |
| CommunicationConfig.InboxMessage.TitleTextResourceKey | Tekstressursnøkkelen for innboksmeldingstittel | String |
| CommunicationConfig.InboxMessage.SummaryTextResourceKey | Tekstressursnøkkelen for innboksmeldingssammendrag | String |
| CommunicationConfig.InboxMessage.BodyTextResourceKey | Tekstressursnøkkelen for innboksmeldingsinnhold | String |
| CommunicationConfig.Notification | Objektet for varslingskonfigurasjon | Object |
| CommunicationConfig.Notification.Email | Objektet for e-postvarselingskonfigurasjon | Object |
| CommunicationConfig.Notification.Email.EmailAddress | Tekstressursnøkkelen for e-postadresse | String |
| CommunicationConfig.Notification.Email.SubjectTextResourceKey | Tekstressursnøkkelen for e-postemne | String |
| CommunicationConfig.Notification.Email.BodyTextResourceKey | Tekstressursnøkkelen for e-postinnhold | String |
| CommunicationConfig.Notification.Sms | Objektet for SMS-varslingskonfigurasjon | Object |
| CommunicationConfig.Notification.Sms.MobileNumber | Tekstressursnøkkelen for mobilnummer | String |
| CommunicationConfig.Notification.Sms.BodyTextResourceKey | Tekstressursnøkkelen for SMS-innhold | String |
| CommunicationConfig.Notification.NotificationChoice | Varslingspreferansevalget | NotificationChoice enum (String) |
7. Test brukerstyrt signering
Could not find section content. File does not exist: content/altinn-studio/guides/development/signing/runtime-delegated-signing/test.nb.md