Acceso a API de usuarios del stack EEI

Buenas, queremos poder acceder al swagger del servicio de usuario. Desde el stack EEI se puede acceder?

Estamos teniendo problemas con EndPoint del servicio de usuario que hace un DELETE a las cuentas asociadas que tiene un usuario.
endpoint: https://expedientes.unne.edu.ar/api-usuarios/v1/usuarios/37426368/cuentas/37426368?aplicacion=_da7fbf19f39b19b0da05b06d2990cebcddc36b8de8
desde nuestro entender, estamos realizando bien la llamada al endpoint.

Mi usuario, tiene asociada la cuenta para G3.

Adjunto el logs del error y pantallas del modulo de arai usuarios, con la cuenta asaciada.

Muchas gracias y saludos.-


usuarios-logs.doc (3.89 KB)

usuarios.png

usuarios.png

usuarios3.png

usuarios3.png

Hola Sergio!

Efectivamente, la API v1 de arai-usuarios presenta un bug al momento de eliminar una cuenta que vincula un usuario con una aplicación!

Estamos analizando y si corresponde se sacará una versión de hotfix con dicho arreglo!

Buenas Sergio, gracias por responder.

Te consulto, tenemos entendido, que además de la API V1, existe otra API V2. Como se podría acceder al endpoint para elimanar un cuenta de un usuario?

Muchas gracias.-

Claro, la API está versionada por URL, es decir se cambia de v1 a v2, y asi…

https://expedientes.unne.edu.ar/api-usuarios/v2/usuarios/UID/cuentas/ID-CUENTA?aplicacion=ID_APP

Hola!

Estamos publicando la v3.0.10 de arai-usuarios que corrige este bug en la API. Aun no está en EEI, pero si lo necesitan con urgencia pueden actualizar el tag en su instalación de arai-usuarios.

Saludos!

Buenas sergio, te consulto, también para el post del end point de https://expedientes.unne.edu.ar/api-usuarios/v2/usuarios resuelve este nueva version?

Al querer hacer el post con estos datos:
{
“nombre”: “Hector Luis”,
“apellido”: “Luque”,
“email”: “hluque@unne.edu.ar”,
“identificador”: “374263668”,
“persona”: 0,
“password”: “toba123*-a”,
“atributos” :{“numeroDocumento”: “37426368”}

}

nos sale un error:

“error”: 400,
“mensaje”: “400 Bad Request”,
“descripcion”: “Error en la validación del recurso”,
“detalle”: {
“campos_no_permitidos”: [
“Se encontraron campos no permitidos: atributos.”
],
}
}

Sergio los end points que nos interesan son los GET, POST, PUT para usuarios, y el DELETE para cuentas delos usuarios

Hola Sergio,

El mensaje de error es correcto, los Endpoints de la API v2 no tienen la misma definicion que aquellos de la API v1 (por ello el cambio de version).
Te dejo un link a la documentacion de la API, fijate que los atributos se agregan como una modificacion de un usuario particular y luego se manejan como un subrecurso de un usuario en particular.

Saludos

Buenas Ricardo, estuve viendo la doc de la API.
Y necesitariamos que para realizar un post de un usuario se pasen tbm los atributos, este seria el ejemplo para la API V1

{
“nombre”: “string”,
“apellido”: “string”,
“email”: “string”,
“identificador”: “string”,
“persona”: 0,
“bloqueado”: true,
“password”: “string”,
“password_actual”: “string”,
“atributos”: {
“displayName”: “string”,
“employeeNumber”: 0,
“eduPersonAffiliation”: “string”,
“eduPersonEntitlement”: “string”,
“eduPersonNickname”: “string”,
“eduPersonOrgDN”: “string”,
“eduPersonOrgUnitDN”: “string”,
“eduPersonPrimaryAffiliation”: “string”,
“eduPersonPrimaryOrgUnitDN”: “string”,
“eduPersonPrincipalName”: “string”,
“eduPersonPrincipalNamePrior”: “string”,
“eduPersonScopedAffiliation”: “string”,
“eduPersonTargetedID”: “string”,
“eduPersonAssurance”: “string”,
“eduPersonUniqueId”: “string”,
“eduPersonOrcid”: “string”,
“genero”: “string”,
“tipoDocumento”: “string”,
“numeroDocumento”: “string”,
“mails”: “string”,
“certificado”: “string”,
“cuit”: “string”
}
}

Nos interesa mas el atriubto “numeroDocumento”, ya que sudocu tiene una funcionalidad de crear por defecto a usuarios que no esten en su base de datos con un perfil visitante, y no nos permite ya que es un dato necesario para éste y en arai usuarios (el esta EEI )no se puede realizar el post con el con éste campo atributo/numeroDocumento .

ahi estuve mirando y note que hay un error en la publicacion de la documentacion de la API, no solo eso… sino que lo que te puse en el post anterior tambien estaba parcialmente equivocado a causa de ello, disculpame por la mala informacion.

El endpoint /vX/usuarios unicamente sirve para dar de alta o modificar el usuario, todo el manejo de atributos se realiza via el endpoint vX/usuarios/IDUsuario/atributos.
En ese segundo endpoint podes enviar el JSON correspondiente a los atributos.

Esto es entonces asi, para lograr lo que queres necesitas:


POST /v1/usuarios 

PUT /v1/usuarios/IDOBTENIDOARRIBA/atributos

Es como se creo la API originalmente, acabo de verificarlo tanto por Swagger como en codigo… el problema esta en la documentacion en la cual se incorporo por error un modelo que no pertenece alli.

Saludos

Ricardo, bueniisimo, muchas gracias por la información.

Pruebo estos end point, cualquier cosa estaré molestando de nuevo jaja.

Saludos.-

Sergio, estuve probando hacer el pull de la version de la imagen qeu me mancionas la 3.0.10, y no me descarga.

Te dejo pantalla de la salida.
Gracias.-


Screenshot_20210426_121610.png

Screenshot_20210426_121610.png

Buenas Sergio, estube probando descargar la version que mencionas, la V3.0.10, pero tengo problemas, esto para probar lo del endpoint del delete de cuentas de los usuarios.

Te dejo la salida.

root@sudocu-dev:/usr/local/siu/expedientes/prod/arai# docker pull hub.siu.edu.ar:5005/siu/expedientes/arai-usuarios/idp:v3.0.10
Error response from daemon: manifest for hub.siu.edu.ar:5005/siu/expedientes/arai-usuarios/idp:v3.0.10 not found: manifest unknown: manifest unknown

Hola, disculpas por la demora!

Está publicado en hub las imágenes Docker v3.0.10 de arai-usuarios (ya está también la v3.0.11).

Saludos!

Buenas, perdón que traiga este hilo de ultratumba. Estamos queriendo acceder al Swagger de Usuarios sin mucho éxito.

Actualmente tenemos instalada la versión 1.5.4 de EEI. Podemos acceder bien a la API de usuarios, pero no encontramos la url de swagger.

Para poner datos concretos, podemos acceder a la API de usuarios en esta url

https://portal.unlu.edu.ar/api-usuarios/v2/usuarios (devuelve el json con los usuarios de la base)

URLs que probamos sin éxito

https://portal.unlu.edu.ar/api-usuarios/v2/rest
https://portal.unlu.edu.ar/api-usuarios/rest
https://portal.unlu.edu.ar/usuarios/rest

También suponemos que puede haber un quilombo en el traefik, pero capaz es un problema conocido, y por eso preguntamos.

Hola Tomas,

No lo van a poder realizar, en las imágenes Docker no se distribuye el cliente Swagger de API. Si lo que desean es interactuar con la API pueden hacerlo vía curl, o si requieren la documentación, la pueden ver acá.

Saludos!

Sergio, gracias. Tampoco se distribuye el .json de OpenAPI supongo? porque si estuviera, se podría poner un cliente Swagger en cualquier otro lado y utilizar esa spec.