This is an automated email from the ASF dual-hosted git repository.
acosentino pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/master by this push:
new d20a508 FUSEDOC-2912 Add info about accessToken parameter. (#2721)
d20a508 is described below
commit d20a5085b736d4c8dc8f5c7546613686e50e3e7b
Author: TovaCohen <tco...@redhat.com>
AuthorDate: Fri Jan 18 16:46:18 2019 -0500
FUSEDOC-2912 Add info about accessToken parameter. (#2721)
---
.../src/main/docs/linkedin-component.adoc | 24 ++++++++++++++++++++--
1 file changed, 22 insertions(+), 2 deletions(-)
diff --git
a/components/camel-linkedin/camel-linkedin-component/src/main/docs/linkedin-component.adoc
b/components/camel-linkedin/camel-linkedin-component/src/main/docs/linkedin-component.adoc
index 9b35898..2fcbc36 100644
---
a/components/camel-linkedin/camel-linkedin-component/src/main/docs/linkedin-component.adoc
+++
b/components/camel-linkedin/camel-linkedin-component/src/main/docs/linkedin-component.adoc
@@ -95,10 +95,30 @@ with the following path and query parameters:
[width="100%",cols="2,5,^1,2",options="header"]
|===
| Name | Description | Default | Type
-| *accessToken* (common) | LinkedIn access token to avoid username and
password login. | | String
+| *accessToken* (common) | LinkedIn access token to avoid username and
password login procedure.
+
+
+LinkedIn responds to login forms by using a CAPTCHA. This makes it impossible
+for a standalone, headless process to log in to LinkedIn by specifying a
username and password.
+To work around this, obtain a LinkedIn access token and provide the token as
+the setting of the *accessToken* parameter.
+
+Obtaining a LinkedIn access token is a multi-step procedure. You must
configure your
+LinkedIn application, obtain a LinkedIn authorization code, and exchange that
+code for the LinkedIn access token. For details, see
+link:https://developer.linkedin.com/docs/oauth2[Authenticating with OAuth for
LinkedIn developers].
+
+The default behavior is that the access token expires after 60 days. To change
this, specify a value
+for the *expiryTime* paramter. If the access token expires, the LinkedIn
component tries to log in to
+LinkedIn by providing a username and password, which results in a CAPTCHA so
the login fails.
+The LinkedIn component cannot refresh the access token. You must manually
obtain a new access token
+each time an access token expires. When you update the access token you must
restart the application
+so that it uses the new token.
+
+| | String
| *clientId* (common) | LinkedIn application client ID | | String
| *clientSecret* (common) | LinkedIn application client secret | | String
-| *expiryTime* (common) | LinkedIn access token expiry time in milliseconds
since Unix Epoch, default is 60 days in the future. | | Long
+| *expiryTime* (common) | LinkedIn access token expiry time in milliseconds
since the UNIX Epoch. The default is 60 days. | | Long
| *httpParams* (common) | Custom HTTP params, for example proxy host and port,
use constants from AllClientPNames | | Map
| *inBody* (common) | Sets the name of a parameter to be passed in the
exchange In Body | | String
| *lazyAuth* (common) | Flag to enable/disable lazy OAuth, default is true.
when enabled, OAuth token retrieval or generation is not done until the first
REST call | true | boolean
