Model for system register information

Model for the external to read/write system register information

Model

Id

The id should be in the format of {systemvendororgno}_{name chosen by the vendor}. F.example “310547891_testproduct”. This is a unique id to identify the product.

Vendor

The organization number of the system vendor. It must start with a reference code for the enhetsregister.

for example

"vendor": {
  "ID": "0192:991825827"
}

«0192» is the reference that it is a value from EnhetsRegister according to Electronic Address Scheme and 991825827 is the organization number of Norwegian Digitalisation Agency.

Name

Name of the system. This supports languages english(en), norwegian bokmål(nb) and nynorsk(nn). This is used on the display of th system in the user interface for manulaly creating the system user and also on approval of a system user request.

  "name": {
    "nb": "The Matrix",
    "en": "The Matrix",
    "nn": "The Matrix"
  },

Description

A short text that describes the system. This is used to present to the end user in the Altinn portal. english(en), norwegian nokmål(nb) and nynorsk(nn) are supported.

  "description": {
    "nb": "Test system",
    "en": "Test system",
    "nn": "Test system"
  },

Rights

This defines the services that the vendor’s system requires access from the system user. This can be either altinn 3 app, service outside altinnn but is registered as a resource in Altinn. The example below defines an app “app_ttd_endring-av-navn-v2” in altinn and service “ske-krav-og-betalinger” outside altinn that is registered as a resource in Altinn. This is an optional argument to create a system but it must be set before the system user can be created.

  "rights": [
    {
      "resource": [
        {
          "id": "urn:altinn:resource",
          "value": "app_ttd_endring-av-navn-v2"
        }
      ]
    },
    {
      "resource": [
        {
          "id": "urn:altinn:resource",
          "value": "ske-krav-og-betalinger"
        }
      ]
    }
  ],

AccessPackages

This defines the access packages that the vendor’s system requires access from the system user. As of now, this is defined only for the client delegation case. The example below defines the accesspackage “skattnaering”. The access package should be one of the roles “REGN/REVI/FFOR”. This is an optional argument to create a system but it must be set before the system user can be created.

  "accessPackages": [
    {
      "urn": "urn:altinn:accesspackage:skattnaering"
    }
  ]

ClientId

A system can be associated with multiple client IDs. These client IDs are generated for integrations in Maskinporten, and each one is unique, tied specifically to a system. As a result, a client ID cannot be reused for a different system. If the system linked to a client ID is deleted, the client ID may be reassigned to a new or existing system.

  "clientId": [
    "32ef65ac-6e62-498d-880f-76c85c2052ae"
  ],

IsVisible

The vendor can decide whether the system should be visible in the Altinn portal for end users to manually create it.

• True: The system is visible in the user-driven system creation process in the Altinn portal.
• False: The system is not visible in the Altinn portal and can only be created by the vendor through the vendor-driven system creation process.

AllowedRedirectUrls

This is to whitelist the urls that is allowed to be set in the redirecturl for a vendor driven system user request. Only https urls are allowed.

  "allowedredirecturls": [
   "https://vg.no",
   "https://nrk.no",
   "https://altinn.no"
 ],