Overview
This page provides explanation on how to start using the programming interface of the Quantum Dice QEaaS API.
Prerequisites
You will need the following:
- Host: This can be either of the following.
- A Linux machine with development tools to build C++ programs to run the C++ client demo
- Any other machine with python3 to run the python demo
- The openssl command or an alternative tool for generating keys and certificate signing requests
- The client software qdicerem.tgz . Download here
- The address and port for the server qeaas.q-dice.com 20804
- The server root certificate (included in qdicerem.tgz)
- Your certificate and corresponding key, see Getting a client certificate for more information on this
Getting a client certificate
In summary, if you are the randomness administrator (randomadmin) for Zeffereor Inc (an imaginary company), run these commands to generate a key and a certificate signing request
Generate key
openssl genrsa -out zeffereor.key 4096
Generate certificate signing request
openssl req -new -key zeffereor.key -out zeffereor.csr -subj "/C=UK/O=Zeffereor/OU=ITdept/CN=Randomness" -addext "subjectAltName=email:randomadmin@zeffereor.com"
- Send the signing request ( the
zeffereor.csr
file ) to Quantum Dice who will create your client certificate chain zeffereor_chain.pem
and send it to you.
See Details on generating client certificate for more details on how to generate a key and get a certificate.
- Note
- It is best practice to ensure that the key never leaves the machine where it is generated.
Next steps