Retrieving Certificate
- Download the Certificate Manager from the Microsoft Store.
- Click “Get New Certificate”.
- Fill in your username and password, and then click “Get Security Code” and check your emails for said security code.
- Enter the security code, enable “Exportable”, and then click “Get Certificate”.
- You have now created a new Xledger certificate. You can access it by navigating to “certmgr” by typing “Manage user certificates” into the Windows search bar.
- Under “Personal” > “Certificates”, you should see a certificate issued by “http://XLEDGER.NET”.
- Double click on it, go to the “Details” tab, and then click “Copy to File”.
- Go through the stages until you hit “Export Private Key”. Select “Yes, export the private key”.
- Continue through the stages until you land on “Security”. Tick “Password” and enter an appropriate password.
- Enter a valid file name and location in the next screen, and then finish the wizard.
- You have successfully saved your Xledger certificate to a file. You will now need to convert it to a valid format that Cyclr can use.
Converting Certificate
- If you are using a Windows system:
- You will need to install OpenSSL.
- Once installed, open a new Powershell window in the folder that contains the certificate. Type
openssl.exe pkcs12 -in xledger-cert.pfx -out xledger-cert.pem -nodes
replacingxledger-cert.pfx
with the name of the created certificate from the previous step.
- If you are using a Linux system:
- You may already have OpenSSL installed, depending on your distribution. Type
openssl version
into a terminal to see if you have it installed. - Once installed/verified, type
openssl pkcs12 -in xledger-cert.pfx -out xledger-cert.pem -nodes
replacingxledger-cert.pfx
with the name of the created certificate from the previous step.
- You may already have OpenSSL installed, depending on your distribution. Type
- Open the newly created
xledger-cert.pem
into a text editor of your liking. Copy all the text displayed.
Cyclr Connector Installation
When installing an Xledger Connector, the following values are used:
- Client Certificate: this is the certificate copied in the “Retrieving Certificate” section above.
- User Name: the Xledger user to authenticate as.
- Password: that user’s password.