dd-register-nbn

Registers NBN with the NBN Resolver

Purpose

This service takes requests for registration of NBN identifiers from an inbox and executes them.

Interfaces

Provided interfaces

Inbox

  • Protocol type: Shared filesystem
  • Internal or external: internal
  • Purpose: to receive Registration Tokens

Admin console

  • Protocol type: HTTP
  • Internal or external: internal
  • Purpose: application monitoring and management

Consumed interfaces

NBN registration API

  • Protocol type: HTTP
  • Internal or external: external
  • Purpose: register NBNs with the NBN Resolver

Processing

The service monitors an inbox for new registration tokens and registers the NBN for each one encountered.

Registration Tokens

A Registration Token is a simple properties file with two fields nbn and location, e.g.,

nbn=urn:nbn:nl:ui:13-26febff0-4fd4-4ee7-8a96-b0703b96f812
location=https://example.dans.knaw.nl/ui/13-26febff0-4fd4