Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Resumen


Excerpt

El sistema permite a las compañías usar e protocolo de autorización OAuth 2.0 para acceder al e-commerce de Komet a través de sistemas de terceros. En pocas palabras, al usuario se le solicita acceder a la aplicación, luego el servidor de autorización transfiere el token al agente de usuario (navegador) y este transfiere el token a la aplicación.


¿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
sizesmall


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) (el 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

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: siempre tipo "token"

client_id: proporcionado por Komet Sales. Debe enviarse en cada petición.

redirect_uri: la URL donde el usuario será redirigido. Debe enviarse en cada petición para evitar suplantación.


Ui step

Una 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

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: proporcionado por Komet Sales.
client_secret: proporcionado por Komet Sales.
state (optional): alfanúmerico. Con fines de seguridad. Este valor se retorna tal cual en la respuesta.


Info
titleInformación

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


Code Block
languagejs
titleSample
## Oauth 2 - Local - Check Token curl -X "POST" "http://localhost:9090/oauth/check_token" \ -H 'Cache-Control: no-cache' \ -H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' \ -u '760b238e6eefd5a9cdf5152071ee096e:9e7a7bdeacc9625697e5226154cd2afed4c457fd8c10c8dc4c72b1f97fd2b18e' \ --data-urlencode "token=6d6ea94c-bf8e-4f8b-be18-6e66fe38f975"


Response


Code Block
languagejs
titleSample
 { "aud": [ "ks-ecommerce" ], "user_name": "diego+ecommerce@kometsales.com", "scope": [ "READ", "WRITE" ], "last_name": "Garcia", "customers": [ { "id": 141839, "code": "RD", "name": "Customer 6" }, { "id": 148121, "code": "148121", "name": "Customer 8" } ], "first_name": "Diego", "authorities": [ "ROLE_USER" ], "account": "4d544d344d44513d", "client_id": "0a448854c90376777bedb88f7b42da82" }






Panel
titleArtículos Relacionados

Filter by label (Content by label)
showLabelsfalse
max10
showSpacefalse
sorttitle
cqllabel in ("integraciones","oauth","autenticaciones")


Warning
titleImportante

Esta integración debería ser ejecutada por un especialista en IT. En caso de que tenga alguna pregunta sobre el proceso, contáctenos a support@kometsales.com.


Panel
borderColorCerulean
bgColorWhite
titleColorWhite
titleBGColorSteelBlue
titleKey WordsPalabras Clave

El usuario (Propietario de recursos): Hace la petición a través del enlace proporcionado por la compañía.

Aplicación: El sitio web de terceros

Agente de Usuario: El navegador web.