Xledger
Partner 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
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.
Open the newly created
xledger-cert.pem
into a text editor of your liking. Copy all the text displayed.
Cyclr Setup
Setup your Xledger App within Cyclr:
Go to your Cyclr Console
Click the Connectors menu along the top
Choose Connector Library
Scroll down to Xledger
Click the Setup button
Enter the following values:
User Name: The username of your Xledger account.
Password: The password of your Xledger account.
Client Certificate: This is the certificate that you copied down in the last step of the "Converging Certificate" instructions above.
Your Xledger Connector is now setup! You can test it by installing it in one of your Cyclr accounts and executing one of the methods to confirm it can return some data.