Evopos Help - 2.09.068

Xero - Private App

Xero - Private App

Previous topic Next topic  

Xero - Private App

Previous topic Next topic JavaScript is required for the print function  

If you setup the Integration as a Public application, it is easier to set up, but you will have to enter the Authorisation code each time.

If you setup or change the Integration to a Private application, you will need to generate a Self-signed Certificate (X509) and enter the Code and Passcode into Evopos.

 

Install OpenSSL

You can download OpenSSL for Windows at Shining Light Productions OpenSSL.

To run the commands below, go to the OpenSSL32 directory on your PS, and then change to the /bin directory.

Note:

You may need to open the command prompt with elevated status (Run as administrator)

If the OpenSSL was just recently installed, you might need to restart the computer

 

Run OpenSSL to create the Certificate / Keys

Using OpenSSL

Use a command line prompt and enter the following commands to generate a private and public key pair.

1. The following command will generate a private key file named “privatekey.pem” in the current directory

openssl genrsa -out privatekey.pem 1024

2. This command uses the previously created private key file to create a public certificate to be used when setting up your private application in the next step. You will be asked to provide 7 pieces of information about your company that will be included in the certificate file: Country Name (2 letter code), State or Province Name (Full name), Locality (eg city), Organization Name (eg, company), Organizational Unit Name (eg, section), Common Name (eg, Your name), Email Address. Days is set to 1825 (5 years) so this step doesn’t have to be replaced every year.

openssl req -newkey rsa:1024 -x509 -key privatekey.pem -out publickey.cer -days 1825

3. To verify the files were created correctly, verify the first line of each file.

The private key will begin with the following line:

-----BEGIN RSA PRIVATE KEY-----

The public certificate will begin with the following line:

-----BEGIN CERTIFICATE-----

 

Setup Up A Private Application in Xero

Log in to your Xero account at: http://login.xero.com

Once logged in, go to the API area at: http://api.xero.com

Land on a page titled “Xero Developer Centre”

Verify your name is in the top right corner of the page

Click the “My Applications” tab

Click the “Add Application” button

Fill out the form with the following options:

What type of application are you developing? Select “Private”

Application Name: Enter Evopos.

Please select which organisation your application can access: Select which Xero company to access. The extension can only access one company at a time.

X509 Public Key Certificate: Paste the certificate file you created in Step 1. above. Note: Certificate files begin with the text “—–BEGIN CERTIFICATE—–“

Press Save and you will be taken to the Edit Application page with the note “Application Added”

The Edit Application page will have a box titled “OAuth Credentials” showing the “Consumer Key” and the “Consumer Secret”. These will be used in the next step – Entering the details in Evopos

 

 

Enter the details in Evopos

Start Evopos, select Settings from the top menu, select Integrations from the top row of tabs, and select the Xero integration