Merge branch 'dvo0012-dice-irods' into 'master'

new file about how to connect to irods

See merge request !369

docs.it4i/dice.md

+## What is DICE Project?
+DICE (Developing Innovation and Creativity in Education) is an international project co-funded by the Erasmus+ Programme of the European Union.
+
+Its main goals are related to fostering innovation and creativity in education.
+
+This project attempts to be a leading initiative that supports educational community to make progress in the field of innovation and creativity through effective, authentic, practical, sustainable actions.
+This project has been funded with support from the European Commission. This website reflects the views only of the partnership as authors, and the Commission cannot be held responsible for any use which may be made of the information contained therein.
+source http://www.diceproject.eu/
+
+**It4Innovations participating in DICE. DICE using iRods software**
+
+The integrated Rule-Oriented Data System (iRODS) is open source data management software used by research organizations and government agencies worldwide. iRODS is released as a production-level distribution aimed at deployment in mission critical environments. It virtualizes data storage resources, so users can take control of their data, regardless of where and on what device the data is stored. As data volumes grow and data services become more complex, iRODS is serving an increasingly important role in data management.
+source https://irods.org/
+
+## iRods Client
+
+iRods client is what you - user - need to install to your system
+
+**Prerequisities:**
+- MyAccessId > B2Access identity https://b2access.eudat.eu/  
+- we tested client installation on Centos 7
+- it runs in terminal, basic knowledge is essential
+
+
+### Installation of client to your local or vm.
+```
+wget https://packages.irods.org/irods-signing-key.asc
+wget -qO - https://packages.irods.org/renci-irods.yum.repo | sudo tee /etc/yum.repos.d/renci-irods.yum.repo
+yum install epel-release -y
+yum install irods-icommands-4.2.10* -y
+mkdir /root/.irods/
+wget https://github.com/Cotagge/irods_addons_rpms/raw/main/irods-auth-plugin-openid-2.2.1-1.x86_64.rpm
+yum install irods-auth-plugin-openid-2.2.1-1.x86_64.rpm
+```
+
+Copy&paste + edit irods_user_name
+```
+[root@icommands ~]# cat .irods/irods_environment.json 
+{
+    "irods_host": "irods.it4i.cz",
+    "irods_port": 1247,
+    "irods_zone_name": "IT4I",
+    "irods_user_name": "b2access_username",
+    "irods_authentication_scheme": "openid",
+    "openid_provider": "keycloak_openid",
+    "irods_ssl_verify_server": "cert"
+}
+```
+```
+[root@icommand .irods]# pwd
+/root/.irods
+[root@icommand .irods]# ls -la
+total 16
+drwx------. 2 root root 136 Sep 29 08:53 .
+dr-xr-x---. 6 root root 206 Sep 29 08:53 ..
+-rw-r--r--. 1 root root 253 Sep 29 08:14 irods_environment.json
+```
+
+How to start:
+
+step 1:
+```
+[root@icommand .irods]# iinit
+```
+
+step 2:
+
+copy the link (second one) which you got from terminal to the browser or just ctrl+left_mousebutton
+
+example:
+
+https://keycloak-dev.it4i.cz:8443/auth/realms/IT4i_AAI/protocol/openid-connect/auth?nonce=1cc259e35a0043fb871abb79185d6d838d2b99060baa5bf635515181df9c942b&state=701842d9867655918ca165f6d7635a155723afb4d37afff0cf550e77114bc519&redirect_uri=https://irods-api.it4i.cz:8443/authcallback&client_id=IT4I_IRODS_AUTH&&scope=openid&response_type=code&access_type=offline&prompt=login%20consent
+
+click to B2ACCESS atorization and continue autentication flow
+
+you have to see this output `Successfully authenticated user. The browser tab can be safely closed.` in browser
+current problem is: - after validating authorization token, it becomes passed and any new command, such as ils creates new authorization at keycloak.