Skip to content

Latest commit

 

History

History
77 lines (46 loc) · 3.42 KB

Enduser-GettingStarted.md

File metadata and controls

77 lines (46 loc) · 3.42 KB

1 Prerequisites

Basic understanding of Oauth and REST. We suggest to view this video as a demo how to access data before proceeding. Postman is a handy tool, but Curl works too. Please check the Chapter 5 - Postman Collection of this page, we have created a ready Postman collection you can use to get an easty start.

2 Getting a keyrock account

Contrasec has created a demo environment where to test the RBAC solution. Here is a step by step how to get a Keyrock Account:

  1. Navigate to accounts: https://accounts.odala-rbac.cinfra.fi/sign_up/ sign up for a new account. The email sending has been disabled for security.
  2. Send an email to [email protected] and he will activate your account. This may take a working day or two.

3 How to query data

  1. Once you have received email confirmation that your email has been activated from [email protected], you can login via https://accounts.odala-rbac.cinfra.fi/ . Here is how successful login should look like:

  2. Access token is needed to query data. You need to get the following details in order to get the access token: clientid,client secret,username (=email) of your Keyrock account and password of your Keyrock account. clientid is 4f10e33d-697c-4c5a-95d9-4c6b60a0179f for Contrasec test application, and you can get those from Keyrock also from the Application details. Clict the "Orion RBAC" application and expand the "Oauth2 Credentials" selector:

  3. Send the following request via Postman. Copy the clientid and client secret to the "username" and "password" fields of Postman:

    Insert the username and password details. Set grant_type as "password":

    access_token is in the response, copy that for later use.

  4. Create the following request with Postman:

    response that you should get is:

    You are done! If you run into trouble, please create an issue to this repo or send email to [email protected]

4 How to push data

At this time we do not allow pushing of data. This is strictly to minimize maintenance effort from our side.

5 Postman Collection

Is available for download. With the collection you can easily test the system.

6 Common problems and trouble shoot

Nothing yet! When something is wrong, please create an issue.

7 Curl examples

curl --location --request POST 'https://accounts.odala-rbac.cinfra.fi/oauth2/token' \
--header 'Authorization: Basic NG....NzU4OWZiNWQ2Ng==' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=password' \
--data-urlencode '[email protected]' \
--data-urlencode 'password=pass'

curl --location --request GET 'https://orion.odala-rbac.cinfra.fi/v2/entities/' \
--header 'Authorization: Bearer 91ff..b732ac47'

8 References