Accueil

How to set up sFTP for using Certificate Authentication on Linux

These instructions apply to users who are receiving their statements via sFTP. If you elected to receive your statements via sFTP, you would first need to generate an RSA Key pair.

There are many Linux distributions and there are multiple methods to access the IBKR sFTP server. sFTP clients such as Filezilla can be used. In this article we explain how to realize the connection to the IBKR FTP server using Ubuntu Linux and Filezilla.

 

  • How to generate an RSA Key pair

1. On your Linux machine, click on the Applications icon in the bottom left corner of you screen.

2. In the search box, type terminal and then click on the Terminal icon in the search results.
 
3. In the Terminal window, type sudo apt-get install filezilla putty-tools in order to install the required software. Enter your sudo password when requested.


4. Once the software installation is complete, type puttygen -t rsa -b 2048 -o privatekey.ppk in order to generate the RSA Key pair.
You will be asked to enter a passphrase and type it again to confirm.
PLEASE NOTE: Keeping a secure copy of this password is essential. Any loss of this password will require the whole process to be repeated.
 
5. Type puttygen -L privatekey.ppk -o public.key in order to export the public part of the Key pair to the file public.key


6. Click on the Applications icon in the bottom left corner of your screen.
 
7. In the search box, type FileZilla and then click on the FileZilla icon in the search results.

8. Click on the FileZilla top menu File -> Site Manager...
 
9. In the Site Manager window, click on the button New site to create a new connection.
 
10. In the right panel (called General):
  • Select SFTP - SSH File Transfer Protocol as Protocol
  • Enter xfer.interactivebrokers.com in the Host field
  • Enter 32 in the Port field
  • Select Key file as Logon Type
  • Enter the username provided to you by Interactive Brokers in the User field
 
11. Click on Browse next to the Key file field.
 
12. Move to the folder where your Key pair was created (normally your user folder: /users/yourusername/). Select the file privatekey.ppk and click on the Open button. This will set it as the Key file in your connection parameters.
 
13. Click on Rename and select a name of your preference for this connection (e.g. IBKR sFTP). Press Enter to confirm the name.
 
14. Click on OK to save your connection parameters.
 
15. Click on the folder icon on the left hand toolbar of your Desktop. This will launch the File application.
 
16. Move to the folder where you saved your Key pair (normally your user folder: /users/yourusername/). Right click on the file public.key and select Send to...
The file will be attached to an empty email. Send the email to the Reporting Integration Team, as per IBKB3842.
Important Note: do NOT send us your private key. Send us only your public one

 

  • How to connect to our sFTP Server

Once IBKR has configured the parameters for your connection on our servers, you will be notified. After that, you will be able to access your sFTP repository by using the Site connection you have created in FileZilla. In case you have not yet set up a Site connection, please follow the steps from 6. to 14. which are a prerequisite to the below steps:

1. Click on the Applications icon in the bottom left corner of you screen.
 
2. In the search box, type FileZilla and then click on the FileZilla icon in the search results.
 
3. On the FileZilla top toolbar, click the down arrow icon and select the Site connection you previously created (e.g. IBKR sFTP)
 
4. FileZilla will now establish a connection to our sFTP Server and show the files present in your repository.

 

Common issues and solutions

A. The Login Credentials Provided are Incorrect
  1. Ensure the correct login details are being used to connect to the sFTP server. The username and password you are entering should match the ones you have received from the Reporting Integration Team.
  2. Confirm you have configured your sFTP Client to use the Private Key file for the logon authentication (see steps 9. and 10. of the above procedure.)
B. Server Refused Our Key
  1. Try accessing the sFTP server using a different Client (CyberDuck, ect.)
  2. Ensure the Private Key file being used to Authenticate the server login attempt is related to the Public Key you originally sent to the Reporting Integration Team.
  3. Should the above checks be unable to resolve the issue, please generate a new RSA Public/Private Key pair and send only the Public part to the Reporting Integration Team, as per IBKB3842.
C. Connection Timed Out
  1. In case you have an antivirus or a security software installed on your machine, make sure it is not blocking the FTP connection attempt. Normally, security software allows to set up exceptions for specific connections in order to whitelist them.
  2. Verify that the public IP Address of the machine running the sFTP client, is the same you have originally provided to the Reporting Integration Team for being whitelisted. You can discover your public IP Address by searching the Internet for “what is my IP”. If your current IP Address is not the same you provided to us, please send it to our Reporting Integration Team for being whitelisted.
  3. Ask your network administrator/s to confirm that your firewall allows both incoming and outgoing traffic from/to xfer.interactivebrokers.com on port TCP 32.
  4. Should the above steps be unable to resolve the issue, please generate a new RSA Public/Private Key pair and send only the new Public part to our Reporting Integration Team, as per IBKB3842.

 

References

KB3968 - Generate a key pair using GPG for Windows
KB4205 - Generate a key pair using GPG Suite on macOS
KB4108 - Decrypt your Reports using GPG for Windows
KB4210 - Decrypting Reports using your PGP Key pair on macOS
KB4407 - Generate RSA Key Pair on Windows
KB4578 - How to Access your Reports using FTP on Windows
KB4580 - How to Access your Reports using FTP on MacOS
KB4409 - How to set up sFTP for using Certificate Authentication on Windows
KB4410 - How to set up sFTP for using Certificate Authentication on macOS
KB4411 - How to backup your public/private Key pair 
KB4323 - How to transfer your public/private key pair from one computer to another

 

Exchange name change

Overview:

Interactive Brokers is completing an effort to update and consolidate exchange names where appropriate. When this effort is complete, the following updates will be in effect:

  • GLOBEX and CMECRYPTO will be consolidated to a single exchange, ‘CME’
  • ECBOT will be updated to ‘CBOT’
  • COMEX listed metals (previously reflected as NYMEX) will be updated to exchange ‘COMEX’
  • NYMEX, no change

Given the breadth of products involved, we are migrating in four waves based on underlying products:

Key Effective Trade Date Products
Wave 1 October 30, 2022 GLOBEX: ZAR, LB, DA, IXE
Wave 2 November 6, 2022 GLOBEX: EMD, BRE, CHF, SOFR3, E7, NKD
CMECRYPTO: BTCEURRR, ETHEURRR, MET
Wave 3 November 13, 2022 GLOBEX: All remaining products
CMECRYPTO: All remaining products
ECBOT: ZO, ZR, 2YY, 30Y
NYMEX: ALI, QI, QC
Wave 4 December 4, 2022 ECBOT: All remaining products
NYMEX: All remaining "Metal" products

 

I am trading via API, how does this impact me?

For API clients the only requirement would be to provide a new exchange name, for example: exchange=”CME”, for existing contracts for the affected exchanges.

Old exchanges names will no longer be available after the change.

More details can be found within our FAQs through the following link: Upcoming Exchange name Changes

Note: If you are using a third party software connected to TWS or IB Gateway and that software does not recognize the new contract definitions, please contact the third party vendor directly.

Comment télécharger des diagnostics depuis une plateforme IBKR

Overview: 

Certains problèmes liés au support nécessitent le téléchargement de fichiers de diagnostic et de journaux avec des captures d’écran. Les informations aideront nos équipes à étudier et à résoudre le problème rencontré.

Cet article vous fournira des étapes détaillées sur la façon de télécharger des fichiers de diagnostic et des journaux à partir des diverses plateformes de trading d’Interactive Brokers.

Remarque : IBKR ne surveille pas le référentiel de diagnostics pendant la journée. Si vous décidez de télécharger des diagnostics sans qu’Interactive Brokers ne vous le demande, veuillez en informer notre Service clientèle via un ticket dans le Centre messagerie ou par téléphone, sinon votre rapport d’erreur passera inaperçu.

 

Veuillez cliquer sur un des liens ci-dessous, selon la plateforme que vous utilisez :

 
1. Connectez-vous à TWS et essayez de reproduire le problème auquel vous faites face
2. Cliquez sur Aide en haut à gauche et sélectionnez Télécharger les diagnostics. Sinon, selon votre système d'exploitation, vous pouvez utiliser les raccourcis clavier suivants :
  • Pour les systèmes d'exploitation Windows ou Linux : Appuyez sur Ctrl+Alt+Q
  • Pour Mac : Appuyez sur Cmd+Option+H
3. La fenêtre Télécharger les diagnostics apparaîtra. Vous pouvez saisir la raison du téléchargement des diagnostics dans la zone de texte prévue à cet effet
4. Si un représentant d'Interactive Brokers vous a demandé d'inclure les journaux des jours précédents ou de sélectionner des options précises lors du téléchargement des diagnostics, veuillez cliquer sur le menu déroulant en haut à droite, sélectionner ‘Vue avancée’ et cocher les cases correspondantes qui apparaîtront en bas à droite
5. Veuillez vous assurer que la case « Inclure une capture d'écran de tout le bureau » est cochée et cliquer sur Soumettre
6. Veuillez n'effectuer aucune action/activité sur votre ordinateur tant que vous ne voyez pas la fenêtre ci-dessous, confirmant que les diagnostics ont bien été téléchargés
 
 
 
 
A) Si vous êtes sur l'écran de connexion :
1. Touchez les trois points en haut à droite et sélectionnez « Télécharger diagnostics »
2. Ajoutez votre nom d'utilisateur dans la section Commentaire et cliquez sur Télécharger
 
B) Si vous êtes déjà connecté à l'appli :
1. Touchez les trois lignes en haut à gauche pour ouvrir le menu
2. Touchez Configuration > Signaler un problème > cochez la case à côté de Mode débogage
3. Si un représentant d'Interactive Brokers vous le demande, cochez également la case à côté de Journal étendu
4. Rendez-vous sur la page où vous avez un problème
5. Touchez les trois points en haut à droite et sélectionnez « Télécharger les diagnostics »
6. Saisissez vos commentaires dans le champ prévu à cet effet et cochez la case à côté de « Ajouter une capture d'écran » Puis appuyez sur Charger
 
 
 
 
A) Si vous êtes sur l'écran de connexion :
1. Touchez le logo IBKR 5 fois de suite, rapidement pour ouvrir le menu de test
2. Sous Configuration, activez le bouton à côté de Mode de débogage
3. Appuyez sur Envoyez à côté de Télécharger les diagnostics
4. Saisissez votre nom d'utilisateur dans la section Commentaire et appuyez sur OK
 
B) Si vous êtes déjà connecté à l'appli :
1. Prenez des captures d'écran montrant le problème, directement sur votre téléphone (en appuyant simultanément sur le bouton latéral ou Marche/Arrêt + Augmenter le volume)
2. Appuyez sur le bouton Plus en bas à droite
3. Appuyez sur Configuration et agrandissez la section Signaler un problème
4. Activez le bouton à côté de Mode de débogage et, à côté de Télécharger les diagnostics, appuyez sur Envoyer
 
5. La page Envoyer les diagnostics apparaîtra. Saisissez vos commentaires dans la section Commentaire
6. Appuyez sur le bouton Joindre une image pour joindre les captures d'écran du problème que vous avez enregistrées dans votre galerie
7. Appuyez sur Envoyer
 
 
 
1. Connectez-vous à l'appli
2. Appuyez sur l'icône Utilisateur en haut à gauche et sélectionnez Paramètres
3. Appuyez sur l'option « Avancé » et activer le bouton à côté de Mode de débogage
4. Si un représentant d'Interactive Brokers vous le demande, activez également le bouton à côté de Journal étendu
5. Vous pourrez voir « Télécharger les diagnostics ». Saisissez vos commentaires dans le champs et appuyez sur Télécharger
 
Note : Si vous devez nous envoyer des captures d'écran d'IMPACT ou de GlobalTrader IBKR pour Android, vous devrez les joindre à un ticket du Centre de messagerie, comme expliqué dans l'article IBKB1071
 
 
 
1. Connectez-vous à l'appli
2. Prenez une ou plusieurs captures d'écran montrant le problème, directement sur votre téléphone (en appuyant simultanément sur le bouton latéral ou Marche/Arrêt + Augmenter le volume)
3. Appuyez sur l'icône Utilisateur en haut à gauche et sélectionnez Paramètres
4. Appuyez sur « Avancé »
5. Activez le bouton à côté de Mode de débogage et appuyez sur Télécharger les diagnostics
6. L'écran Envoyer les diagnostics apparaîtra

7. Saisissez vos commentaires dans le champ et appuyez sur « Joindre une image » pour joindre les captures d'écran que vous avez enregistrées dans votre galerie

8. Appuyez sur Envoyer
 

 

Les détails des diagnostics pour le Portail Client sont expliqués dans l'article IBKB3512

 

How to Upload a Diagnostic Bundle from an IBKR Platform

Overview: 

Some support related issues require diagnostics files and logs to be uploaded along with screenshots. The information will help our team to investigate and resolve the issue that you are experiencing.

This article will help you with detailed steps on how to upload diagnostics files and logs from various Interactive Brokers’ trading platforms.

Note: IBKR does not monitor the diagnostic bundle repository throughout the day. Should you spontaneously decide to upload a diagnostic bundle, without being instructed by Interactive Brokers, please inform our Client Services via Message Center ticket or phone call otherwise your error report will go unnoticed.

 

Please click on one of the links below, according to the platform you are using:

 
1. Log in to TWS and try to replicate the issue that you are experiencing
2. Press ‘Help’ at the top left corner and select ‘Upload Diagnostics’. Alternatively, depending on your Operating System, you can use the following keyboard combinations
  • For Windows and Linux Operating system: Press Ctrl+Alt+Q
  • For Mac: Press Cmd+Option+H
3. The ‘Upload Diagnostics’ window will appear. You may enter the reason for uploading diagnostics in the text box
4. If an Interactive Brokers representative has instructed you to include previous days logs or select specific options when uploading diagnostics, click the dropdown on the right top corner, select ‘Advanced View’ and tick the correspondent checkboxes which will appear on the bottom left part
5. Make sure the checkbox ‘Include screenshot of entire desktop’ is enabled and press ‘Submit’
6. Do not perform any action/activity on your computer until you see the below pop-up, confirming that the diagnostics have been successfully uploaded
 
 
 
 
A) If you are at the login Screen:
1. Tap the three dots icon in the right top corner and select ‘Upload Diagnostics’
2. Add your username in the comment section and tap ‘Upload’
 
B) If you are already logged  in to the app:
1. Tap the three lines icon in the top left corner to open the menu
2. Tap ‘Configuration’> ‘Trouble Reporting’> enable the check box next to ‘Debug mode’
3. If requested by an Interactive Brokers representative, enable the check box next to ‘Extended Log’ as well
4. Navigate to the page where you are experiencing the issue
5. Tap the three dots icon in the top right corner of the screen and select ‘Upload Diagnostics’
6. Enter your comments in comment section and enable the checkbox next to ‘Attach Screenshot’. Then tap ‘Upload’
 
 
 
 
A) If you are at the login Screen:
1. Tap five times in a quick sequence on the IBKR logo to open the testing menu
2. Under Configuration, enable the toggle button next to ‘Debug mode’
3. Tap ‘Send’ next to ‘Upload diagnostics’
4. Enter your username in the comments section and tap ‘OK’
 
B) If you are already logged in to the app:
1. Capture screenshots displaying the issue you are experiencing directly on the phone (pressing together the physical buttons Power + Volume Up)
2. Tap the option ‘More’ in the right bottom corner of the screen
3. Tap ‘Configuration’ and expand the section ‘Trouble Reporting’
4. Enable the toggle button next to ‘Debug mode’ and, next to ‘Upload diagnostics’, tap ‘Send’
 
5. The ‘Send Diagnostics’ page will appear. Enter your comments in comment section
6. Tap the ‘Attach Image’ button to attach screenshots of the issue that you have previously saved in your camera roll
7. Tap ‘Send’
 
 
 
1. Log in to the app
2. Tap the User icon in the top left corner and select ‘Settings’
3. Tap the option ‘Advanced’ and enable the toggle button next to ‘Debug mode’
4. If requested by an Interactive Brokers representative, enable as well the toggle button next to ‘Extended Log’
5. You will see an ‘Upload Diagnostics’ pop-up. Enter your comments in the field and tap ‘Upload’
 
Note: If you need to send us screenshots of IMPACT or IBKR GlobalTrader for Android, you would have to attach them to a Message Center web ticket, as explained in IBKB1071
 
 
 
1. Log in to the app
2. Capture one or more screenshots displaying the issue you are experiencing directly on the phone (pressing the physical buttons Power + Volume Up simultaneously)
3. Now tap the User icon in the top left corner and select ‘Settings’
4. Tap ‘Advanced’
5. Enable the toggle button next to ‘Debug mode’ and tap ‘Upload Diagnostics’
6. The ‘Send Diagnostics’ screen will appear

7. Enter your comments in the field and tap ‘Attach Image’ to attach the screenshot/s you previously saved in your camera roll

8. Tap ‘Send’
 

 

A diagnostic trace for Client Portal can be captured following the steps on IBKB3512

 

Comment générer un fichier .har

Background: 

Lors de la résolution d'un problème de site important, il est parfois nécessaire que notre équipe de Service clientèle obtienne des informations supplémentaires sur la communication de votre navigateur. Il pourra vous être demandé d'enregistrer et fournir un fichier .har. Ce fichier contient des informations complémentaires concernant les requêtes réseau qui sont envoyées et reçues par votre navigateur. Votre navigateur peut générer un tel fichier en enregistrant le contenu, la chronologie et le statut des demandes et réponses HTTP/HTTPS lorsque le problème se produit.

Dans cet article, nous expliquons comment générer un fichier .har. Veuillez cliquer sur le navigateur que vous utilisez dans a liste ci-dessous :

 

Générer un fichier HAR pour Google Chrome :

1. Ouvrir Google Chrome et aller sur la page où le problème se produit.

2. Appuyer sur CRTL + Maj + I sur votre clavier. Sinon, cliquer sur le menu Chrome (3 points verticaux en haut à droite de la fenêtre du navigateur) et sélectionner Plus d'outils > Outils de développement

3. Les Outils de développement s'ouvrent dans un panneau intégré sur le côté ou en bas de Chrome. Sélectionner l'onglet Réseau (Image 1.)

Image 1.

4. Chercher un bouton rond Enregistrer (Record) en haut à gauche de la barre d'outils des Outils de développement et s'assurer qu'il soit rouge. S'il est gris, cliquer une fois pour démarrer l'enregistrement ou appuyer sur CTRL+E (Image 2.)

Image 2.

5. Cocher la case Conserver les journaux (Preserve log) (Image 3.)

Image 3.

6. Cliquer sur le bouton Effacer (Clear) pour effacer les fichiers existants. Le bouton Effacer a un icône stop et est situé à droite du bouton Enregistrer (Image 4.)

Image 4.

7. Reproduire le problème pendant que les requêtes réseau sont en cours d'enregistrement.

8. Une fois le problème reproduit, faire un clic droit n'importe où sur la liste des requêtes réseau enregistrées, sélectionner Tout enregistrer sous HAR avec contenu, et enregistrer le fichier à l'endroit souhaité sur votre ordinateur (par exemple sur le Bureau).

9. Depuis le Portail Client, se rendre dans le Centre de messagerie et créer un nouveau ticket (ou utiliser un ticket existant le cas échéant)

10. Dans le ticket, joindre le fichier .har généré précédemment.  Si le Service clientèle d'IBKR vous a fourni un numéro de référence ou le nom d'un agent, veuillez l'ajouter dans le contenu du message.

11. Envoyer le ticket

 

Générer un fichier HAR pour Firefox :

1. Ouvrir Firefox et aller sur la page où le problème se produit.

2. Appuyer sur F12 sur votre clavier. Sinon, cliquer sur le menu Firefox (3 lignes horizontales en haut à droite de la fenêtre du navigateur) et sélectionner Outils supplémentaires > Outils de développement web

3. Les Outils de développement web s'ouvrent dans un panneau intégré sur le côté ou en bas de Firefox. Sélectionner l'onglet Réseau (Image 5.)

Image 5.

4. Cocher la case Conserver les journaux (Persist log) (Image 6.)

Image 6.

5. Reproduire le problème. L'enregistrement de la demande réseau démarre automatiquement.

6. Une fois le problème reproduit, faire un clic droit n'importe où sur la liste des requêtes enregistrées et sélectionner Tout enregistrer sous HAR.

7. Enregistrer le fichier à l'endroit souhaité sur votre ordinateur (par exemple sur le Bureau).

8. Depuis le Portail Client, se rendre dans le Centre de messagerie et créer un nouveau ticket (ou utiliser un ticket existant le cas échéant)

9. Dans le ticket, joindre le fichier .har généré précédemment.  Si le Service clientèle d'IBKR vous a fourni un numéro de référence ou le nom d'un agent, veuillez l'ajouter dans le contenu du message.

10. Envoyer le ticket

 

Générer un fichier HAR pour Microsoft Edge :

1. Ouvrir Edge et aller sur la page où le problème se produit.

2. Appuyer sur F12 sur votre clavier. Sinon, cliquer sur le menu Edge (3 points horizontaux en haut à droite de la fenêtre du navigateur) et sélectionner Plus d'outils > Outils de développement

3. Sélectionner l'onglet Réseau (Image 10.)

Image 10.

4. Reproduire le problème pendant que les requêtes réseau sont en cours d'enregistrement.

5. Une fois fini, cliquer sur la disquette (Exporter en HAR) ou appuyer sur CTRL+S (Image 11.)

Image 11.

6. Donner un nom au fichier et l'enregistrer à l'endroit souhaité sur votre ordinateur (par exemple sur le Bureau). Puis cliquer sur le bouton Enregistrer

7. Depuis le Portail Client, se rendre dans le Centre de messagerie et créer un nouveau ticket (ou utiliser un ticket existant le cas échéant)

8. Dans le ticket, joindre le fichier .har généré précédemment.  Si le Service clientèle d'IBKR vous a fourni un numéro de référence ou le nom d'un agent, veuillez l'ajouter dans le contenu du message.

9. Envoyer le ticket

 

Générer un fichier HAR pour Safari :

Remarque : Avant de générer le fichier HAR, veuillez vous assurer de bien voir le menu Développement dans Safari. Si ce menu n'est pas visible, cliquer sur le menu Safari, choisir Préférences, aller sur l'onglet Avancées et cocher la case à côté de Afficher le menu Développement dans la barre des menus

1. Ouvrir le menu Développement et sélectionner Afficher l'inspecteur web ou appuyer sur CMD+ALT+I

2. Sélectionner l'onglet Réseau (Image 12.)

Image 12.

3. Cocher la case Conserver les journaux (Image 13.)

Image 13.

4. Cliquer sur l'icône Exporter (ou appuyer CMD+S), donner un nom au fichier, choisir l'endroit souhaité sur votre ordinateur (par exemple sur le Bureau) et enregistrer le fichier .har.

5. Depuis le Portail Client, se rendre dans le Centre de messagerie et créer un nouveau ticket (ou utiliser un ticket existant le cas échéant)

6. Dans le ticket, joindre le fichier .har généré précédemment.  Si le Service clientèle d'IBKR vous a fourni un numéro de référence ou le nom d'un agent, veuillez l'ajouter dans le contenu du message.

7. Envoyer le ticket

 

Generate RSA Key Pair on Windows

These instructions apply to users who are receiving their statements via sFTP. If you elected to receive your statements via sFTP, you would first need to generate an RSA Key pair.

To generate an RSA Key pair:

1. Download WinSCP.

2. Run the installer and make sure to check PuTTYgen (key generator) as one of the components to install.

3. Start WinSCP and from the button Tools select Run PuTTYgen.


4. Once the tool PuTTYgen has been launched, click Generate. Select RSA as Type of key to generate, 2048 as Number of bits in generated key and click on the button Generate.

5. Click "Save private key" and give the file a name (like private). Leave the extension as .ppk  ('ale.ppk', in the picture below is an example filename).
Important Note: do NOT save your public key yet. Save only your private one.

6. Open WinSCP, create a new connection and:
  • Select SFTP as File protocol.
  • Enter xfer.interactivebrokers.com in the Host name field.
  • Enter 32 in the Port number field.
 
7. Click on the button Advanced.

8. In the Advanced Site Settings screen, left side menu, expand SSH and select Authentication. Click on the button ... at the end of the field Private Key file and open the private key you previously saved at point 5):

9. Click on the button Display public key:
 
10. Click on the button Copy Key.

11. Open Notepad, press CTRL+V to paste the key string (which is one string of characters without spaces) and then save the file with the name public.key in a folder of your preference:


12. Send the file you saved at the previous step to us via Message Center ticket or email as per instructions on IBKB3842
 
13. In the WinSCP Window, click on "OK" in the information pop-up showing the key, then "OK" in the Advanced Site Settings screen, then click on Save to save the new connection you have created.
 
14. Once the IBKR Sales Engineering Team has configured the parameters for your connection on our servers, you will be able to access your SFTP repository by using the connection you have created.
 
Related articles

KB3842 - Using GPG/RSA encryption keys to guarantee the privacy and security of your Reports
KB3968 - Generate a key pair using GPG for Windows
KB4205 - Generate a key pair using GPG Suite on macOS
KB4108 - Decrypt your Reports using GPG for Windows
KB4210 - Decrypting Reports using your PGP Key pair on macOS
KB4578 - How to Access your Reports using FTP on Windows
KB4580 - How to Access your Reports using FTP on MacOS
KB4409 - How to set up sFTP for using Certificate Authentication on Windows
KB4410 - How to set up sFTP for using Certificate Authentication on macOS
KB4411 - How to backup your public/private Key pair 
KB4323 - How to transfer your public/private key pair from one computer to another 
 

Transferring your Key Pair From One Computer To Another

Background: 

If you need to decrypt files that were encrypted with your private Key on an additional computer, you need to copy both your private and public keys (the entire Key pair) to that computer.

Note: this tutorial assumes you have already set up a Key pair. If you need guidance to set up the Key pair please refer to this article, which is a prerequisite to the instructions below.

 

How to transfer your Key pair:

Please select one of the below links, according to your Operating System:

 

Windows

1. On the machine where the encryption keys are stored, connect a USB drive to a free USB port.

2. Launch the Kleopatra application and select the encryption key you want to transfer. Then right-click on the selection and choose Backup Secret Keys...

Note: Do NOT use Export..., as this will only export the public part of the Key while you need to have a backup of both public and private parts.

3. Select your USB drive as destination and a filename of your preference (e.g. secret-key-KEYID.asc) for your backup copy. Then click Save.

4. Enter the passphrase you have set when you created the Key and click OK.

5. A pop-up will confirm the backup has been successfully created. Click OK.

6. Eject your USB drive safely through the Windows interface to prevent data loss and connect it to a free USB port on the other computer (the one you want to transfer the key to). All the next steps have to be executed on that machine.

7. Make sure the the GPA software is installed, otherwise please install it. Make sure that the component Kleopatra is selected as one of the sub components to include in the installation.

8. Launch the Kleopatra application and click on the top menu File and select Import...

9. Click on the letter correspondent to your USB drive and select the file you have previously saved (e.g. secret-key-KEYID.asc). Then click Open.

10. Click on Yes, It's Mine.

11. A pop-up will confirm the Key has been successfully imported. Click OK. You may now want to delete the key file from the USB drive and empty the Trash.

 

macOS

1. On the machine where the encryption keys are stored, connect a USB drive to a free USB port.

2. Launch the GPG Keychain application and select the encryption key you want to transfer. Please make sure that you see the text Type: Secrete and public key, in the Type column.

3. With the desired encryption key highlighted, click Export. Please make sure to check the box for the option Include secret key in exported file, as illustrated in the above screenshot. Save the key pair to the USB drive.

4. Eject the USB drive and connect it to a free USB port on the other computer (the one you want to transfer the key to). All the next steps have to be executed on that machine.

5. Make sure the GPG Tools suite is installed, otherwise please install it.

6. Launch the GPG Keychain application and click the icon Import on the top toolbar.

7. Click the USB Drive and select the previously saved .ASC file that contains the Public and Private key. Then click Open.

8. The confirmation should read Import successful.

9. Once the key has been successfully imported, delete the key file from the USB drive and empty the Trash.

 

Related articles

KB3842 - Using GPG/RSA encryption keys to guarantee the privacy and security of your Reports
KB3968 - Generate a key pair using GPG for Windows
KB4205 - Generate a key pair using GPG Suite on macOS
KB4108 - Decrypt your Reports using GPG for Windows
KB4210 - Decrypting Reports using your PGP Key pair on macOS
KB4407 - Generate RSA Key Pair on Windows
KB4578 - How to Access your Reports using FTP on Windows
KB4580 - How to Access your Reports using FTP on MacOS
KB4410 - How to set up sFTP for using Certificate Authentication on macOS
KB4411 - How to backup your public/private Key pair 
 
 

Decrypting Reports Using Your PGP Key Pair on macOS

Note: This tutorial assumes you received reports via email or via FTP that were encrypted with the public key you sent to IBKR . If you need guidance to set up the encrypted statement delivery, please refer to this article, which is a prerequisite to the instructions below.

1. Open Finder

2. Right click on the .gpg file you want to decrypt

3. Select Services > OpenPGP: Decrypt File

 

Common Issues/Questions

  • Decryption failed with error 'No Secret Key'

This is commonly caused when the wrong encryption key is used to decrypt the file.  If decryption is being done on a computer other than the original computer used to create the public/private keys, the keys would have to be transferred from the original computer to the new computer. 

If the above does not help, then a new public/private key pair needs to be created and sent to us.

 

Related articles

KB3842 - Using GPG/RSA encryption keys to guarantee the privacy and security of your Reports
KB3968 - Generate a key pair using GPG for Windows
KB4205 - Generate a key pair using GPG Suite on macOS
KB4108 - Decrypt your Reports using GPG for Windows
KB4407 - Generate RSA Key Pair on Windows
KB4578 - How to Access your Reports using FTP on Windows
KB4580 - How to Access your Reports using FTP on MacOS
KB4409 - How to set up sFTP for using Certificate Authentication on Windows
KB4410 - How to set up sFTP for using Certificate Authentication on macOS
KB4411 - How to backup your public/private Key pair 
KB4323 - How to transfer your public/private key pair from one computer to another 
 

Utiliser l'authentification IBKR Mobile (IB Key) sans notifications

Si votre smartphone ne peut pas recevoir de notifications IBKR Mobile, vous pouvez quand même terminer le processus de connexion en utilisant la méthode d'authentification IBKR Mobile (IB Key) Challenge/Réponse, décrite à la page suivante (selon le système d'exploitation de votre appareil) :

Les mêmes informations s'appliquent si votre téléphone n'a pas de connexion Internet (vous êtes en itinérance, hors couverture réseau, sans plan de données mobiles actif, etc.)

Si vous ne pouvez pas recevoir les notifications IBKR Mobile sur votre smartphone même en ayant une connexion à Internet, nous vous recommandons de suivre les étapes indiquées dans la base de connaissances IBKR.

 

Decrypt Your Reports Using GPG for Windows

Note: This tutorial assumes you received reports via email or via FTP that were encrypted with the public key you sent to IBKR. If you need guidance to set up the encrypted statement delivery, please refer to this article, which is a prerequisite to the instructions below.

How to decrypt files using Kleopatra:

1. Save all the encrypted Reports you received via email or FTP in a folder on your preference (e.g. Desktop)

2.  Start the Kleopatra application (included in Gpa4win software). The entry for your Key should be listed in the All Certificates panel. Click the top menu File and select Decrypt/Verify...

 
3.  Open the folder containing your encrypted files and select the ones you want to decrypt.
 
 
4.  Provide the passphrase you set when you create your Key.
 
 
5.  The files will be decrypted and the outcome of the operation will be displayed within the panel. You can change the output folder (where the decrypted files will be saved) if you wish. Click Save All to finalize the process.
Note: do NOT click Discard, otherwise the decrypted files will not be saved.
 
 
6.  Open the Windows File Explorer and navigate to the output folder you selected at the previous step. From there, you can access and open your clear-text files.
 
 
 
 

Common Issues/Questions

  • Decryption failed with error 'No Secret Key'

This is usually caused by the wrong encryption key being used to decrypt the file.  If decryption is being done on a computer other than the original computer used to create the public/private keys, the keys would have to be transferred from the original computer to the new computer. 

If the above does not help, then a new public/private key pair needs to be created and sent to us.

 

References

KB3842 - Using GPG/RSA encryption keys to guarantee the privacy and security of your Reports
KB3968 - Generate a key pair using GPG for Windows
KB4205 - Generate a key pair using GPG Suite on macOS
KB4210 - Decrypting Reports using your PGP Key pair on macOS
KB4407 - Generate RSA Key Pair on Windows
KB4578 - How to Access your Reports using FTP on Windows
KB4580 - How to Access your Reports using FTP on MacOS
KB4409 - How to set up sFTP for using Certificate Authentication on Windows
KB4410 - How to set up sFTP for using Certificate Authentication on macOS
KB4411 - How to backup your public/private Key pair 
KB4323 - How to transfer your public/private key pair from one computer to another 
 
Syndicate content