Guide: Enable Organisations to Make Requests to an Application
Last updated
Was this helpful?
Last updated
Was this helpful?
This document describes how you can go enable an orginization to interact with the application system.
For an organisation to be able to able to read/update an application the setup is as follows
Create a connection between their x-road server (handled by the institution) and our x-road server (handled by )
Create a new client In the IDS with:
Machine Client type
client claims prefix: client_
relevant scopes application:read
and/or application:write
claim with key: nationalId and The orginasation's national Id as value
This client can be created in the on dev using Gervimaður Útlönd 010-7789. For Staging and Prod a make request on #ids_changes
In the Application template map the orginasation's nationalId like so
For the org to be able to interact we need to add the role permission to a relevant state for the them to interact with the application.
Add an entry action:
An example of an approve/reject state from an organisation. Add your state with entry and exit that handles the assign of the institution
To invoke a state change the machine client would for approving make a PUT request like so:
Choose Oauth 2.0 and use the settings below. Insert your Client id, client secret and the Scope should be @island.is/applications:read @island.is/applications:write
press "Get New Access Token" and you have your token.
Log in to the on dev using Gervimaður Útlönd 010-7789. Find the client you created earlier, create a new secret and copy it to your clipboard: