Getting started for application developers
The Dataporten Dashboard allows developers to register and manage new and existing applications.
- Dataporten Dashboard – self service interface for registering applications and APIs.
The other Dataporten interfaces are important to application developers as well to better understand and explore the platform:
- Dataporten groups – end user administration of ad hoc groups.
- Dataporten Min Side – end user administration of issued authorizations.
Login to Dataporten Dashboard
- All users in Norwegian education should use Feide to login to Dataporten Dashboard.
- For users without a Feide account, choose to login using Feide Guest users.
Applications and APIs in Dataporten Dashboard is either associated with an organization or your personal account. You can select the context by choosing between the available tabs:
When registering services for production and you are not an administrator for your organization, let your local admin create a placeholder service, and delegate permissions to a developer group.
Personal or organizational context for applications
- Feide users may register applications and APIs associated with their personal account. This is convenient for experimenting and development. The personal user associated with the application will be visible during the login flow for end users.
- Guest users need to be associated with a service provider organization to be able to register applications.
All service provider organizations registered in Feide is automatically registered in Dataporten. If you are registered as an administrator in the Feide customer portal, you will be able to login to Dataporten Dashboard with the same credentials.
After logging in to the Dataporten Dashboard you have to:
- either request registration of a new service provider organization
- or request being an administrator of an existing organization under the "+Organization" tab
Registering a new application
Click «Register new application», and you will be prompted to enter some minimal input for you application.
OAuth 2.0 Redirect URL is the URL where the client is redirected back to after authentication. This should be available in the documentation of the software you are about to install. Read more in our technical specification about OAuth and using Dataporten for authentication. The Redirect URI can be changed later.
When submitting the inital form the application is ready to connect to Dataporten, still several additional details can be configured. Take special care to fill in understandable details about your application, including name, description, logo and more. This information will be displayed to end users during login.
In the «OAuth details»-pane you will find all technical details needed that your application would need to configure.
Using Dataporten, you probably want to authenticate people using your service. Through Dataporten you can enable several login providers. You - as a service provider - decide which login providers your service should accept.
Here you will find more information about the different login providers, how to enable them and when to enable them.
In Dataporten Dashboard you can enable the following login providers for your service:
- International education login, eduGAIN (soon to be added to Dataporten)
- Social media login
- Feide guest users
- Feide test users (for test purposes only)
Enabling login providers
When registering your service in the Dataporten Dashboard, you will enable login providers on the page "Login providers":
How to enable Feide login
If your users are students, researchers, teachers or other employees in Norwegian education, you probably want to enable Feide login. In Dashboard, you will enable "Utdanningssektoren". Be sure not to mix up with "Feide gjestebrukere" or "Feide testbrukere".
If your service should accept logins only from specific schools, you will configure this as well in Dashboard:
How to enable ID-porten login
If your users are people outside of education, i.e. parents or alumni, and you still want a high security level on your logins, you should enable ID-porten login:
How to enable international login through eduGAIN
If your users are international students, researchers, teachers or other employees, you should enable eduGAIN login.
Login through social media
Not all services need to know exactly who the user is and be 100% certain about the user's identity. These services only need to recognize the user every time he or she logs in to build some kind of user profile for the user.
For these services, login through social media can be a good way to authenticate users. Dataporten offers login through Facebook, LinkedIn and Twitter.
If you enable one or more of these, your users will log in to your service by his/her Twitter, Facebook or LinkedIn account. The user ID received by the service, will be the user ID from Twitter, Facebook or LinkedIn.
How to enable login for Feide guest users
For users that don't have a Feide account, you can enable login through the «Feide guest users solution, also known as OpenIdP.
How to enable Feide test users
During the development and test phase, you can enable login for Feide test users. Test usernames and credentials are available through a separate pane on Dashboard for applications that have enabled test accounts.
Using third-party APIs
Dataporten allows institutions and data owners to make available new datasets that will be very easy to use for application developers.
If you are interested in setting up your own API:
The available APIs can be listed in the tab for third party APIs in the Dataporten Dashboard.
APIs that you have made available your self will be visible in the My APIs tab, while all others will be available in the 3rd party API tab.
Some APIs may be made available instantly without moderations, while others may require moderations of either the API owner or each of the institutions behind.