’s New Trading System F7 Eurex Repo Release 1.0
Transcription
’s New Trading System F7 Eurex Repo Release 1.0
Eurex Repo’s New Trading System F7 Release 1.0 F7 Connectivity Guide Version V 1.0.8 Date 18 November 2014 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 1. Introduction 4 2. Network 5 2.1 Repo Connectivity 5 2.1.1 Leased Line 6 2.1.2 Internet 7 2.2 Eurex Repo connectivity security features 7 2.3 URLs and IP ranges 8 2.3.1 F7 GUI 8 2.3.2 F7 API 8 3. Member Section 9 4. Leased line connectivity ordering 10 4.1 New connection 10 4.2 Location details 11 4.3 Connection type 12 4.4 Data center details 13 4.5 Request summary 14 5. Eurex Repo F7 x.509 certificates 16 5.1 x.509 Certificate creation with OpenSSL 16 5.1.1 Step 1: Download OpenSSL 17 5.1.2 Step 2: Create Private Key 17 5.1.3 Step 3: Create self-signed certificate 17 5.1.4 Step 4 create PKCS#12 file 20 5.1.5 Step 5: Upload certificate 20 5.2 x.509 Certificate creation with Java keytool 20 5.2.1 Create keystore 21 5.2.2 Create truststore 22 5.2.3 Export certificate for upload 22 5.2.4 Import AMQP server certificate (F7 API only) 23 5.2.5 Client PKCS#12 certificate for installation into the F7 GUI user’s browser 23 5.3 Certificate validity period 24 5.4 Eurex Repo certificate upload 24 5.5 User ID Configuration 25 5.6 Environment 26 2 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 5.7 Account Name Field 26 5.8 ‘Description’ field 27 5.9 Certificate upload verification 27 5.10 Username and password authentication 28 5.11 Additional IP Address check (Internet access) 28 6. Further information and contacts 29 7. Change Log 30 3 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 1. Introduction Eurex Repo is continuously extending its product scope, functionality and markets to improve its services and to attract additional customer groups. In 2014 Eurex Repo will go a considerable step further by introducing a new web based trading system to embrace the requirements of a state-of-the-art trading environment. This new trading system called F7 will serve as a solid foundation for future growth and has been designed to meet the highest demands. Today’s global markets demand new standards of flexibility and performance. The 7 Market Technology series from Deutsche Börse Group offers a range of innovations in trading, clearing, risk management and connectivity – advanced infrastructure that lets you adapt to whatever the future brings. This document describes the connectivity options and the ordering and setup process for Eurex Repo’s new trading system F7. It considers Eurex Repo participants who are new to the order process at Deutsche Börse but is also valid for Eurex Repo participants which already have Deutsche Börse infrastructure (for example existing Eurex participants which want to order additional Eurex Repo connectivity). 4 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 2. Network In order to support the respective Eurex Repo’s F7 services, Deutsche Börse Group has established an efficient infrastructure representing a dedicated global IP network. Access from a participant location to Eurex Repo’s F7 must always be established via the Deutsche Börse Group's IP network or alternatively via the Internet. Any participant connection to the back end systems must be established via Access Points (AP). APs, to which leased lines connect, are located throughout the world in major financial centers where Eurex Repo’s participants are concentrated. This concept allows Eurex Repo to extend its private network up to the demarcation point of the carrier at the participant’s site. Each AP is connected to the respective hosts via redundant leased lines. Participants are connected to an AP via dedicated leased lines and/or via the Internet. 2.1 Repo Connectivity Eurex Repo’s F7 system minimizes the footprint on the participant’s infrastructure. F7 removes the local Service Connector from the client and implements a browser based GUI solution which requires zero maintenance by the Eurex Repo participant. Eurex Repo’s F7 new connectivity concept Both, the browser based GUI and the F7 API can connect to Eurex Repo’s F7 system either via leased line or via Internet. 5 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 In either case a client authentication will be done by using x.509 certificates. The certificate will be used to encrypt all data transmitted between the browser based GUI or any third party application. F7 GUI or 3rd party POA Internet Eurex Repo’s F7 Back End Eurex Repo’s F7 connect server Authenticate with x509 certificate F7 GUI or 3rd party POA Leased Line Connectivity options 2.1.1 Leased Line All leased line connections must be ordered from Deutsche Börse – directly or via a technical service provider. The Deutsche Börse network is a highly efficient network focused on highest availability by simultaneously providing lowest latency. Eurex Repo’s F7 Trading participants who already have existing Deutsche Börse network connectivity in place will be able to order a dedicated channel, providing that sufficient bandwidth is available. As the new system connects each individual user of Eurex Repo’s F7 system directly to the trading platform, bandwidth requirements are directly proportional to the number of active users. Bandwidth consumption per active trader is expected to be around 0.420 Mbit/s. Bandwidth options will be offered in the following sizes: Number of active users Bandwidth Option 1 0.5 Mbit/s Up to 2 1.0 Mbit/s Up to 6 3.0 Mbit/s Up to 12 5.0 Mbit/s Up to 25 10.0 Mbit/s Eurex Repo’s F7 bandwidth options for leased lines 6 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 The previously used software VPN encryption will no longer be required as all traffic will be secured by use of x.509 certificates for authentication and encryption. 2.1.2 Internet It will be possible to use the new F7 trading GUI as well as the F7 API via the Internet. The previously used software VPN encryption will no longer be required as all traffic will be secured by use of x.509 certificates for basic authentication and connection encryption. As the new system connects each individual user of Eurex Repo’s F7 system directly to the trading platform, bandwidth requirements are directly proportional to the number of active users. Users connecting via Internet should expect 0.420 Mbit/s bandwidth consumption per active trader 2.2 Eurex Repo connectivity security features For the connection via Internet, the Repo participant can choose one of the following options: Allow Internet access without restrictions (per default) Completely disable Internet access and restricting to leased line (x.509 upload page) Allow Internet access for registered IP addresses For the connection via leased line, the incoming IP address is checked against the known network information for the corresponding Eurex Repo participant. In case a participant has a Service Provider, the IP address is also checked against the known networks of the Service Provider. On login via leased line it is checked if the IP-address of the user is part of the corresponding network. 7 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 2.3 URLs and IP ranges 2.3.1 F7 GUI The Eurex Repo’s F7 GUI can be accessed via links or URLs. These URLs differ based on the type of connection (Leased line vs. Internet) and based on the environment (Production vs. Simulation). Any of these four URLs can be placed in the bookmarks of the user’s browser, or placed as links on the desktop. Environment Type URL Leased Line https://simulation.vpn.eurexrepo.com:9443/TRADING_GUI IP: 193.29.95.215:9443/TRADING_GUI https://simulation.eurexrepo.com:9443/TRADING_GUI IP: 193.29.90.164:9443/TRADING_GUI https://production.vpn.eurexrepo.com:8443/TRADING_GUI IP: 193.29.95.216:8443/TRADING_GUI https://production.eurexrepo.com:8443/TRADING_GUI IP: 193.29.90.165:8443/TRADING_GUI Simulation Internet Leased Line Production Internet 2.3.2 F7 API The F7 API connection gateways are accessed via direct IP addresses. These IP addresses differ based on the type of connection (Leased line vs. Internet) and based on the environment (Production vs. Simulation). Environment Simulation Production Port Type IP Address Leased Line 193.29.95.217 / 255.255.255.240 11575 Internet 193.29.90.166 / 255.255.255.240 11575 Leased Line 193.29.95.218 / 255.255.255.240 11475 Internet 193.29.90.167 / 255.255.255.240 11475 8 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 3. Member Section The Eurex Repo member section can be entered via this web address: https://member.eurexrepo.com It is also accessible from the Eurex Trading, Eurex Clearing and Xetra member section by using the switch portal link at the top of the page. This will lead you to the welcome page of the Eurex Repo member section. 9 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 4. Leased line connectivity ordering In order to start the order process press “Technical Connection” and select “Requests & Configuration” on the left hand side of the page. An overview of your installations and their respective configuration will be displayed. 4.1 New connection Select the tab “New Request” and then press “New Connection” You have now entered the line order frame. Use the “Dedicated Leased Line Connections” tick mark for Eurex Repo leased line orders. 10 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 This is also true if you already have a dedicated line where additional space for Eurex Repo is available. The next step is the location selection and the selection of the person who is the “Line Responsible”. 4.2 Location details For the location you can select an existing location or create a new location. The new location creation is self-explanatory. 11 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 In order to select the “Line Responsible” you have to press “Select”. A new pop up window will show the persons who are already registered for your company and allows to edit them or to create a new contact. Please note that the “Line Responsible” should be a person who always has immediate access to the location where the line will be delivered. This is the person who will be contacted by the carrier. Here you can also use the tick box at the bottom of the frame in order to choose a second location with another “Line Responsible”. 4.3 Connection type The next step is to select the connection (type). For Eurex Repo you can choose one channel on a leased line or two channels on two leased lines (for highest reliability). Please tick the appropriate box in order to achieve this. 12 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 In the lower half of the screen, under “Market/Channels” you have to choose “Eurex Repo” by scrolling down and selecting the tick box, then choose the participant ID (“Member ID”) used for this Eurex Repo connection, the bandwidth and finally the Base Installation in which this line should be placed. For a new installation select “New Base”. 4.4 Data center details The next step is important when a new physical line has to be delivered. In order to achieve a smooth handling by all involved parties, room and line details have to be specified. 13 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 Room description, floor, room number, media, interface are mandatory fields. It has to be specified if a line installation can be done within business hours or not, whether the router and end facility are located in the same room or not and if it is Rackmountable or a Desktop (stand-alone) device. If this is a new location, a new room can be created; else an existing room can be used. In the case that you have ordered two lines into two different locations (split location) also the room in the second location has to be selected or created and specified in an additional step. 4.5 Request summary In the next step an overview of the request is shown. By pressing “Add to the request basket” your request is then placed in the request basket. Please review this page thoroughly and add the overall “Technical Contact” for this request (typically the person who also will perform the connection test). 14 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 It is advisable to use the “Check Request” in order to perform a consistency check of your request. Tick the box in order to agree to the conditions and finally press “Approve” in order to finalize this order. 15 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 5. Eurex Repo F7 x.509 certificates To ensure the highest possible level of security and privacy against eavesdropping, a two-factor authentication is required for every participant. Both parts of the authentication process need to be completed successfully before access to the Eurex Repo GUI is granted or an F7 API application can connect. The two-factor authentication process involves on the one hand the creation and usage of self-signed SSL certificates to establish and ensure an encrypted connection between the Eurex Repo participant and Eurex Repo. Certificate authentication is required for both Internet and Leased Line access. On the other hand every single GUI user has to be authenticated by means of the individual username and password to be able to log into the GUI. Please note: Certificates can have user or participant scope or some other participant specific scope (e.g. location, unit, market etc.). Every participant needs at least one certificate in order to access Eurex Repo but may use an unlimited number for various reasons. In any case the uploaded certificate must match the PKCS#12 file installed in the browser. For a successful upload to the portal, a self-signed SSL certificate (crt.-file) is required which needs to comply with the following parameters: RSA and DSA key algorithms and SHA-2 signature algorithms (e.g. SHA224, SHA256, SHA384, SHA512) are supported Compliant with X.509v3 standard Key length needs to be between 1976 and 4096 bits o Common Name (CN) has to contain complete account name (5-digit participant ID followed by 3 digits “GUI” or “API” depending on the application the certificate will be used for, thereafter a free user defined string from 1 to 13 characters must be used for your internal description. 5.1 x.509 Certificate creation with OpenSSL The following chapter outlines the procedure for creating a self signed x.509 certificate and a PKCS#12 file for installation into a F7 GUI user’s browser using the tool “OpenSSL”. This chapter describes the recommended procedure for F7 GUI users. See next chapter for F7 API users. Please note, in the following examples the following is assumed: You have the OpenSSL binary in your PATH. 16 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 You are in a directory where you have write permissions to create files. The following examples use a participant ID “INTER” – replace this with you own participant ID. Three files will be created: A private key (INTER.key) A self signed certificate for upload to the Eurex Repo Member section (INTER.crt) A private PKCS#12 certificate for installation into the browser of a F7 GUI User (INTER.p12) The following examples show “<passphrase>” where an individual passphrase needs to be entered. ”. Change this to a passphrase of your own choice. 5.1.1 Step 1: Download OpenSSL The Eurex Repo participant has to download and install “OpenSSL” (recommended freeware tool) to create keys, self-signed certificates and PKCS#12 certificate files (recommended source: www.openssl.org, version1.0.0o or 1.0.1j). Avoid 1.0.1 versions up to and including 1.0.1f due to heartbleed blug 5.1.2 Step 2: Create Private Key The participant has to create a private key by using OpenSSL (e.g. RSA private key, 2048 bit). Example command line for the participant ID INTER: openssl genrsa -des3 -out INTER.key 2048 This results in: Generating RSA private key, 2048 bit long modulus .......................................................+++ .......................................................+++ e is 65537 (0x10001) Enter pass phrase for INTER.key:<passphrase> Verifying - Enter pass phrase for INTER.key: <passphrase> After entering the necessary information the private key will be saved automatically in the current working directory. 5.1.3 Step 3: Create self-signed certificate The participant has to create a “self-signed certificate”. 17 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 A “self-signed certificate” can be created by using OpenSSL (.crt-file compliant with X.509v3 standard and a validity of 365 days). For creation the passphrase for the private key created above is required. Example command line for the participant ID INTER: openssl req -new -x509 -sha256 -days 365 -key INTER.key -out INTER.crt This results in: Enter pass phrase for INTER.key: <passphrase> The user is asked to enter the information that will be incorporated into his certificate request (the so-called Distinguished Name or a DN.) There are quite a few fields to be filled in. Some of the fields can be left blank. For some fields there will be a default value. If a user enters '.', the field will be left blank. ----Country Name (2 letter code) [GB]:DE State or Province Name (full name) [Berkshire]:Hessen Locality Name (eg, city) [Newbury]:Frankfurt Organization Name (eg, company) [My Company Ltd]:Int Test GmbH Organizational Unit Name (eg, section) []:Repo Common Name (eg, your name or your server's hostname) []:INTERGUIFRTRD123 E-Mail Address []: It is important that the entered Common Name always consists of the own participant ID, in this example “INTER” followed by “GUI” or “API” depending on the application the certificate will be used for and a free identifying string. o The first 5 digits are your participant ID (“INTER” in this example) o The next 3 digits identify the purpose of the certificate. If the certificate will be used for GUI access “GUI” has to be entered. If the certificate is used to connect to the API “API” has to be entered. o Thereafter a free user defined string from 1 to 13 characters must be used for your internal description. The Common Name must be identical to the free text field of the account name provided during the upload of the self-signed certificate into the member section. After entering the necessary information, the self-signed certificate will be saved automatically in the current working directory. Participant may check the generated “self-signed certificate” by using OpenSSL. Example command line for the participant ID INTER: openssl x509 -text -in INTER.crt -noout 18 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 This results in: Certificate: Data: Version: 3 (0x2) Serial Number: 8e:e3:e3:0b:97:63:7c:3c Signature Algorithm: sha256WithRSAEncryption Issuer: C=DE, ST=Hessen, L=Frankfurt, O=XYT Test GmbH, OU=Repo, CN=INTERGUIFRTRD123 Validity Not Before: Nov 28 16:53:26 2011 GMT Not After : Nov 27 16:53:26 2012 GMT Subject: C=DE, ST=Hessen, L=Frankfurt, O=XYT Test GmbH, OU=Repo, CN=INTERGUIFRTRD123 Subject Public Key Info: Public Key Algorithm: rsaEncryption RSA Public Key: (2048 bit) Modulus (2048 bit): 00:d1:79:44:42:eb:60:26:55:4a:d0:9d:49:25:c3: 44:6f:ea:50:83:1c:91:f1:68:b3:65:01:bc:df:fc: ab:ba:59:a9:ab:4e:82:46:e1:ce:d8:c4:c7:bb:13: 8f:bf:ec:10:16:13:77:96:2f:74:0a:74:83:77:d6: b3:2e:67:e0:5b:9c:1c:69:4c:bf:c2:91:48:34:62: 60:ae:7c:67:63:bb:c8:45:0f:35:42:da:9e:90:a4: fd:7c:5f:76:9d:e7:47:8b:2e:2d:4a:f2:12:f3:92: 04:17:eb:db:10:dd:bb:7c:b8:3b:8c:5c:f5:72:f6: e2:37:ec:0f:9b:bd:45:25:31:1b:be:fa:1c:f0:80: f0:b7:a2:11:f1:e0:20:81:62:d7:da:b5:9b:ab:ad: 61:9e:11:cd:7f:b2:8c:13:64:44:9f:60:dc:b4:0c: a3:de:6a:21:25:7e:7a:b1:7b:4f:fa:e9:42:9c:af: 8a:2d:6e:c7:88:0a:bd:a3:ce:b0:c6:70:e8:7d:2d: 69:3b:93:84:96:26:70:5d:3d:04:50:e9:e2:27:ad: 3a:a3:32:d3:58:09:47:92:32:f2:32:8e:2f:f7:e4: 00:30:61:8c:59:de:a7:81:28:7f:83:17:19:61:2f: 14:d2:94:7c:00:4a:8c:1f:a6:29:52:01:c3:28:d0: 5e:0d Exponent: 65537 (0x10001) X509v3 extensions: X509v3 Subject Key Identifier: 01:51:CD:A2:29:3B:44:58:C4:51:92:F9:A7:52:52:C5:F2:ED:38:62 X509v3 Authority Key Identifier: keyid:01:51:CD:A2:29:3B:44:58:C4:51:92:F9:A7:52:52:C5:F2:ED:38:62 DirName:/C=DE/ST=Hessen/L=Frankfurt/O=XYT Test GmbH/OU=Repo/CN= INTERGUIFRTRD123 serial:8E:E3:E3:0B:97:63:7C:3C X509v3 Basic Constraints: CA:TRUE Signature Algorithm: sha256WithRSAEncryption 36:5c:31:89:75:f1:22:be:02:18:80:9b:4a:56:b4:da:15:a1: 9e:cc:f8:55:b6:4b:39:cf:82:78:b0:c2:75:e5:75:31:21:02: 04:b5:7d:bf:93:ce:13:ef:09:3f:0e:a4:15:d9:dc:99:81:98: 02:53:55:2c:7c:2d:a4:1f:da:cb:00:6f:9e:65:2f:53:a8:a5: c4:b7:66:c2:38:47:e3:e6:45:e7:d9:4b:14:7e:c5:52:14:22: 63:60:4b:73:63:68:60:80:bf:85:c2:aa:21:8e:63:ea:c5:e2: a2:42:a8:67:42:c6:b8:a8:30:01:2e:b0:e6:72:03:e7:c8:a4: 13:81:8f:dc:d1:f3:26:34:41:61:33:3f:db:6b:66:47:bd:27: 19 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 07:c3:f2:b2:16:10:7a:76:06:73:9d:c0:62:c5:35:17:b7:d7: bf:e5:8d:7d:45:4c:7f:50:fe:06:dd:c8:ed:97:2a:51:2d:b8: 51:2e:e9:b0:98:c9:c1:08:e9:92:8b:86:54:17:48:5d:b3:d2: 3c:9e:2e:2c:e5:f2:a0:1d:39:a6:8d:cb:88:e0:6f:bf:7e:df: e8:da:cd:27:c6:b7:60:54:7a:0c:37:5e:73:7f:b9:7d:6c:57: dc:6b:fe:be:a8:07:ab:78:d8:ed:22:cc:e6:eb:56:4c:42:fb: 1d:bf:7d:04 5.1.4 Step 4 create PKCS#12 file The participant creates PKCS#12 file by using the stored private key and the selfsigned certificate (.crt-file) in OpenSSL. Example command line for the participant ID “INTER”: openssl pkcs12 -export -clcerts -in INTER.crt -inkey INTER.key -out INTER.p12 The PKCS#12 file will be saved automatically in the current working directory. Afterwards install the PKCS#12 file in every user’s web browser. Please refer to your individual browser documentation on how to manage browser certificates. For example, for Firefox this information can be found following this link: http://www.mozilla.org/projects/security/pki/psm/help_21/using_certs_help.html#using_certs_my 5.1.5 Step 5: Upload certificate Upload the .cer-file (X.509v3 compliant) into the member section via Internet. See chapter 5.4 for details. 5.2 x.509 Certificate creation with Java keytool The following chapter outlines the procedure for creating a self signed x.509 certificate, the creation of a keystore and a truststore, and finally the import of the F7 API broker certificate into the truststore, using the Java tool “keytool”. Java keytool is part of the standard Java distribution. It is a key and certificate management utility, organizing certificates in keystores and truststores which can then be accessed by Java applications. This chapter describes the recommended procedure for F7 API users using Java applications. Additionally chapter 5.2.5 describes how to extract a browser compatible certificate for GUI usage. Please note, in the following examples the following is assumed: You have the keytool in your PATH. You are in a directory where you have write permissions to create files. The following examples use a participant ID “INTER” – replace this with your own participant ID. 20 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 Four files will be created: A keystore, containing your private key(s) A truststore, containing the public key(s) from other parties (i.e. Eurex Repo) A public certificate for upload to the Eurex Repo Member section A private certificate for installation into the browser of a F7 GUI User The following examples use a participant ID “INTER” – replace this with your own participant ID. The following examples use always a password “mypass”. Change this to a password of your own choice. 5.2.1 Create keystore The first step is to create a F7 certificate and a keystore to store the new certificate in. The command line example below determines the parameters of the certificate (RSA algorithm, key size 2048, one year validity, SHA256 signature and a keystore file name “INTER.ks” and a store password “mypass”): keytool -genkey -keyalg RSA -keysize 2048 -validity 365 -sigalg SHA256withRSA -alias inter -keystore INTER.ks -storepass mypass A number of parameters have to be entered manually What is your first and last name? [Unknown]: INTERAPIFRTRD123 What is the name of your organizational unit? [Unknown]: Repo What is the name of your organization? [Unknown]: Int Test GmbH What is the name of your City or Locality? [Unknown]: Frankfurt What is the name of your State or Province? [Unknown]: Hessen What is the two-letter country code for this unit? [Unknown]: DE Is CN= INTERAPIFRTRD123, OU=Repo, O=Int Test GmbH, L=Frankfurt, ST=Hessen, C=DE correct? [no]: yes It is important that the entered Common Name always consists of the own participant ID, in this example “INTER” followed by “GUI” or “API” depending on the application the certificate will be used for and a free identifying string. o The first 5 digits are your participant ID (“INTER” in this example) 21 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 o The next 3 digits identify the purpose of the certificate. If the certificate will be used for GUI access “GUI” has to be entered. If the certificate is used to connect to the API “API” has to be entered. o Thereafter a free user defined string from 1 to 13 characters must be used for your internal description. The Common Name must be identical to the free text field of the account name provided during the upload of the self-signed certificate into the member section. At this point a keystore file “INTER.ks” has been created, containing one certificate with an alias name “inter” for reference 5.2.2 Create truststore In a second step, the same procedure is repeated to create a truststore file “INTER.ts”: keytool -genkey -keyalg RSA -keysize 2048 -validity 365 -sigalg SHA256withRSA -alias inter -keystore INTER.ts -storepass mypass Again a number of parameters have to be entered manually What is your first and last name? [Unknown]: INTERAPITRDFR123 What is the name of your organizational unit? [Unknown]: Repo What is the name of your organization? [Unknown]: Int Test GmbH What is the name of your City or Locality? [Unknown]: Frankfurt What is the name of your State or Province? [Unknown]: Hessen What is the two-letter country code for this unit? [Unknown]: DE Is CN= INTERAPITRDFR123, OU=Repo, O=Int Test GmbH, L=Frankfurt, ST=Hessen, C=DE correct? [no]: yes 5.2.3 Export certificate for upload Now the certificate for INTER will be extracted from the keystore previously created. Note the option “-rfc” to ensure the output format will be accepted by the member section when uploading the certificate to the Eurex Repo webpage. keytool -export -rfc -alias inter -file INTER.cer -keystore INTER.ks The name of the exported file for upload to the member section is “INTER.cer”. It should look similar to the example output below: 22 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 cat INTER.cer -----BEGIN CERTIFICATE----MIIDaDCCAlCgAwIBAgIEU7ErtzANBgkqhkiG9w0BAQsFADB2MQswCQYDVQQGEwJERTEPMA0GA1UE CBMGSGVzc2VuMRIwEAYDVQQHEwlGcmFua2Z1cnQxGDAWBgNVBAoTD0RldXRzY2hlIEJvZXJzZTEN MAsGA1UECxMEUmVwbzEZMBcGA1UEAxMQUEFLRVJUUkRGUkdVSTEyMzAeFw0xNDA2MzAwOTE5NTFa Fw0xNTA2MzAwOTE5NTFaMHYxCzAJBgNVBAYTAkRFMQ8wDQYDVQQIEwZIZXNzZW4xEjAQBgNVBAcT CUZyYW5rZnVydDEYMBYGA1UEChMPRGV1dHNjaGUgQm9lcnNlMQ0wCwYDVQQLEwRSZXBvMRkwFwYD VQQDExBQQUtFUlRSREZSR1VJMTIzMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvtd2 1RMolLWVmK4H1M/7JKh2R9xP0avqTvKDqlspyNggTFd2JeVV8i0mckkHhR7kddasR0LJ5W5E17en EJ8/dGJFVy/NMZZJLcSIyaaB+7vfW7oaeF3Um502RnoIUFX+wni6qODN4Zz7WmdYGbXVu9HsFkYG tceW5c6pdC3vpGnqsiTt1LrrulibDOEsGx4+YczEpwTrvX0uK7nLmyaudmL18RJfGqondJSsnDCB arqhu7Wa9BAYzjTQjTpfej8Lar4lOW+C8XWxvNlAQOKL4EwYklQcNb4Q6kwr6m+EadkTLucsjnkm mfm5NLaJpR1bXp5wDPY6pdzCtb2yYsBY4QIDAQABMA0GCSqGSIb3DQEBCwUAA4IBAQA9O2CoEzOZ Zsih1sR21U54ne/xwqgBgY89nGdiv9J+H3iIO2+UDTXS+9X1pyK0QYRJ8LnrxzkgfexrzGlIwMCy 7PQNPJWWutglnE9+TiGzWgZOmR5FMwBHulMp9hMn7GBegsOpDL5Hd645S9hjj/P1X6CVZiLPuo03 cv2l+/KRhG7s9gfHR2L5Gas4i9a/2UWa4osOLJM5////vDR77b/p5Rxu0p2c8897wUgVFM4AP0wS q5vXWv5Cfj375RzTDB3VjEEAsiC74GvITYJTJo1aS+WIHWLcHHV+E6PQsYUD7NAWd6GnIw/slau+ KwPrxm+1jyuPp2pdrKIqcqcM+Z Upload the .cer-file (X.509v3 compliant) into the member section via Internet. See chapter 5.4 for details. 5.2.4 Import AMQP server certificate (F7 API only) In case the keystore / truststore is used for the F7 API the AMQP server/broker certificate by Eurex Repo needs to be imported into the truststore. The server/broker certificate of Eurex Repo F7 API can be downloaded in the Eurex Repo Member Section > Repo Resources > Trading System T7 > System Documentation > Relase 1.0 > Eurex Repo Trading Interfaces. Assuming the AMQP server/broker certificate by Eurex Repo is stored in a file “Broker.crt” it can be imported in the previously created truststore (INTER.ts) by the following command: keytool -import -file Broker.crt -keystore INTER.ts -storepass mypass -alias f7apiserver 5.2.5 Client PKCS#12 certificate for installation into the F7 GUI user’s browser The following command exports the certificate in a format which can be imported into the browser of a F7 GUI user: keytool -importkeystore -srckeystore N:\INTER.ks -destkeystore N:\INTER.p12 -deststoretype PKCS12 Enter destination keystore password: mypass Re-enter new password: mypass 23 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 Enter source keystore password: mypass Entry for alias inter successfully imported. Import command completed: failed or cancelled 1 entries successfully imported, 0 entries Please refer to your individual browser documentation on how to manage browser certificates. By following the steps in the chapters 5.2.1 to 5.2.5 four files have been created: INTER.ks INTER.ts INTER.cer INTER.p12 # # # # Keystore Truststore Cert for Upload Cert for Browser 5.3 Certificate validity period To ensure security we recommend a validity period of 365 days for certificates. The upload of a new certificate in good time prior to the end of the validity period will be required. Please note: the Eurex Repo system is not actively informing users about approaching certificate expiry dates. 5.4 Eurex Repo certificate upload For a secure connection to the Eurex Repo F7 GUI or API the participant has to upload a self-signed certificate file to the member section, while additionally installing the complementary browser certificate file (in the format ‘PKCS#12’) in his webbrowser. For uploading a certificate navigate to the Eurex Repo member section, select “Technical Connection” and then “Eurex Repo Certificates” under the menu “Technical User Administration”: 24 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 5.5 User ID Configuration The setup of an account (by clicking on ‘Create user’) is required to assign a participant ID (given in the ‘Account Name’, e.g. INTER) and an environment (e.g. Simulation or Production) to a certificate to be uploaded. By using participant-based certificates every participant has to create only one single account associated with one single certificate in the member section. With this account and the additional installation of the certificate in the web-browser of each individual user, all the Eurex Repo F7 GUI or API users of a participant can access and use the Eurex Repo F7 GUI or third party application after entering their individual username and password. Please note that the member section is only used for the certificate handling for a participant. All individual Eurex Repo F7 GUI users not yet set-up in the current system of a participant need to be setup separately by submitting a ‘User Setup Form’ (“Händler Antrag” / “Info User Antrag”) to Eurex Repo and will be provided via email with their individual username and password, which is needed to login to the Eurex Repo F7 GUI or a third party application. Please note that for the setup and usage of the Eurex Repo F7 GUI or third party software in a new environment (e.g. Simulation or Production) a new certificate has 25 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 to be created and uploaded. A separate certificate should be used for the Eurex Repo API connection. 5.6 Environment Select the environment the new certificate will be used in: production or simulation. 5.7 Account Name Field The Account Name consists of a drop-down list and a free text field. In a first step the participant ID needs to be selected from the drop-down list. All participant IDs, for which an account can be setup, are selectable here (e.g. INTER). In the free text field a 1 to 16 digit uppercase alphanumeric value has to be provided. o The first 3 digits identify the purpose of the certificate. If the certificate will be used for GUI access “GUI” has to be entered. If the certificate is used to connect to the API “API” has to be entered. o Thereafter a free user defined string from 1 to 13 characters must be used for your internal description. Please note: The information “Account Name” has to match the Common Name of the certificate. The complete Account Name should look like this: 26 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 The Common Name (CN) of the certificate must match the account name. For our example participant ID the name of certificate would look like this ‘INTERGUIEUREXREPOUSER’ or “INTERGUITRDFRI123” or “INTERAPITRDFR123” from the examples used earlier in this document. Please note: If the Account Name and the Common Name of the certificate differ it will not be possible to upload the certificate. The Account Name of the certificate must contain the string “GUI” or “API” after the 5 digit participant ID, else the certificate will be rejected by the Eurex Repo application. 5.8 ‘Description’ field As the field ‘Description’ is a free text field any information can be provided. However, for a better overview it is recommended to provide some information regarding the certificate (e.g. technical information), the participant (e.g. participant ID) and the environment in which the certificate is being used. Example for participant ‘INTER’: 5.9 Certificate upload verification If a problem occurs during the upload process or if a mandatory field is empty, an error message will appear in the member section (see two examples below). 27 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 If no error message appears after clicking on ‘save’ the certificate has been uploaded successfully to the member section and the new account should be displayed in the overview screen, including ‘User ID’ and ‘Description’. 5.10 Username and password authentication In order to login and use the Eurex Repo GUI or a third party application the participant must complete the second part of the two-factor authentication process username and password authentication. 5.11 Additional IP Address check (Internet access) Default any user of the given participant is permitted to access the application from any IP address. If the participant wants to restrict the default access, a list of IP addresses can be entered in the member section. As a result it will only be possible to access the application from these IP addresses. Here is an example where access is limited from one IP address only: Internet access for the given participant can be completely blocked by setting the corresponding radio-button. 28 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 6. Further information and contacts Eurex Repo‘s web page http://eurexrepo.com is the central source for all relevant information needed to migrate to Eurex Repo’s new trading system F7. General information and FAQs can be found at: Technical Support > New Trading System F7. Additional items are also available: Access the Member Section “Requests & Configuration” www.eurexrepo.com > Member Section > Technical Connection > Requests & Configuration Documents for the new repo architecture, including F7 API documentation, are available at: www.eurexrepo.com > Member Section > Repo Resources > New Trading System F7 > System Documentation > Release 1.0 With the start of simulation an additional source of information will be made available For most up-to-date information, please check our Implementation News at: www.eurexrepo.com > Technical Support > New Trading System F7 > Implementation News Please do not hesitate to contact us in case of any questions. Technical Support Functional Support Customer Technical Support Eurex Repo Administration & Operation +49 (0) 69 2 11-1 08 77 +41 (0) 43 430 72 20 cts@deutsche-boerse.com funchelp@eurexrepo.com Eurex Repo Sales Member Section Team Eurex Repo Sales +49-(0) 69-2 11-1 78 88 +49 (0) 69 2 11-1 40 40 member.section@deutsche-boerse.com sales@eurexrepo.com 29 Eurex Repo’s New Trading System F7 Eurex Repo F7 Connectivity Guide V 1.0.8 7. Change Log Version Chapter, page 1.0.1 Date Change 31.07.2014 Added “API” / “GUI” differentiation for x.509 certificates 1.0.3 5.1, 5.2 28.08.2014 Improved description of certificate creation with openssl and keytool 1.0.4 5.1, 5.2 15.09.2014 Corrected two misspelled CN names 1.0.5 5.7 24.09.2014 Corrected screenshot with username specification (not showing the participant ID anymore) 1.0.6 2.3.2 01.10.2014 Adjusted netmasks 5.7 08.10.2014 Corrected screenshot with Account Name 08.10.2014 Adjusted wording for Account Name/ Common Name user defined string 1.0.7 5.1.1 28.10.2014 Added remark about OpenSSL versions affected by heartbleed bug 1.0.8 5.2.5 18.11.2014 Deleted outdated link 30 © Eurex 2014 Deutsche Börse AG (DBAG), Clearstream Banking AG (Clearstream), Eurex Frankfurt AG, Eurex Clearing AG (Eurex Clearing) as well as Eurex Bonds GmbH (Eurex Bonds) and Eurex Repo GmbH (Eurex Repo) are corporate entities and are registered under German law. Eurex Zürich AG is a corporate entity and is registered under Swiss law. Clearstream Banking S.A. is a corporate entity and is registered under Luxembourg law. U.S. Exchange Holdings, Inc. and International Securities Exchange Holdings, Inc. (ISE) are corporate entities and are registered under U.S. American law. Eurex Frankfurt AG (Eurex) is the administrating and operating institution of Eurex Deutschland. Eurex Deutschland and Eurex Zürich AG are in the following referred to as the “Eurex Exchanges”. All intellectual property, proprietary and other rights and interests in this publication and the subject matter hereof (other than certain trademarks and service marks listed below) are owned by DBAG and its affiliates and subsidiaries including, without limitation, all patent, registered design, copyright, trademark and service mark rights. While reasonable care has been taken in the preparation of this publication to provide details that are accurate and not misleading at the time of publication DBAG, Clearstream, Eurex, Eurex Clearing, Eurex Bonds, Eurex Repo as well as the Eurex Exchanges and their respective servants and agents (a) do not make any representations or warranties regarding the information contained herein, whether express or implied, including without limitation any implied warranty of merchantability or fitness for a particular purpose or any warranty with respect to the accuracy, correctness, quality, completeness or timeliness of such information, and (b) shall not be responsible or liable for any third party’s use of any information contained herein under any circumstances, including, without limitation, in connection with actual trading or otherwise or for any errors or omissions contained in this publication. This publication is published for information purposes only and shall not constitute investment advice respectively does not constitute an offer, solicitation or recommendation to acquire or dispose of any investment or to engage in any other transaction. This publication is not intended for solicitation purposes but only for use as general information. All descriptions, examples and calculations contained in this publication are for illustrative purposes only. Eurex and Eurex Clearing offer services directly to members of the Eurex exchanges respectively to clearing members of Eurex Clearing. Those who desire to trade any products available on the Eurex market or who desire to offer and sell any such products to others or who desire to possess a clearing license of Eurex Clearing in order to participate in the clearing process provided by Eurex Clearing, should consider legal and regulatory requirements of those jurisdictions relevant to them, as well as the risks associated with such products, before doing so. Eurex derivatives are currently not available for offer, sale or trading in the United States or by United States persons (other than EURO STOXX 50® Index Futures, EURO STOXX 50® ex Financials Index Futures, EURO STOXX® Select Dividend 30 Index Futures, EURO STOXX® Index Futures, EURO STOXX® Large/Mid/Small Index Futures, STOXX® Europe 50 Index Futures, STOXX® Europe 600 Index Futures, STOXX® Europe 600 Banks/Industrial Goods & Services/Insurance/Media/Travel & Leisure/Utilities Futures, STOXX® Europe Large/Mid/Small 200 Index Futures, Dow Jones Global Titans 50 IndexSM Futures (EUR & USD), DAX®/MDAX®/TecDAX® Futures, SMIM® Futures, SLI Swiss Leader Index® Futures, MSCI World/Europe/Japan/AC Asia Pacific ex Japan Index Futures and VSTOXX® Futures as well as Eurex inflation/commodity/weather/property and interest rate derivatives). Trademarks and Service Marks Buxl®, DAX®, DivDAX®, eb.rexx®, Eurex®, Eurex Bonds®, Eurex Repo®, Eurex Strategy WizardSM, Euro GC Pooling®, FDAX®, FWB®, GC Pooling®,,GCPI®, MDAX®, ODAX®, SDAX®, TecDAX®, USD GC Pooling®, VDAX®, VDAX-NEW ® and Xetra® are registered trademarks of DBAG. Phelix Base® and Phelix Peak® are registered trademarks of European Energy Exchange AG (EEX). All MSCI indexes are service marks and the exclusive property of MSCI Barra. RDX® is a registered trademark of Vienna Stock Exchange AG. IPD® UK Annual All Property Index is a registered trademark of Investment Property Databank Ltd. IPD and has been licensed for the use by Eurex for derivatives. ® ® ® SLI , SMI and SMIM are registered trademarks of SIX Swiss Exchange AG. The STOXX® indexes, the data included therein and the trademarks used in the index names are the intellectual property of STOXX Limited and/or its licensors Eurex derivatives based on the STOXX® indexes are in no way sponsored, endorsed, sold or promoted by STOXX and its licensors and neither STOXX nor its licensors shall have any liability with respect thereto. Dow Jones, Dow Jones Global Titans 50 IndexSM and Dow Jones Sector Titans IndexesSM are service marks of Dow Jones & Company, Inc. Dow Jones-UBS Commodity IndexSM and any related sub-indexes are service marks of Dow Jones & Company, Inc. and UBS AG. All derivatives based on these indexes are not sponsored, endorsed, sold or promoted by Dow Jones & Company, Inc. or UBS AG, and neither party makes any representation regarding the advisability of trading or of investing in such products. All references to London Gold and Silver Fixing prices are used with the permission of The London Gold Market Fixing Limited as well as The London Silver Market Fixing Limited, which for the avoidance of doubt has no involvement with and accepts no responsibility whatsoever for the underlying product to which the Fixing prices may be referenced. PCS® and Property Claim Services® are registered trademarks of ISO Services, Inc. Korea Exchange, KRX, KOSPI and KOSPI 200 are registered trademarks of Korea Exchange Inc. BSE and SENSEX are trademarks/service marks of Bombay Stock Exchange (BSE) and all rights accruing from the same, statutory or otherwise, wholly vest with BSE. Any violation of the above would constitute an offence under the laws of India and international treaties governing the same. The names of other companies and third party products may be trademarks or service marks of their respective owners.