Ir al contenido principal

¿Cómo crear un nuevo Cliente OAuth2 en nuby para consumo de la API?

Esta guía te explica explica paso a paso cómo crear un nuevo Cliente OAuth2 en nuby, para que aplicaciones externas puedan conectarse de forma segura a la API de nuby y consultar o gestionar información como propiedades, contratos, terceros, facturas y más.

Al completar este proceso, obtendrás las credenciales de acceso (Client ID y ClaveClient Secreta)Secret) que la aplicación externa necesita para autenticarse y consumir los servicios disponibles en la API.

Para navegar esta guía, haz clic sobre la sección que desees consultar. Cada sección se expande al dar clic.

1. ¿Qué es un Cliente OAuth2? 🔐

Un Cliente OAuth2 es un registro en nuby que representa a una aplicación o sistema externo que desea acceder a la información de tu inmobiliaria a través de la API. Al crear un cliente, nuby genera automáticamente un par de credenciales de seguridad que esa aplicación necesita para identificarse y obtener autorización de acceso.

🔹 ¿Para qué sirve?

  • Conectar sistemas externos → Permite que aplicaciones de terceros (portales web, aplicaciones móviles, sistemas contables, etc.) se comuniquen con nuby de forma segura.

  • Controlar el acceso → Puedes definir qué tipo de operaciones puede realizar cada aplicación: solo consultar datos, crear registros, actualizar información o eliminar datos.

  • Garantizar la seguridad → Cada aplicación se identifica con credenciales únicas, lo que permite rastrear y auditar quién accede a la información.

🔹 Credenciales generadas automáticamente

Al crear un Cliente OAuth2, nuby genera automáticamente:

  • ID del Cliente (Client ID)ID → Un código numéricoidentificador único que identificarepresenta a la aplicación.

    Se usa como “usuario” al autenticarse en la API.
  • Client

    Clave Secreta (Secret Key) → Una contraseñaclave secreta cifrada que, junto con el Client ID, permite a la aplicación autenticarseautenticarse. anteSolo lase API.

    muestra una vez en el momento de creación y no puede recuperarse después.

Token Fijo (opcional)Importante: →El UnClient códigoSecret se muestra únicamente al momento de accesocrear permanenteel concliente. vigenciaUna vez que cierres esa pantalla, el valor no podrá visualizarse de 10nuevo. años,Cópialo idealinmediatamente paray integracionesguárdalo queen requierenun accesolugar continuo sin necesidad de renovar credenciales periódicamente.seguro.

🔹 ¿Para quién es útil esta guía?

  • Administradores del sistema → Para crear y gestionar las credenciales de acceso a la API.

  • Equipos técnicos → Para obtener las credenciales necesarias para desarrollar integraciones con nuby.

  • Gerencia → Para comprender cómo funciona el acceso de aplicaciones externas a la información de la inmobiliaria.

2. Antes de empezar (prerrequisitos) ✅

Antes de crear un Cliente OAuth2, verifica que cuentas con lo siguiente:

📌 Requisito 1. Permisos de administrador

Necesitas tener permisos de administrador o acceso al módulo de Configuraciones en nuby. Solo los usuarios con el rol adecuado pueden crear, editar o eliminar clientes OAuth2.

Tip: Si no tienes acceso al módulo de Configuraciones, solicita al usuario administrador de tu sistema que te otorgue los permisos necesarios.

📌 Requisito 2. Identificar la aplicación que se conectará

Ten claro qué aplicación o sistema externo utilizará estas credenciales. Esto te ayudará a asignar un nombre descriptivo al cliente y definir los permisos adecuados.

  • Ejemplo → "“Portal Web Mi Inmobiliaria"Inmobiliaria”, "“App Móvil Clientes"Clientes”, "“Sistema Contable XYZ"XYZ”.

📌 Requisito 3. Definir los permisos necesarios

Determina qué tipo de acceso necesita la aplicación externa:

Permiso ¿Qué permite hacer?
Consultar (read) Leer y consultar información (propiedades, contratos, terceros, facturas, etc.).
Crear (create) Crear nuevos registros en el sistema a través de la API.
Actualizar (update) Modificar registros existentes en el sistema a través de la API.
Eliminar (delete) Eliminar registros del sistema a través de la API.

Recomendación de seguridad: Asigna únicamente los permisos que la aplicación realmente necesita. Si la aplicación solo necesita consultar datos, no le otorgues permisos de crear, actualizar o eliminar. Esto reduce riesgos de seguridad.

3. ¿Cómo acceder al módulo de API? 🛠️

🔐 Paso 1. Inicia sesión en nuby

Ingresa a nuby con tu usuario y contraseña habituales.

📂 Paso 2. Dirígete a Configuraciones

  1. En el menú principal (barra superior), ubica el ícono de engranaje ⚙️ o busca la opción de "Configuraciones"“Configuraciones” entre los menús disponibles.

  2. Al ingresar, verás una pantalla con múltiples tarjetas de configuración organizadas en categorías.

📌 Paso 3. Selecciona "“API Arrendasoft"nuby”

Dentro de la pantalla de Configuraciones, busca la tarjeta llamada "“API Arrendasoft"nuby”. Su descripción dice: "Controle la información de las Integraciones con Arrendasoft."

Haz clic sobre esta tarjeta para ingresar al módulo de gestión de clientes OAuth2.

📄 Paso 4. Visualiza los clientes existentes

Al ingresar al módulo verás:

  • Panel lateral izquierdo → Información explicativa sobre qué es un Cliente OAuth2,OAuth2 y qué es una APIAPI, ymás un enlace a la documentación técnica.

  • Panel derecho ("“Clientes OAuth2"OAuth2”) → ListaCuadrícula de tarjetas con todos los clientes OAuth2 creadoscreados. actualmente,Cada mostrandotarjeta susmuestra credencialesel Client ID (copiable), el Client Secret (siempre enmascarado como ●●●●●●●●), los Permisos como etiquetas de color y permisos.

    el Tipo de Autenticación.
  • Botón

    Botones“Crear superioresCliente” → "CrearUbicado Cliente"en parala agregarparte unosuperior, nuevoabre yel "Volver"formulario parade regresar a Configuraciones.

    creación.

Si desea conocer en detalle los servicios disponibles en la API y cómo utilizarlos, consulte la guía  API Arrendasoftnuby V2 

4. Crear un nuevo Cliente OAuth2 paso a paso 🔧

A continuación te explicamos cómo crear un nuevo Cliente OAuth2 desde el módulo de API.

📝 Paso 1. Abrir el formulario de creación

Desde la pantalla principal del módulo de API, haz clic en el botón "“Crear Cliente"Cliente” ubicado en la parte superior. Se abrirá una ventana emergente con el formulario "Crear/Editar“Nuevo Cliente OAuth2"OAuth2”.

✏️ Paso 2. Completar el Nombre del Cliente

En el campo "“Nombre del Cliente"Cliente”, escribe un nombre descriptivo que identifique a la aplicación que usará estas credenciales.

  • Campo obligatorio → No se puede crear el cliente sin un nombre.

  • Debe ser único → No puede existir otro cliente con el mismo nombre en el sistema.

  • Máximo

    255 caracteres.

  • Ejemplos → "“Portal Web Corporativo"Corporativo”, "“App Móvil Clientes"Clientes”, "“Integración ERP Contable"Contable”.

Importante: Escoge un nombre claro y descriptivo. Esto facilitará identificar a qué aplicación corresponde cada cliente cuando tengas varios registrados.

🔑 Paso 3. Definir los AccesosPermisos (Permisos)Scopes)

En el campo "Accesos"“Permisos (Scopes)”, selecciona los permisos que la aplicación tendrá al consumir la API. Este es un campo de selección múltiple donde puedes elegir una o varias opciones:múltiple.

Opción Nombre técnico ¿Qué permite?
Consultar read Leer y consultar información del sistema (propiedades, contratos, terceros, facturas, etc.).
Crear create Agregar nuevos registros al sistema mediante la API.
Actualizar update Modificar registros existentes en el sistema mediante la API.
Eliminar delete Eliminar registros del sistema mediante la API.

Para seleccionar varios permisos, hazmantén presionada la tecla Ctrl (o Cmd en Mac) mientras haces clic en cada opción que desees agregar. Las opciones seleccionadas aparecerán como etiquetas dentro del campo.desees.

Atención: Otorga solo los permisos estrictamente necesarios. Si la aplicación solo requiere consultar datos, selecciona únicamente "Consultar"“Consultar”. Esto protege la integridad de tu información.

📄 Paso 4. Escribir la Descripción

En el campo "Descripción"“Descripción”, escribe una descripción clara del propósito de este cliente.

  • Campo obligatorio → El sistema requiere una descripción para crear el cliente.

  • Máximo

    500 caracteres.

  • Utilidad → Ayuda a recordar para qué se creó el cliente y quién lo utiliza.

  • Ejemplos → "“Credenciales API para la integración con el portal web corporativo de la inmobiliaria"inmobiliaria”, "“Acceso API para la aplicación móvil de gestión de propiedades"propiedades”.

🔒 Paso 5. Decidir si necesitas un Token Fijo

El campo "¿Token Fijo?" es un interruptor que te permite generar un token de acceso permanente junto con el cliente.

Opción¿Qué sucede?¿Cuándo usarlo?
NO (predeterminado)Solo se generan el ID y la Clave Secreta. La aplicación deberá autenticarse periódicamente para obtener un token temporal.Para la mayoría de integraciones. Es la opción más segura porque los tokens temporales expiran automáticamente.
SIAdemás del ID y la Clave Secreta, se genera un token de acceso fijo con vigencia de 10 años. La aplicación puede usar este token directamente sin necesidad de autenticarse cada vez.Para integraciones simples o sistemas que no pueden gestionar el flujo de autenticación OAuth2 (solicitar tokens temporales).

Recomendación: Usa "NO" (sin token fijo) siempre que sea posible. Los tokens temporales son más seguros porque expiran automáticamente. Solo activa el Token Fijo si la aplicación realmente lo necesita.

💾 Paso 6.5. Crear el Cliente

Haz clic en el botón "“Crear Cliente"Cliente”.

Si todo está correcto:

  • Se creará el cliente y se generarán automáticamente el Client ID, la Clave Secreta y, si lo solicitaste,y el TokenClient FijoSecret.

  • La ventana delEl formulario semostrará cerrará y launa pantalla principalde se actualizará mostrando el nuevo clienteconfirmación con suslas credenciales.

    credenciales generadas (ver Paso 6).

Si hay algún error:

  • Si el Nombre del Cliente ya existe, el sistema te notificará que el nombre debe ser único.

  • Si falta algún campo obligatorio (Nombre o Descripción),obligatorio, el sistema te indicará cuál campo necesitas completar.

🔐 Paso 6. Copiar las credenciales (paso crítico)

Inmediatamente después de crear el cliente, la pantalla mostrará una tarjeta titulada “Cliente OAuth2 Creado Exitosamente” con las credenciales generadas. Esta es la única vez en que podrás ver el Client Secret.

  • Client ID → El identificador del cliente. Tiene un botón de copia rápida.
  • Client Secret → La clave secreta. Aparece resaltada en amarillo con un botón de copia rápida. No se almacena en texto plano y no podrá recuperarse.

¡Copia el Client Secret ahora! Una vez que cierres esta pantalla (al hacer clic en “Entendido, ya copí las credenciales”), el Client Secret no volverá a mostrarse. Si lo pierdes, deberás regenerar una nueva contraseña desde la tarjeta del cliente.

Después de copiar las credenciales, haz clic en “Entendido, ya copí las credenciales” para cerrar la ventana y volver a la lista de clientes.

5. ¿Qué credenciales se generan y cómo usarlas? 🔑

Después deAl crear elun cliente,Cliente enOAuth2, elnuby panelgenera deautomáticamente "Clientesdos OAuth2"credenciales aparecerá una tarjeta con todaque la informaciónaplicación delexterna nuevonecesita cliente.para A continuación te explicamos cada dato:autenticarse:

📋 Datos del Cliente

  • Nombre → El nombre que asignaste al crear el cliente. Aparece como título de la tarjeta.

    tarjeta en el listado.
  • Client

    ID → El identificador único del cliente. Es ununa códigocadena numérico generadogenerada automáticamente. Este valor se usa como "usuario"“usuario” al autenticarse en la API.

    Siempre visible en la tarjeta del cliente con un botón de copia.
  • Client

    Secret_KeySecret → La clave secreta cifrada del cliente. Este valor seSe usa como "contraseña"“contraseña” al autenticarse en la API.

    Solo se muestra una vez, justo después de crear el cliente. En el listado, este valor siempre aparece enmascarado como ●●●●●●●●●●●●.

  • TokenPermisos (solo si solicitaste Token Fijo) → El token de acceso permanente. Puede usarse directamente en las solicitudes a la API sin necesidad de autenticarse cada vez. Los tokens fijos se identifican por un sufijo especial.

  • ScopeScopes) → Los permisos asignados al cliente, separadosmostrados porcomo comas.etiquetas Ejemplo:de read,create,update,color en la tarjeta (Ej: read, create, update, delete).

  • Tipo

    de Autenticación → Siempre es client_credentials. Se asigna automáticamente y no es configurable.

  • Descripción → La descripción que escribiste al crear el cliente.

El Client Secret solo se muestra una vez. Después de crear el cliente y cerrar la pantalla de confirmación, no podrás ver el Client Secret de nuevo. Si no lo copiaste, deberás usar el botón de regenerar contraseña (ver Sección 6).

🔹 ¿Cómo autenticarse en la API con estas credenciales?

La aplicación externa debeusa usarel lasClient credencialesID dely clienteel Client Secret para obtener un token de acceso.acceso Existentemporal dosmediante formasel deflujo hacerlo:OAuth2 Client Credentials:

Opción A: Autenticación con ID y Clave Secreta (recomendado)
  1. Solicitar

    acceso → La aplicación envía unael solicitudClient ID y el Client Secret al servicio de autenticación de la API con el ID (como usuario) y la Secret_Key (como contraseña).

    API.
  2. Recibir

    token → La API valida las credenciales y devuelve un token temporal (formato JWT) junto con unasu duraciónfecha limitada.

    de expiración.
  3. Usar

    el token → La aplicación usaincluye eseeste token en las siguientes solicitudes a la API incluyéndolo en la cabecera de autorización.

    autorización (Authorization: Bearer [token]) en cada solicitud a los servicios de la API.
  4. Renovar

    cuando expire → Cuando el token expire, la aplicación debe solicitar uno nuevo repitiendorepetir el paso 1.

    1 para obtener uno nuevo.
Opción B: Uso directo del Token Fijo

Si creaste el cliente con la opción de Token Fijo, la aplicación puede usar directamente este token en todas las solicitudes sin necesidad de autenticarse previamente. Este token tiene una vigencia de 10 años.

Para conocer los detalles técnicos del proceso de autenticación, los servicios disponibles y los formatos de solicitud, consulte la documentación de la API en  API Arrendasoftnuby V2 

6. Gestión de clientes existentes 📋

Desde el módulo de API puedes gestionar los clientes OAuth2 que ya están creados. Cada tarjeta de cliente cuenta con dos botones de acción:acción.

✏️ ActualizarEditar un Cliente

  1. Ubica el cliente que deseas modificar en la lista.

  2. Haz clic en el botón "Actualizar"“Editar” de la tarjeta del cliente.

  3. Se abrirá elun formulario con los datos actuales del cliente.

  4. Puedes modificar el Nombre del Cliente, los AccesosPermisos (Scopes) y la Descripción.

  5. El

    Client ID y el Tipo de Autenticación se muestran como información de solo lectura.

  6. Haz clic en "“Actualizar Cliente"Cliente” para guardar los cambios.

Nota: El Client ID y la Clave Secreta no se modificanpuede almodificar. actualizar.El SiClient Secret tampoco se muestra en el formulario de edición; si necesitas regenerarregenerarlo, la clave secreta, puedes hacerlo desdeusa el botón de generación de nuevaregenerar contraseña si está disponible endesde la tarjeta del cliente en el listado.

🔄 Regenerar el Client Secret

Si perdiste el Client Secret o necesitas renovarlo por seguridad, puedes generar uno nuevo sin necesidad de eliminar el cliente:

  1. En la tarjeta del cliente (listado principal), ubica el campo “Client Secret” (que siempre aparece enmascarado como ●●●●●●●●).
  2. Haz clic en el botón de rotación (icono ↻) ubicado junto al campo enmascarado.
  3. Se abrirá una ventana titulada “Nueva Contraseña Generada” mostrando el nuevo Client Secret.
  4. Copia el nuevo Client Secret inmediatamente usando el botón de copia. Una vez que cierres esta ventana, no podrás ver el valor nuevamente.
  5. Actualiza las credenciales en la aplicación que usaba el cliente.

Importante: Al regenerar el Client Secret, el valor anterior queda inválido inmediatamente. Cualquier aplicación que lo usara deberá actualizarse con el nuevo valor para continuar funcionando.

🗑️ Eliminar un Cliente

  1. Ubica el cliente que deseas eliminar en la lista.

  2. Haz clic en el botón "Eliminar"“Eliminar” de la tarjeta del cliente.

  3. El sistema te pedirá confirmación antes de proceder.

  4. Al confirmar, el cliente y todos sus tokens de acceso serán eliminados permanentemente.

Atención: Al eliminar un cliente, cualquier aplicación que esté usando sus credenciales perderá el acceso inmediatamente a la API. Asegúrate de que ninguna aplicación activa dependa de ese cliente antes de eliminarlo.

7. Resumen de campos del formulario 📋

Esta tabla resume todos los campos disponibles en el formulario de creación de un Cliente OAuth2:

Campo Tipo Obligatorio Editable Descripción
Nombre del Cliente Texto (máx. 255 car.) Sí Sí Nombre descriptivo que identifica a la aplicación. Debe ser único en el sistema.
AccesosPermisos (Scopes) Selección múltiple NoSí Sí Permisos que tendrá la aplicación: Consultar,read, Crear,create, Actualizar,update, Eliminar.delete. Usar Ctrl+Clic para seleccionar varios.
Descripción Texto largo (máx. 500 car.) Sí Sí Descripción del propósito del cliente y qué aplicación lo usa.
¿TokenClient Fijo?Interruptor (Sí/No)NoSolo al crearSi se activa, genera un token de acceso permanente (10 años) además de las credenciales estándar.
ID Texto (solo lectura) — No (generado) Identificador único del cliente, generado automáticamente al crear. Siempre visible en el listado.
Secret_KeyClient Secret Texto (solo lectura) — No (generado)regenerable) Clave secreta cifrada, generada automáticamenteautomáticamente. Solo se muestra al crear.crear o al regenerar. En el listado siempre aparece enmascarado.
TokenTipo de Autenticación Texto (solo lectura) — No (generado)fijo) TokenSiempre declient_credentials. accesoNo fijo.es Soloconfigurable sepor generael si se activó la opción "¿Token Fijo?".usuario.
8. ¿Cómo funciona la autenticación en la API? 🔄

Una vez creado el Cliente OAuth2, la aplicación externa puede conectarse a la API de nuby siguiendo esteel flujo:flujo OAuth2 Client Credentials:

🔹 Flujo conde Token Temporalautenticación (recomendado)

  1. Solicitar acceso → La aplicación envía el Client ID (como usuario) y lael Secret_KeyClient Secret (como contraseña) al servicio de autenticación de la API.

  2. Recibir token → La API valida las credenciales y devuelve un token temporal (formato JWT) junto con su fecha de expiración.

  3. Usar el token → La aplicación incluye este token en la cabecera de autorización (Authorization: Bearer [token]) en cada solicitud a los servicios de la API.

  4. Renovar cuando expire → Cuando el token expire, la aplicación debe repetir el paso 1 para obtener uno nuevo.

🔹 Flujo con Token Fijo

  1. Obtener el token → Copia el Token Fijo que aparece en la tarjeta del cliente en el módulo de API.

  2. Usar directamente → La aplicación incluye este token en la cabecera de autorización (Authorization: Bearer [token]) en cada solicitud.

  3. No requiere renovación frecuente → El Token Fijo tiene una vigencia de 10 años.

🔹 Seguridad de las credenciales

  • Las credenciales del cliente son exclusivas para la aplicación que las utiliza.

  • Cada solicitud a la API es validada verificando que el token sea legítimo y no haya expirado.

  • Los permisos asignados al cliente determinan qué operaciones puede realizar la aplicación.

  • El Client Secret no se almacena en texto plano en nuby. Solo se guarda su hash. Si se pierde, debes regenerarlo.

Para información técnica completa sobre los servicios disponibles en la API (propiedades, contratos, terceros, facturas, contabilidad y más), consulte la documentación en  API Arrendasoftnuby V2 

9. Preguntas frecuentes ❓

¿Puedo crear varios Clientes OAuth2?

Sí. Puedes crear tantos clientes como necesites. Cada uno tendrá sus propias credenciales y permisos independientes. Es recomendable crear un cliente diferente para cada aplicación o integración.

¿Puedo modificar los permisos de un cliente ya creado?

Sí. Puedes actualizar los accesospermisos (permisos)Scopes) de un cliente existente haciendo clic en el botón "Actualizar"“Editar” de la tarjeta del cliente. Los cambios aplican para las nuevas solicitudes que se realicen.

¿Qué pasa si elimino un Cliente OAuth2?

Al eliminar un cliente:

  • Se eliminan todas las credenciales (Client ID, ClaveClient Secreta)Secret).

  • Se eliminan todos los tokens de acceso asociados (temporales y fijos).

    asociados.

  • Cualquier aplicación que usara esas credenciales perderá el acceso inmediatamente.

¿Puedo ver el Client Secret después de crear el cliente?

No. El Client Secret solo se muestra una vez, justo después de crear el cliente. Después de eso, siempre aparece enmascarado (●●●●●●●●) en el listado y no puede recuperarse. Si lo perdiste, usa el botón de regenerar contraseña (icono ↻) en la Clavetarjeta Secretadel cliente.

¿Puedo regenerar el Client Secret sin eliminar el cliente?

Sí. SiHaz clic en el botón de rotación (↻) en la tarjeta del clientecliente. muestraSe unabrirá botónuna paraventana generar nueva contraseña, puedes usarlo para regenerar la Clave Secreta sin afectarcon el IDnuevo niClient los demás datos del cliente.Secret. Recuerda quecopiarlo de inmediato y actualizar las credenciales en la aplicación que uselas esas credenciales deberá actualizarse con la nueva clave.usaba.

¿Qué diferencia hay entre un Token Temporal y un Token Fijo?

CaracterísticaToken TemporalToken Fijo
DuraciónExpira automáticamente (duración limitada).Vigencia de 10 años.
RenovaciónLa aplicación debe autenticarse nuevamente para obtener un nuevo token.No requiere renovación frecuente.
SeguridadMás seguro. Si el token se filtra, expirará en poco tiempo.Menos seguro. Si el token se filtra, puede ser usado durante años.
Uso recomendadoAplicaciones que pueden gestionar el flujo de autenticación.Integraciones simples o sistemas que no pueden autenticarse dinámicamente.

¿El nombre del cliente afecta su funcionamiento?

No. El nombre es solo una etiqueta para identificar al cliente. Lo que importa para la autenticación son el Client ID y lael ClaveClient SecretaSecret (o el Token Fijo).

¿Las credenciales cambian si actualizoedito el cliente?

No. Al actualizareditar un cliente (nombre, descripción o permisos), el Client ID y lael ClaveClient SecretaSecret se mantienen. Solo se modifican los datos que cambies en el formulario.

¿Qué servicios están disponibles en la API?

La API de nuby ofrece servicios para gestionar:

  • Autenticación → Obtener tokens de acceso.

  • Maestras → Consultar datos base del sistema.

  • Propiedades → Gestionar el catálogo de propiedades.

  • Asesores → Consultar información de asesores.

  • Facturas → Consultar y gestionar facturas.

  • Contabilidad → Consultar información contable.

  • Contratos → Gestionar contratos de arrendamiento.

10. Solución de problemas 🔍
Problema Posible causa Solución
No puedo crear el cliente: "“nombre ya existe"existe” Ya existe otro cliente con el mismo nombre. Usa un nombre diferente y único para el nuevo cliente.
No puedo crear el cliente: campo obligatorio Falta completar el NombreNombre, Permisos o la Descripción. Asegúrate de llenar ambostodos los campos requeridos antes de hacer clic en "“Crear Cliente"Cliente”.
No veo el módulo "“API Arrendasoft"nuby” en Configuraciones No tienes los permisos necesarios. Solicita al administrador del sistema que te otorgue acceso al módulo.
No copí el Client Secret a tiempoLa pantalla de confirmación fue cerrada antes de copiar.Usa el botón de regenerar contraseña (↻) en la tarjeta del cliente. El nuevo valor se muestra en una ventana emergente.
La aplicación externa no puede autenticarse Las credenciales (Client ID o ClaveClient Secreta)Secret) están mal copiadas.copiadas, o el Client Secret fue regenerado. Verifica que el Client ID y lael ClaveClient SecretaSecret se copiaron correctamente, sin espacios adicionales. Si se regeneraron, actualiza las credenciales en la aplicación.
El token expiró y la aplicación no puede acceder El token temporal ha caducado. La aplicación debe autenticarse nuevamente con el Client ID y lael ClaveClient SecretaSecret para obtener un nuevo token.
Eliminé un cliente por error Los datos del cliente fueron borrados permanentemente. Crea un nuevo cliente y actualiza las credenciales en la aplicación que lo usaba.
La aplicación solo puede consultar pero no crear datos El cliente solo tiene el permiso "Consultar" (read)“read”. ActualizaEdita el cliente y agrega el permiso "Crear" (create)“create” en los Accesos.Permisos (Scopes).
11. Resumen rápido 🚀

Para crear un nuevo Cliente OAuth2 en nuby, sigue estos pasos:

  1. Ve a Configuraciones > API Arrendasoftnuby.

  2. Haz clic en "“Crear Cliente"Cliente”.

  3. Escribe un Nombre descriptivo y único para el cliente.

  4. Selecciona los AccesosPermisos (permisos)Scopes) que la aplicación necesita.

    necesita (Ctrl+Clic para seleccionar varios).

  5. Escribe una Descripción del propósito del cliente.

  6. Decide si necesitas un Token Fijo (solo si es realmente necesario).

  7. Haz clic en "“Crear Cliente"Cliente” → Se generan las credenciales automáticamente.

  8. Copia lasel credencialesClient (ID, Secret_KeyID y Tokenel siClient aplica)Secret yinmediatamente. proporciónalasEl aClient laSecret aplicaciónno quepodrá consumirávisualizarse lade API.

    nuevo después de cerrar esta pantalla.
  9. Haz clic en “Entendido, ya copí las credenciales” para finalizar.
🔹 Reglas clave:
Regla Comportamiento
Nombre del cliente Debe ser único en el sistema. Es obligatorio.
Descripción Es obligatoria. Ayuda a identificar el propósito del cliente.
CredencialesClient Secret Se generanmuestra automáticamentesolo una vez, al crear.crear Noel cliente. Después siempre aparece enmascarado. Si se puedenpierde, editarse manualmente.puede regenerar.
Permisos (Accesos)Scopes) Son modificables después de la creación vía "Actualizar"“Editar”.
TokenTipo Fijode autenticación SoloSiempre seclient_credentials. puedeNo generarconfigurable al momento de crearpor el cliente. Vigencia: 10 años.usuario.
Eliminación Eliminar un cliente borra todas sus credenciales y tokens asociados.

Para más información sobre la API de nuby y los servicios disponibles, consulte la documentación técnica completa en API Arrendasoftnuby V2. También puede explorar la categoría Integración y API para encontrar guías de integración adicionales.

Volver arriba