Description

OpenRefine's extension to add authentication protocols for HTTP/HTTPS request. Compatible with OpenRefine 3.3 supporting:

• Custom applications with JWT tokens
• Basic authentication (login password)

The extension allows passing credentials when

• Creating a project from Web Addresses (URLs):
• Adding a column by fetching URLs based on this column
• Calling a reconciliation service via OpenRefine native interface
• Calling a RDF endpoint using the RDF extension

Requirements

• Java 1.8.*
• Maven 3.* (mvn)

Compile

• Execute mvn package assembly:single
• Extension will be located into target/openrefine-authenticator-0.3.zip

Installation

• Extract the openrefine-authenticator-0.3.zip into the OpenRefine folder webapp/extensions
• Run OpenRefine and set up your credentials for all HTTP/HTTPS request

Run demo

• Add a vhost to your pc
  • Linux examples: sudo nano /etc/hosts and add to then end: 127.0.0.1 languages.local.com
• Move to demo folder
• Execute docker-compose build
• Run the two containers with docker-compose up -d. This will start two containers
  • OpenRefine in http://localhost:3333
  • LoginApp in http://localhost:8888 with two endpoints that you can test

    • curl --location --request POST 'http://languages.local.com:8080/api/login' \
      --header 'Content-Type: application/json' \
      --data-raw '{
      "username": "admin",
      "password": "password",
      "grant_type": "password"
      }'```
      
      

    • curl --location --request GET 'http://localhost:8080/api/languages' \
      --header 'Authorization: Bearer TOKEN_FROM_PREVIOUS_REQUEST''```
      
      

• Open in a browser http://127.0.0.1:3333/ then follow the video https://youtu.be/6fm29SzaQ7g
• Credentials for http://languages.local.com:8080/api/login:
  • Username: admin
  • Password: password
  • Type: Bearer
• Credentials for http://127.0.0.1:10035/token (AllegroGraph):
  • Username: admin
  • Password: pass
  • Type: Basic