tree 6a6baa7892f6911e81da3e20a7399ea8d3f4108a
parent 0c29cea17f880a92972b6a1c5369bcb7fe414706
author Marc Kupietz <kupietz@ids-mannheim.de> 1573118033 +0100
committer Marc Kupietz <kupietz@ids-mannheim.de> 1573128101 +0100

Add support for API token authorization

To use authorization based on an API token in subsequent queries,
initialize your KorAP connection with
kco <- new("KorAPConnection", apiToken="<API Token>").
In order to make the API token persistent for the currently
used KorAPUrl (you can have one token per KorAPUrl / KorAP server
instance), use persistApiToken(kco). This will store it in your keyring
using the keyring package.
Subsequent new("KorAPConnection") calls will then automatically
retrieve the token from your keying.
To stop using a persisted token, call clearApiToken(kco).

Please note that for DeReKo, authorized queries will behave differently
inside and outside the IDS, because of the special license situation.
This concerns also cached results which do not take into account from
where a request was issued. If you experience problems or unexpected
results, please try kco <- new("KorAPConnection", cache=FALSE) or use
clearCache to clear the cache completely.

Change-Id: Ic956b0dcf03574e63b62d5036622f30a6cf27f8a