Default connector
This connector is provided as default. It is used for internal product mechanism. For these purposes, it can be used with following URL parameters:
Parameter | Description |
---|---|
url | Allow to supply a URL based on HTTP or FTP protocol |
uuid | Used to visualize the id of a ARender document |
bean | Specify use of a specific connector (Advanced level) |
Here are some examples:
-
Open a WEB document
http://{ARENDER_SERVER}/ARender/ARender.html?url=...
-
Open a document using a specific connector providing a user id and a security token
http://{ARENDER_SERVER}/ARender.html?bean=myConnector&user=123456&token=9GISU9SG4Z
Configure authorized URLs
The URI set in the url parameter is checked in order to authorized the connexion against a set of whitelisted URL.
In Rendition side, specifically in the Broker microservice, two properties are available to whitelist URL based on HTTP protocol and FTP protocol.
# Authorized documents paths with comma-separated
authorized.paths=../../samples/,../samples/,../../tmp/,../tmp
# Authorized URLs with comma-separated
authorized.urls=
By default, no URL is authorized.
For example, to allow the ARender demo site to authorize the following URL document https://demo.arender.io/docs/demo/ARender-doc-demo.pdf, we need to set the property like below :
authorized.urls=https://demo.arender.io,demo.arender.io
Note, that we added 2 URLs, one with the HTTP protocol and one without. Both are correct. But in the first one, we explicitly authorize HTTPS URL of the demo size.
With the property above, the following URL will open the document ARender-doc-demo.pdf in the ARender demo :
https://www.demo.arender.io/?url=https://demo.arender.io/docs/demo/ARender-doc-demo.pdf
Configure Basic Authentication
Since version 2023.1.0, a new property is available to configure URLs that need to be authenticated with a Basic Authentication. The property must be provided in the Broker microservice.
# Set a list of key-value pairs of base64-secrets for domains
# The key and the value are separated by the character '@'
# The key-value couples are separated by the character ','
# Example : domain1@secret1,domain2@secret2,domain3@secret3
arender.url.basic.auth=