This is an automated email from the ASF dual-hosted git repository.

davsclaus 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 b4f590c  FUSEDOC-2912 Add info about accessToken parameter. (#2721)
b4f590c is described below

commit b4f590cfc64de052ef420447e56bdf688c44478e
Author: Claus Ibsen <claus.ib...@gmail.com>
AuthorDate: Sat Jan 19 09:11:36 2019 +0100

    FUSEDOC-2912 Add info about accessToken parameter. (#2721)
---
 .../src/main/docs/linkedin-component.adoc          | 24 ++--------------------
 .../component/linkedin/LinkedInConfiguration.java  | 17 ++++++++++++++-
 .../springboot/LinkedInComponentConfiguration.java | 19 ++++++++++++++++-
 3 files changed, 36 insertions(+), 24 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 2fcbc36..e1dc028 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,30 +95,10 @@ 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 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
+| *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 applicat [...]
 | *clientId* (common) | LinkedIn application client ID |  | String
 | *clientSecret* (common) | LinkedIn application client secret |  | String
-| *expiryTime* (common) | LinkedIn access token expiry time in milliseconds 
since the UNIX Epoch. The default is 60 days. |  | Long
+| *expiryTime* (common) | LinkedIn access token expiry time in milliseconds 
since Unix Epoch, default is 60 days in the future. |  | 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
diff --git 
a/components/camel-linkedin/camel-linkedin-component/src/main/java/org/apache/camel/component/linkedin/LinkedInConfiguration.java
 
b/components/camel-linkedin/camel-linkedin-component/src/main/java/org/apache/camel/component/linkedin/LinkedInConfiguration.java
index def61a6..126b591 100644
--- 
a/components/camel-linkedin/camel-linkedin-component/src/main/java/org/apache/camel/component/linkedin/LinkedInConfiguration.java
+++ 
b/components/camel-linkedin/camel-linkedin-component/src/main/java/org/apache/camel/component/linkedin/LinkedInConfiguration.java
@@ -126,7 +126,22 @@ public class LinkedInConfiguration {
     }
 
     /**
-     * LinkedIn access token to avoid username and password login.
+     * 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: 
https://developer.linkedin.com/docs/oauth2
+     *
+     * 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.
      */
     public void setAccessToken(String accessToken) {
         this.accessToken = accessToken;
diff --git 
a/platforms/spring-boot/components-starter/camel-linkedin-starter/src/main/java/org/apache/camel/component/linkedin/springboot/LinkedInComponentConfiguration.java
 
b/platforms/spring-boot/components-starter/camel-linkedin-starter/src/main/java/org/apache/camel/component/linkedin/springboot/LinkedInComponentConfiguration.java
index bdad018..60b5978 100644
--- 
a/platforms/spring-boot/components-starter/camel-linkedin-starter/src/main/java/org/apache/camel/component/linkedin/springboot/LinkedInComponentConfiguration.java
+++ 
b/platforms/spring-boot/components-starter/camel-linkedin-starter/src/main/java/org/apache/camel/component/linkedin/springboot/LinkedInComponentConfiguration.java
@@ -97,7 +97,24 @@ public class LinkedInComponentConfiguration
          */
         private OAuthSecureStorage secureStorage;
         /**
-         * LinkedIn access token to avoid username and password login.
+         * 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:
+         * https://developer.linkedin.com/docs/oauth2 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.
          */
         private String accessToken;
         /**

Reply via email to