Administrar aplicaciones

Puede crear un app_id y una secret_key, necesarios para integrar SORI con sus aplicaciones móviles.

En la mayoría de los casos, solo se necesita una clave de aplicación para cada aplicación. Sin embargo, si ofrece más de una, puede crear y administrar claves diferentes para cada una.

El servidor de SORI API utiliza el app_id y la secret_key para autenticar el SDK. Estas credenciales funcionan como contraseñas, por lo que debe mantenerlas seguras. Si sospecha que una clave de aplicación se ha visto comprometida, puede revocarla y crear otra en SORI Console.

Crear un App ID y una Secret Key

Para crear una App Key, haga clic en el botón + de la esquina inferior derecha de la página.

Introduzca un nombre que permita identificar cada App Key y haga clic en Create. El App ID y la Secret Key que acaba de crear aparecerán en la lista.

Si utiliza varias aplicaciones, puede crear distintas App Keys del mismo modo.

Descargar un proyecto de ejemplo

Cuando ya existe una App Key, puede descargar un proyecto de ejemplo listo para compilar en su plataforma, en lugar de configurar las credenciales manualmente.

Haga clic en ⁝, a la derecha de la fecha de creación de la App Key, y seleccione Obtener código....

El cuadro de diálogo Descargar proyecto de ejemplo ofrece tres plataformas:

Plataforma	Proyecto de ejemplo
Android	SORI Example Android Kotlin
iOS	SORI Example iOS Swift
Flutter	SORI Example Flutter

Al seleccionar una plataforma, SORI Console genera un archivo ZIP a partir del repositorio de ejemplo público correspondiente, con el app_id y la secret_key de esta aplicación ya incluidos, por lo que no es necesario editar las credenciales a mano.

TIP

La generación del archivo tarda unos instantes. Mantenga el cuadro de diálogo abierto hasta que comience la descarga en el navegador.

Todos los archivos incluyen un SORI_CREDENTIALS_NOTICE.md que indica el archivo que contiene las credenciales y el comando de ejecución de esa plataforma.

Ejecutar el proyecto descargado

Descomprima el archivo y ejecute el proyecto desde su directorio raíz.

Android: las credenciales se escriben en local.properties como SORI_APP_ID y SORI_SECRET_KEY, y la compilación de Gradle las expone a la aplicación.

./gradlew installDebug

iOS: las credenciales se definen en SORIExample/ContentView.swift. Abra el proyecto en Xcode y ejecútelo en un dispositivo.

open SORIExample.xcodeproj

Flutter: las credenciales se escriben en sori_credentials.json y se proporcionan en tiempo de compilación, por lo que el comando de ejecución debe incluir ese archivo.

flutter pub get
flutter run --dart-define-from-file=sori_credentials.json

WARNING

El proyecto descargado contiene la secret_key de esta aplicación. No incluya la clave en ningún repositorio ni comparta el archivo tal cual. Si la Secret Key se ve comprometida, elimine la App Key y cree otra.

Para conocer todos los detalles de la integración, consulte las guías de Android, iOS y Flutter.

Eliminar un App ID y una Secret Key

Si el APP ID y la SECRET KEY se ven comprometidos, puede revocar la aplicación.

WARNING

Tenga en cuenta que la aplicación no se podrá recuperar después de eliminarla y que los SDK que la utilicen dejarán de funcionar.

Puede eliminar la APP Key haciendo clic en ⁝, a la derecha de su fecha de creación.