What is esgf-getCredentials?

Getting started

Pre-requisites

JDK 6 or OpenJDK 6 and upper versions

Download and installation

A) Download the jar -> getESGFCredentials-0.0.2.jar new
Other versions..

B) Go to download target directory:

• In Windows:
  • Open getESGFCredentials-0.0.2.jar
• In Linux
  • In shell:

       java -jar getESGFCredentials-0.0.2.jar
    

User's Manual

NETCDF DAP case

esgf-getcredentials -o <openid> -p <password> --credentials --trustroots --cacertpem

GUI interface

Setting user

You can select your IdP provider in the top drop-down list

If your IdP provider isn't in the list of providers. Select "Custom OpenID URL", with this option the GUI interface change to be able write OpenID URL's[BR?

Setting output files

You can select in "Generate" section what output files will be generated in the output folder.

credentials.pem	It's a pem file that contains the x509 user certificate and the RSA private key
keystore (JKS type)	It's a keystore in format JKS which is build with x509 certificates, RSA keys and CA's certificates
keystore (JCEKS type)	It's a keystore in format JCEKS which is build with x509 certificates, RSA keys and CA's certificates
esgf-truststore	It's a keystore in format JKS which is build with CA's certificates
certificates	It's a directory with CA's certificate files and policy files
ca-certs.pem	It's a pem file with all CA's certificates

Advanced options

1.You can select the myproxy client library in the "Select Lib" section

• MyProxyLogon lib v1.0
• MyProxy lib v2.0.6

2. You can bootstrap the certificates. For that, select the check box "bootstrap certificates" in "Select Lib" section

3. You can change the output folder. The default is $USER_HOME/.esg
   

Retrieve credentials

Click on "retrieve credentials" button. If all goes well a success message is shown. However, if some error happens then the error is showed in the box bellow

Developers Guide

Github

​https://github.com/SantanderMetGroup/esgf-getcredentials

Architecture