Resumen

¿Qué tipo de concesión se usa para conectarse con Komet Sales?

Usamos Implicit, el cual es el tipo de concesión más popular para aplicación basadas web como Komet Sales. Es  importante señalar que este tipo de concesión no soporta tokens dinámicos (refresh tokens). 

Instrucciones

Ui steps
size small
Ui step Contáctenos para que procedamos con la integración, dejándonos saber la URL del sitio web al cual serán redirigidos los usuarios. Ui step El equipo de Komet Sales procederá con la configuración y le enviará el servidor de autorización, el identificador del cliente (clientid) (which is used for the request) and the clientsecret, which is used in the request sent along with the token generated (step 6) in order to access directly to the E-commerce applicationel cual se usa para la petición) y el secreto del cliente (clientsecret), el cual se usa en el envío de la petición junto con el token generado (paso 6) para acceder directamente a la aplicación de E-commerce. Ui step You must enable the URL in your website, so your users can access to Komet Sales E-commerce portal. The next is an example of the Debe habilitar la URL en su sitio web de forma tal que usuarios puedan acceder al portal E-commerce de Komet Sales. El siguiente es un ejemplo de la URL:   xmlExample response_type: always type  siempre tipo "token" client_id: provided for  proporcionado por Komet Sales. It must be send in every requestDebe enviarse en cada petición. redirect_uri: the URL where the user will be redirect. It must be sent in every request to avoid identity theft la URL donde el usuario será redirigido. Debe enviarse en cada petición para evitar suplantación. Once enabled, the user will click on your website in order to access to Komet Sales Shopping Portal. The user will be redirect to a page as the following if the user login for the first time, in order to authenticate their identity: Ui step Ui step Once the user enter the access credentials, the user should authorizes or deny the application access to their accountUna vez se habilite, el usuario hará clic en su sitio web para acceder al portal de compras de Komet Sales. El usuario será redirigido a una página como la siguiente (en caso de que ingrese por primera vez), para validar su identidad. Ui step Una vez el usuario ingresa las credenciales, el usuario debe autorizar o denegar el acceso de la aplicación a su cuenta.   Ui step Once the user clicks on Approve, the service redirects the user to the defined URI and this URI will include the access token. You must execute a setup so your user-agent automatically uses this token for access to the E-commerce application. The token will be valid for 30 days. Once this period has elapsed, the token access must be renewed so the users can access directly to the application. The URI for access automatically to the E-commerce should It look like the following:   token: the authentication token for acess directly to the E-commerce (It can be taken from the Una vez el usuario haga clic en aprobar (Approve), el servicio redirige al usuario a la URI definida, y esta URI incluirá al token de acceso. Es necesario llevar a cabo una configuración de forma tal que el agente de usuario use este token para acceder ala aplicación de E-commerce. El token será válido por 30 días. Una vez el periodo termine, el token debe renovarse para que los usuarios puedan acceder directamente a la aplicación. La URI para acceder automáticamente al E-commerce se verá así: token: el token de autenticación para acceder directamente al E-commerce (puede tomarse de la URI) client_id: provided for  proporcionado por Komet Sales. client_secret: provided for proporcionado por Komet Sales. The system will provide you additional customer information along with the access token, such as customer id, code and name. This is made through an automatic request to the OAuth 2 server executed once the access token is saved. The following is an example of the request and the response with the customer information: Request state (optional): alphanumeric. For security purposes. This value will be returned the same in the response. Info title Information alfanúmerico. Con fines de seguridad. Este valor se retorna tal cual en la respuesta. ¿Cómo obtener metadatos del token? Una vez haya obtenido el token de acceso, puede obtener información adicional del token. El servidor de OAuth 2 brinda información adicional del token de autenticación, como por ejemplo de los clientes asociados al usuario. Esto puede obtenerse a través de una petición en JSON request como la siguientes: Petición Este método requiere una autenticación básica donde el usuario es el client_id y la contraseña es el client_secret. https://auth.kometsales.com/oauth/check_token Encabezado Tipo de contenido: application/x-www-form-urlencoded; charset=utf-8' Método: POST Input parameters: client_id: proporcionado por Komet Sales. token (required)(string:50): token de seguridad. clientsecret: proporcionado por Komet Sales Code Block language js theme Confluence title Sample ## Oauth 2 - Local Production - Check Token curl -X "POST" " http https:// localhost:9090 auth.kometsales.com/oauth/check_token" \ -H 'Cache-Control: no-cache' \ -H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' \ -u ' 760b238e6eefd5a9cdf5152071ee096e 0a448854c90376777bedb88f7b42da82: 9e7a7bdeacc9625697e5226154cd2afed4c457fd8c10c8dc4c72b1f97fd2b18e bc4d4538e47cc82c82c370aa91ca560670fe26d6120b64a13d98794f449e20b9' \ --data-urlencode "token= 6d6ea94c b217abe7- bf8e 792d- 4f8b 45f1- be18 a91a- 6e66fe38f975"Response 17db5f436410" Respuesta scope (string:50): Especifica una serie de scopes permitidos. lastname (string:50): apellido del usuario. customer: serie de datos del cliente dado. id (integer 10): El ID del cliente. name (string:200): nombre del cliente. code (string:10): código del cliente. titleSample Code Block language js theme Confluence { "aud": [ "ks-ecommerce" ], "user_name": "diego+ecommerce@kometsales.com", "scope": [ "READ", "WRITE" ], "last_name": "Garcia", "customers": [ { "id": 141839, "code": " RD Render", "name": "Customer 6" }, { "id": 148121, "code": "148121", "name": "Customer 8" } ], "first_name": "Diego", "authorities": [ "ROLE_USER" ], "account": "4d544d344d44513d", "client_id": "0a448854c90376777bedb88f7b42da82" }