New generic authority connector

Valid from Datafari X.X

The goal of this connector is to have a new generic connector that can ingest data in JSON format. The existing generic connector into MCF crawls data from XML and works only with Java 8. This one is inspired from the original one but works into Java 11 and can crawl data into JSON format.

The API should be implemented as json result page (entry point) returning results based on provided GET params. It may be a simple server script or part of the bigger application. API can be secured with HTTP basic authentication and can use HTTPS.

The format of the url is :

[entrypoint]?username=UserName

The response must have this format :

{
"tokens":[
"token1",
"token2",
"token3"
]
}

Example :

Query :

https://api.fr?username=jeanlouis

Response :

{
"tokens":[
"authenticated",
"administrator",
"administrateur_espace",
"toulon",
"membre_rh",
"administrateur_1",
"administrateur_537"
]
}

User documentation

Configure the new generic authority connector

Go into Authorities → List Authority connections then click on Add a new connection button

Name (mandatory) : enter the name that you want for your new connector

Description (optional) : enter a description for the new connector if you want

In the type tab :

Connection type : choose New Generic

Authority group (optional) and authority domain are optional fields.

Click on Continue.

In the NewGeneric Parameters tab :

URL: This is the URL of the entrypoint
Login : Set the username that has access to the JSON API REST endpoint if it is protected
Password: Set the password of the account that has access to the JSON API REST endpoint if it is protected
Cache life time : here you set the time a user's information is kept around
Connection Timeout: This is the timeout in milliseconds after which a connection attempt to the endpoint is considered failed
Socket Timeout: This is the timeout in milliseconds after which an endpoint request response reading attempt is considered failed