CARGANDO . . .

Bienvenido a la documentación para desarrolladores.

GetIN es un código QR con criptografía asimétrica para el control de accesos a sitios web y lugares físicos a través del uso de la identidad digital de Personal Code.

Audiencia.
Esta documentación está dedicada a desarrolladores con la intención de implementar el control de acceso en sus sistemas web para facilitar el acceso de usuarios de manera segura. Esperamos que esta documentación resulte fácil de seguir. Asegúrese de cumplir con las configuraciones básicas que a continuación se presentan para el buen funcionamiento en la integración:

Plataformas

Windows.
Linux.
iOS
Android
MacOS

Navegadores

Google Chrome (en todas las plataformas)
Mozilla Firefox (en todas las plataformas)
Internet Explorer (Windows)
Microsoft Edge (Windows, Android, iOS, Windows)
Safari (MacOS, iOS)
Opera (MacOS, Windows).

Lenguaje

JavaScript.

Implementación

1. Para comenzar a utilizar GetIN, debe de descargar los recursos necesarios para su implementación aquí. Al darle click al enlace se descargará en automático el archivo (GetIN) comprimido de extensión ZIP.

2. Una vez terminada la descarga, utilice el explorador de archivos para localizarlo, le recomendamos utilizar el software WinRAR para Windows que le permitirá descomprimir el archivo. Lo puedes obtener en el siguiente enlace aquí. Al extraer el archivo ZIP, guarde su contenido en una carpeta accesible para su proyecto WEB.

3. Una vez descomprimido se podrán observar los archivos JavaScript de jQuery que deberán ser incluidos manualmente en su proyecto. Deberá referenciarlos justo antes de la etiqueta
en el siguiente orden:

Orden de Referencias

                            <script src="js/GetINConstants.js" type="text/javascript"></script>

                            <script src="js/GetINPersonalCode.js" type="text/javascript"></script>

Un ejemplo con el código completo, se vería así:

Ejemplo

                            <!DOCTYPE html>

                            <html>

                            <head>

                            <title>Index</title>

                            <!--Required meta tags-->

                            <meta charset="utf-8"/>

                            <meta name="viewport" content="width=device-width, initial-scale=1.0"/>

                            <link rel="stylesheet" href="css/bootstrap.min.css" />

                            </head>

                            <body>

                            <div class="container">

                            <div class="row">

                            <h1> Hello, world!</h1>

                            </div>

                            <br />

                            <div class="row">

                            <div class="col-lg-4">

                            <div id="acceso"></div>

                            </div>

                            <div class="col-lg-4"></div>
                                
                            <div class="col-lg-4"></div>

                            </div>

                            </div>

                            <script src="js/scripts/GetINConstants.js" type="text/javascript"></script>

                            <script src="js/scripts/GetINPersonalCode.js" type="text/javascript"></script>

                            </body>

                            </html>

4. Una vez incluidos los archivos en proyecto, abra el archivo “GetINConstants.js” en su entorno de desarrollo (IDE). En él encontrará un objeto el cual contiene las siguientes propiedades (para las cuales deberá modificar su valor acorde con sus necesidades):

Propiedades

GETIN_URL: Se establece la URL de redireccionamiento para poder ingresar al sistema cuando se completa el escaneo del GetIN.

Ejemplo

GETIN_URL: "https://login.personalcode.com/Modules/Dashboard.aspx"

GETIN_DivId: Se establece el nombre del componente que será usado para mostrar el GetIN de acceso.

Ejemplo

GETIN_DivId: "acceso"

GETIN_GetINID: Se establece la puerta de enlace con la que será identificado el acceso, si no se cuenta con el GetINID se puede utilizar la llave del ejemplo:

Ejemplo

                                GETIN_GetINID: "4E76278B1FE266461E890FE33E69110554658A7808F43EE7FAB2371AF0420E0A22A4606EDD89A82CF87D35BFF54B138DDC039543CA98267DAE4F12209EE83512"
                            

Asegúrese de guardar los cambios generados en el archivo "GetINConstants.js". Al abrir su sistema web en el navegador de su preferencia, podrá observar el GetIN como se muestra en el Demo.

¡¡Úselo ahora!!
Antes de escanear el código de acceso GetIN:

Instala la App Wallet Personal Code en su dispositivo móvil;
Cargue su Personal Code con la opción que le resulte más fácil (tome en cuenta que su Personal Code deberá estar registrado en el sistema y vinculado al Login de GetIN);
Siga las instrucciones para validar su identidad;
De click en “Solicita acceso” y escanee el código GetIN en la pantalla de su ordenador.
Al otorgar el acceso se redireccionará a la ruta previamente establecida como parámetro en el punto 4 de la implementación.
Una vez dentro del enlace se deberá validar el inicio sesión utilizando el parámetro enviado por URL. Para este punto deberá utilizar un par de llaves que son proporcionadas para la validación.
¡Listo! Ha iniciado sesión mediante Personal Code.