Grups d'Identitat

Ús

El Servei de Grups permet:

• crear grups de membres utilitzant expressions 
• recuperar el conjunt de membres d'un grup 
• recuperar el conjunt de grups a què pertany un membre

Els membres s'identifiquen per GaussID (com ara 100123) i només es poden utilitzar membres definits a Identitat.

Grups

Els grups s'identifiquen per un id (com ara example.group).

Les expressions defineixen el subconjunt de membres com a:

• Referència a altres grups: other.group
• Combinant grups existents amb operacions de conjunts:
• Unió: group.one ∪ group.two
• Intersecció: group.one ∩ group.two
• Diferència: group.one ∖ group.two
• Diferència simètrica: group.one ∆ group.two
• Obtenint membres de Origins i filtrant per atributs
• Els atributs són referenciats per $ORIGIN.$attribute (com ara ID.country o PRISMA.udCode) 
• Membres que coincideixen amb el valor de l'atribut: ID.country = "ES"
• Altres comparadors que es poden utilitzar: ≠, <, >, ≤, ≥
• Membres que coincideixen amb el valor de l'atribut (d'una llista): ID.country ∈ {"ES", "PT"}
• Membres que no coincideixen amb el valor de l'atribut (d'una llista): ID.country ∉ {"ES", "PT"}
• Les expressions de filtratge també es poden combinar utilitzant operacions de conjunts
• Els parèntesis ( ) es poden utilitzar per agrupar subexpressions

Exemple: (ID.country = "ES" ∩ ID.age ≥ 18) ∪ exceptions

Plantilles de grup

Les plantilles permeten crear molts grups (instàncies) alhora utilitzant un:

• id de plantilla com somePrefix.[ID.pais].[ID.provincia]
• expressió de plantilla com ID.pais = [ID.pais] ∩ ID.provincia = [ID.provincia]
• registres: una taula amb els atributs utilitzats per definir la plantilla. Per exemple:

Aquest exemple crearia els següents grups d'instància:

En cas que el registre contingui algun caràcter no permès en l'ID del grup, això s'escapa a !HH, per exemple: id de grup somePrefix.ES.C!F3rdoba amb expressió ID.pais = "ES" ∩ ID.provincia = "Córdoba".

Origins

Els Origins són interfícies per a sistemes d'informació externs que es poden utilitzar per filtrar membres.

Conceptualment, un Origin és una taula totalment desnormalitzada amb atributs.

Actualment hi ha dos Origins: ID (de Identitat) i PRISMA.

Atributs

Els atributs estan relacionats amb el domini del sistema d'informació extern.

L'atribut GaussID és obligatori ja que s'utilitza per identificar membres.

Generalment, els atributs haurien de ser agregables ja que el principal objectiu és filtrar conjunts de membres.

CommonName i GaussID

El servei de grups utilitza exclusivament GaussID per identificar membres.

Hi ha una API provisional per convertir de/a GaussID i CommonName, però no forma part de l'API pública i es pot eliminar sense avís previ.

Aplicació de gestió

https://idgrups.upc.edu

API

Podeu veure la definició openapi a https://idgrups.upc.edu/api/META/api i també podeu veure-la amb interfície swagger https://idgrups.upc.edu/apiDefinition .

Per utilitzar la API cal demanar l'accés a eATIC amb les següents dades:

• nomUserApp: common name de l'usuari genèric (d'aplicació) al que es donarà accés a la API
• SUB: idGauss de l'usuari genèric
• nomApp: client id de l'aplicació, groups-api o groups-pro-api
• clau pública RSA: cal adjuntar la clau pública RSA (per exemple clau_grups_rsa.pub) generada amb la comanda ssh-keygen -f clau_grups_rsa, per poder fer login via SFTP al servidor vault.upcnet.es sense haver d'usar credencials 
• adreça IP: del servidor que es connectarà al vault.upcnet.es

Una vegada eATIC hagi tramitat l'alta, disposareu d'un JWT amb dos noms diferents (un inclou la data de caducitat) us podreu descarregar el JWT generat connectant al vault des del servidor especificat:

$ sftp -i clau_grups_rsa nomUserApp@vault.upcnet.es

sftp> cd ssojwt

sftp> ls -altr *.jwt
sftp> get nomUserApp_nomApp_entornSSO.jwt

 Podeu utilitzar el token JWT amb l'autenticació de tipus Bearer, per exemple:

$ curl https://idgrups.upc.edu/api/groups -H 'Authorization: Bearer eyJ...'

Delegació i accés

La gestió dels grups es delega a les Unitats Tècniques de Gestió mitjançant un grup de mànagers i un grup univers. Si la delegació encara no està creada cal sol·licitar-ho via tiquet a eATIC.

Grups Institucionals

Es generen diàriament els següents grups institucionals amb vinculacions actives:

Exemples:

Grups Google

Es generen diàriament els següents grups de google d'Unitats Docents per quadrimestre: