Difference between revisions of "OFTP2 - John Deere"

From OS4X
Jump to navigation Jump to search
(Created page with "= Background = John Deere uses for its OFTP2 file exchange service different certificates for TLS and OFTP2 internal security (secure authentification, file encryption and fil...")
 
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
= 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 =
 
= 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:
 
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:
  
[[]]
+
[[File:Google ChromeScreenSnapz468.png]]
 +
 
 +
= 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:
 +
 
 +
[[File:Google ChromeScreenSnapz469.png]]
 +
 
 +
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:
 +
 
 +
[[File:Google ChromeScreenSnapz470.png]]
 +
 
 +
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:

Google ChromeScreenSnapz468.png

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:

Google ChromeScreenSnapz469.png

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:

Google ChromeScreenSnapz470.png

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.