Xledger Setup

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 replacing xledger-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 replacing xledger-cert.pfx with the name of the created certificate from the previous step.
  • 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.