1. Incorporar-se a AgrospAI
Aquesta guia detalla els passos per disposar de les credencials necessàries per participar en AgrospAI.
Introducció
L'espai de dades d'AgrospAI es basa en l'ecosistema Pontus-X i en alguns dels serveis del Marc de Confiança Gaia-X. A les següents subseccions es detalla com es pot utilitzar l'espai de dades.
Obtenir credencial de participant
Inicialment, la participació en l'espai de dades AgrospAI es basarà en un enfocament gestionat, seguint el model inicial de governança en què el promotor del demostrador serà el responsable de la gestió de l'espai de dades i generarà tant les credencials com les claus privades dels participants. La Universitat de Lleida, com a promotora d'AgrospAI, es farà càrrec de la publicació de les credencials signades i proporcionarà als participants les seves claus privades perquè puguin interactuar amb l'espai de dades. També mantindrà una còpia de les claus privades en custòdia per facilitar el suport als participants i en cas d'emergència, si per exemple el participant perd la seva clau privada.
Més endavant, un cop que els participants es familiaritzin amb l'espai de dades d'AgrospAI, aquests poden optar per un enfocament d'auto-sobirania, en què generen la seva pròpia clau privada segons les instruccions de la documentació de l'ecosistema Pontus-X. És important tenir en compte que, en aquest cas, els participants seran totalment responsables de la seva clau privada. Això inclou assegurar-se que no es perdi ni es filtiri, mantenir còpies de seguretat segures i assumir tota la responsabilitat de les seves interaccions amb l'espai de dades.
Per completar l'obtenció de les credencials, i segons ho requereixen tant l'ecosistema Pontus-X com Gaia-X, tots els participants han de proporcionar els següents detalls sobre la seva organització. Les interaccions amb l'espai es fan en representació de les organitzacions participants i no a títol personal. Es tracta, per tant, d'informació sobre l'entitat jurídica corresponent, en cap cas es recolliran ni es registraran dades personals.
La Informació requerida a qualsevol entitat legal per participar en AgrospAI, alineada amb els requisits establerts pel Marc de Confiança de Gaia-X per a la descripció de participants inclou:
- Nom: nom curt.
- URL: adreça Web principal de la persona jurídica.
- Nom legal: el registrat oficialment.
- Número de registre legal: per als participants de la UE es recomana el número del NIF o VAT, que es pot verificar en línia. Altres alternatives són EUID, EORI o LEI.
- Codi de subdivisió de país: basat en la norma ISO 3166-2, que combina el codi de país i un codi de subdivisió que varia a cada país.
- Domicili legal: carrer, codi postal i localitat.
Exemple:
- Nom: UdL
- Direcció URL: https://www.udl.cat
- Denominació legal: Universitat de Lleida
- NIF: ESQ7550001G
- Codi de subdivisió del país: ES-L
- Domicili legal:
- Adreça: Víctor Siurana, 1
- Codi postal: 25003
- Localitat: Lleida
El promotor de l'espai de dades registrarà aquesta informació a través dels canals establerts en l'ecosistema Pontus-X, com a pas necessari perquè el participant pugui operar en l'ecosistema. A més, oferirà als participants l'opció de generar i emmagatzemar les seves Credencials Verificables de Participant Gaia-X basades en la informació prèvia. Alternativament, es proporcionaran instruccions detallades i exemples de codi font als participants perquè puguin generar, signar digitalment i emmagatzemar les seves pròpies credencials de forma autosoberana.
Exemples de credencials per a alguns dels participants d'AgrospAI:
- Presentació verificable de les credencials Gaia-X de la Universitat de Lleida, que inclouen la credencial de Participant Legal, la credencial de Número de Registre Legal i la credencial de Termes i Condicions de Gaia-X: https://compliance.portal.agrospai.udl.cat/.well-known/UdL.vp.json
Les credencials anteriors es poden validar utilitzant el servei Gaia-X Digital Clearing House (GXDCH), per exemple, la variant d'staging de la versió 1 de GCDCH: https://compliance.lab.gaia-x.eu/v1-staging/docs
Configuració de la cartera digital
Pel que fa a l'ús de la clau privada per a la interacció amb l'espai de dades, tant si la clau és generada de forma autònoma pel participant com proporcionada pel promotor de l'espai de dades, es requereix la configuració d'una cartera digital.
La recomanació per a la configuració i ús d'una cartera és utilitzar l'extensió de navegador MetaMask. Aquesta extensió està disponible per a iOS, Android i diferents navegadors d'ordinadors de sobretaula, com es mostra a Fig. 1. Es pot descarregar des de https://metamask.io/download/ i llavors seguir les instruccions per a la seva instal·lació.
Fig. 1. Pàgina de descàrrega de MetaMask (font: https://metamask.io/download/)
Un cop que s'hagi instal·lat i configurat l'extensió MetaMask, creant una nova cartera i protegint-la amb contrasenya, es podrà importar la clau privada proporcionada pel promotor de l'espai de dades. La clau privada se li proporcionarà com un fitxer de tipus JSON (amb extensió “.json”) juntament amb una contrasenya amb la qual la clau privada està protegida.
Per importar la clau privada, seguiu les instruccions detallades a: https://support.metamask.io/es/start/how-to-import-an-account/#importing-using-a-json-file
A partir d'aquest moment, podrà interactuar amb l'espai de dades més enllà de la simple exploració del catàleg. Això inclou el consum de conjunts de dades i serveis existents o la posada a disposició de nous conjunts de dades i serveis a través de l'espai de dades, com es detalla a les següents subseccions.
En cas de voler utilitzar una de les generades de manera autònoma pel participant, la corresponent clau pública s'haurà de comunicar al promotor perquè s'autoritzi el seu ús i quedi associada a les credencials del participant.