Difference between revisions of "OFTP2 - John Deere"
(2 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
= Version history = | = Version history = | ||
*2018-02-18: First writing of this document | *2018-02-18: First writing of this document | ||
+ | *2021-08-11: Updated to latest version | ||
This document refers to information received from our customers. The mentioned certificate is valid since 1st of March 2017 and will expire at 19th of April 2019. | This document refers to information received from our customers. The mentioned certificate is valid since 1st of March 2017 and will expire at 19th of April 2019. | ||
Line 10: | Line 11: | ||
= Identify the correct certificate = | = Identify the correct certificate = | ||
You must have received the certificate from John Deere via another medium, such as email. A known package is the file | You must have received the certificate from John Deere via another medium, such as email. A known package is the file | ||
− | + | JOHNDEEREOFTP-230421-ZIP.zip | |
Which contains the following files: | Which contains the following files: | ||
− | + | John_Deere_new_certificate_13_04_2021.txt | |
JohnDeere-Parameter.txt | JohnDeere-Parameter.txt | ||
− | ''' | + | '''JohnDeere230421.cer''' |
ODETTE Root.cer | ODETTE Root.cer | ||
ODETTESHA2IssuingCA.cer | ODETTESHA2IssuingCA.cer | ||
− | The certificate file " | + | The certificate file "JohnDeere230421.cer" is what you need, since this is the end-certificate of the whole chain. |
= Configure certificate at partner = | = Configure certificate at partner = | ||
Line 27: | Line 28: | ||
Select "AES256 SHA1" as cipher suite for all services. Afterwards, activate the following services: | Select "AES256 SHA1" as cipher suite for all services. Afterwards, activate the following services: | ||
*Enable file signing | *Enable file signing | ||
− | *Enable | + | *Enable file encryption |
*Enable secure authentification | *Enable secure authentification | ||
Line 34: | Line 35: | ||
[[File:Google ChromeScreenSnapz470.png]] | [[File:Google ChromeScreenSnapz470.png]] | ||
− | Click on the button "Upload certificate" and select the identified certificate file " | + | Click on the button "Upload certificate" and select the identified certificate file "JohnDeere230421.cer". Afterwards, everything is configured well and your OFTP2 configuration is waiting for a first transmission test. |
+ | |||
+ | [[Category:Best practice]] |
Latest revision as of 11:26, 11 August 2021
Version history
- 2018-02-18: First writing of this document
- 2021-08-11: Updated to latest version
This document refers to information received from our customers. The mentioned certificate is valid since 1st of March 2017 and will expire at 19th of April 2019.
Background
John Deere uses for its OFTP2 file exchange service different certificates for TLS and OFTP2 internal security (secure authentification, file encryption and file signing). This way, you cannot use the easy-to-use-mechanism of downloading the certificate from the TLS server for all services. Starting with OS4X 2018-02-19, the following error message will appear when you try to do so:
Identify the correct certificate
You must have received the certificate from John Deere via another medium, such as email. A known package is the file
JOHNDEEREOFTP-230421-ZIP.zip
Which contains the following files:
John_Deere_new_certificate_13_04_2021.txt JohnDeere-Parameter.txt JohnDeere230421.cer ODETTE Root.cer ODETTESHA2IssuingCA.cer
The certificate file "JohnDeere230421.cer" is what you need, since this is the end-certificate of the whole chain.
Configure certificate at partner
When editing the partner, click on "Configure" beside the "OFTP2" protocol setting:
Select "AES256 SHA1" as cipher suite for all services. Afterwards, activate the following services:
- Enable file signing
- Enable file encryption
- Enable secure authentification
The field at the right of the checkboxes displays that certificate information are missing:
Click on the button "Upload certificate" and select the identified certificate file "JohnDeere230421.cer". Afterwards, everything is configured well and your OFTP2 configuration is waiting for a first transmission test.