G-Portal User Guide

1. The user categories in G-Portal

The user categories in G-Portal are shown in the table below. User registration is required to download products. (See "2. How to register as a G-Portal user").

User Type	Definition	Services Available
Guest User	Users who have not completed user registration	Search and browse data online. Note that guest users are unable to order or acquire products.
Registered User	Users who have completed user registration	Search, browse, product, process and acquire standard products online. Acquire standard products and some near real-time products directly from the SFTP server.
Specific User	Register users, collaborator specially permitted by JAXA	Search, browse, product, process and acquire standard products online. In addition to the products that registered users can download, acquire special products being available to those who are JAXA-approved directly from the SFTP server.

2. How to register as a G-Portal user

To download products from the G-Portal Web or SFTP site, you should register as a user. The steps for registering as a user are explained below.

Click "User registration" from the left menu.
Description of UI image: The screenshot shows the G-Portal interface with the 'User registration' option highlighted in the left-hand menu.
To register a user, you must agree to the terms of service. Please read through the terms and click the "I Agree - Continue" button, then you will be moved to page "User Registration window". If you do not agree to the Terms of service, you will not be able to register as a "registered user". In that case, you will only be able to use the Service as a "guest user". *If you check "I agree to the above terms of service", you will be able to click the "I Agree - Continue" button.
Description of UI image: The screenshot shows the G-Portal terms of service agreement screen with options to 'I Agree - Continue' or 'Do Not Agree'.
Enter all user information to be registered (user account, password, name, email address, organization, department, country, language, purpose of use, email delivery preference).
Description of UI image: The screenshot displays the G-Portal user registration form with fields for user account, password, name, email, organization, country, language, purpose, and email delivery preference.
Click the "Next" button to move to the window to check the information you've entered. If you want to cancel the input contents, please click "Cancel" button. *The "Register Confirmation Screen" button can be clicked by entering all the items labeled (Required).
Description of UI image: The screenshot shows the G-Portal registration form with a 'Next' button and a 'Cancel' button.
The entered user information will be displayed, so check if there is any mistake in the contents. To correct, please click the "Back" button. You will return to the screen for entering user information.
Description of UI image: The screenshot shows the G-Portal registration confirmation screen, displaying entered user details and options to 'Register' or 'Back'.
Click the "Register" button to perform the provisional registration procedure.
Description of UI image: The screenshot shows the G-Portal registration confirmation screen with the 'Register' button highlighted.
The temporary registration procedure is completed. "Temporary registration notification mail" will be sent to the email address you entered. Registration is completed by accessing the URL described in the mail. At the time of temporary registration, you can not log in because user registration has not been completed yet.
Description of UI image: The screenshot indicates 'User Registration STEP4/5: G-Portal Temporary registration completed' and mentions an email notification.
Access the URL included in the "Temporary registration notification mail". The final registration window will be displayed. Your user account is sent to the email address you registered ("User Registration Complete Email"). User registration is complete and you can now login to the G-Portal.
Description of UI image: The screenshot indicates 'User Registration STEP5/5: G-Portal Registration completed' and confirms successful registration.

3. How to login to the G-Portal web site

In order to download or process products using the G-Portal website, you should login to the G-Portal website with the account that you registered on the web in advance. If you enter the wrong password five times in a row, your account will be locked. The account will be automatically unlocked after 10 minutes.

Click "Login" at menu on a left pane of the top window. Appear the login window.
Description of UI image: The screenshot shows the G-Portal interface with the 'Login' option highlighted in the left-hand menu.
Input your user account and password in login window. Click "Login" button.
Description of UI image: The screenshot shows the G-Portal login window with fields for 'User account' and 'Password', and a 'Login' button.
After login successfully, the "Login" button at menu on left pane of the top window switches to "Logoff: [account name]" button.
Description of UI image: The screenshot shows the G-Portal interface after successful login, with the menu item changed from 'Login' to 'Logoff: [account name]'.

4. How to download products via G-Portal SFTP site

To download products via the G-Portal SFTP site, you should login to the SFTP site with a user account that you registered on the Web in advance. You can connect to the SFTP site using software such as WinSCP, or by command line from Linux/UNIX (including Mac OS).

4.1. Basic information

This is the information required to connect to the G-Portal SFTP site. Note that connections using public key cryptography authentication are limited to certain specific users. Registered users should use account/password authentication.

Parameter	Value
host	ftp.gportal.jaxa.jp
port	2051
protocol	SFTP
user name	User account registered in G-Portal
password	Password registered in G-Portal (Used for account authentication)
Private key * Specific user only	A private key corresponding to the public key registered in G-Portal (Used in case of public key cryptographic authentication)

4.2. How to download products from SFTP site using command line

This section describes how to download products via SFTP using the command line on Linux/UNIX (including Mac OS).

4.2.1. How to connect to G-Portal with account authentication

If you are a "registered user," please use this method. (Authentication using the public key cryptography method described in Section 4.2.2 cannot be used.) If you enter the wrong password five times in a row, your account will be locked. The account will be automatically unlocked after 24 hours.

You can connect to the G-Portal SFTP site using your account credentials by entering the following command in the command line:

$ sftp -oPort=2051 [account name]@ftp.gportal.jaxa.jp

If you are successfully connected to the SFTP server, "Password:" will be displayed in command line, so enter your password.

If you are logged in successfully:
sftp >
List view
Enter:
sftp > ls
to display a list of files and directories.
Change directory
Enter:
sftp > cd [directory name]
to move to a specific directory.
*Note: Depending on your account permissions, you may not be able to move to directories that are displayed in the list.
Download a file
Enter:
sftp > get [file name]
to get a file. The specified file will be downloaded and saved in a directory on your computer.
Exit SFTP
Enter:
sftp > bye
to disconnect SFTP server.

4.2.2. How to connect to G-Portal with public key cryptography authentication

If your user category is "Specific User", you can also use this method. For information on how to register a public key, see Section 4.2.3 or 4.2.4.

You can access SFTP using public key cryptography authentication by entering the following command on the command line.

$ sftp -oPort=2051 -oIdentityFile=[public key path] [account name]@ftp.gportal.jaxa.jp

If you are logged in successfully:
sftp >
List view
Enter:
sftp > ls
to display a list of files and directories.
Change directory
Enter:
sftp > cd [directory name]
to move to a specific directory.
*Note: Depending on your account permissions, you may not be able to move to directories that are displayed in the list.
Download a file
Enter:
sftp > get [file name]
to get a file. The specified file will be downloaded and saved in a directory on your computer.
Exit SFTP
Enter:
sftp > bye
to disconnect SFTP server.

4.2.3. How to register a public key (for authentication using public key cryptography)

The following shows how to register the public key you created yourself to G-Portal. (Please note that you should not register the private key.)

You can also use G-Portal's functions to create private and public keys and automatically register that public key. For details, see Section 4.2.4 "Generating private and public keys and automatically registering the public key using G-Portal's function."

After logging in to the system, click "Account service" on the menu to display the user account service screen.
Description of UI image: The screenshot shows the G-Portal interface with the 'User account service' option highlighted in the menu.
Specify the public key file from the "Browse" button. If the public key has already been registered, it will be updated to the specified public key.
Description of UI image: The screenshot shows the G-Portal user account service screen with a 'Browse...' button and an 'Upload' button.
With the "Upload" button, the specified public key is registered in this system.
* If the public key menu is not displayed, your user category is "registered user" and you cannot use public key cryptography for authentication.

4.2.4. Generating private and public keys and automatically registering the public key using G-Portal's function (for authentication using public key cryptography)

This section introduces how to create a private key and a public key using the functions of G-Portal. With this method, the public key is registered automatically, so you do not need to register it yourself.

After logging in to the system, click "Account service" on the menu to display the user account service screen.
Description of UI image: The screenshot shows the G-Portal interface with the 'User account service' option highlighted in the menu.
Click the "Download" button to generate the private key and download the private key to your computer. Also, generate a corresponding public key and register it on the G-Portal.
* If the public key menu is not displayed, your user category is "registered user" and you cannot use public key cryptography for authentication.
Description of UI image: The screenshot shows the G-Portal user account service screen with a 'Download' button.

4.3. How to download products from an SFTP site using WinSCP (For Windows)

This section shows how to download the product from the SFTP site using WinSCP on a Windows PC.

Installation WinSCP

Download WinSCP Installer from the following site.
WinSCP download site: https://winscp.net/eng/download.php
Start WinSCP Installer.
Select "English" (1), and click [OK] (2).
Description of UI image: The WinSCP installer setup language selection dialog is shown, with 'English' selected and an 'OK' button.
Click [Next] (3).
Description of UI image: The WinSCP Setup Wizard welcome screen is shown, with a 'Next' button.
Select "I accept the agreement" (4), and click [Next] (5).
Description of UI image: The WinSCP installer license agreement screen is shown, with the 'I accept the agreement' option selected and a 'Next' button.
Select "Typical installation (recommended)" (6), and click [Next] (7).
Description of UI image: The WinSCP installer setup type screen is shown, with 'Typical installation (recommended)' selected and a 'Next' button.
Select "Commander" (8), and click [Next] (9).
Description of UI image: The WinSCP installer initial user settings screen is shown, with 'Commander' selected and a 'Next' button.
Click [Install] (10).
Description of UI image: The WinSCP installer 'Ready to Install' screen is shown, with an 'Install' button.
WinSCP is installed successfully, you will see the following window. Click [Finish] (11).
Description of UI image: The WinSCP Setup Wizard completion screen is shown, with a 'Finish' button.

Connect SFTP (Account authentication)

Start WinSCP.
Select "SFTP" for the File protocol. (1)
Enter "ftp.gportal.jaxa.jp" as the host name. (2)
Enter "2051" for port number. (3)
Enter the user account registered in G-Portal as "user name". (4)
Click [Login] to connect SFTP. (5)
Description of UI image: The WinSCP login dialog is shown, with fields for File protocol (SFTP), Host name, Port number, and User name, and a 'Login' button.
Enter the password registered in G-Portal and click [OK]. (6)
Description of UI image: The WinSCP password prompt dialog is shown, with a field for password and an 'OK' button.
If you have logged in successfully, the following image will be displayed. The left pane is your computer and the right pane is the G-Portal directory.
Description of UI image: The WinSCP interface is shown after successful login, displaying local computer directories on the left and the G-Portal SFTP directory on the right.

Connect SFTP (Public key cryptographic authentication * Specific user only)

Start WinSCP.
Enter "ftp.gportal.jaxa.jp" into "Host name". (1)
Enter "2051" into "Port number". (2)
Enter the user account registered in G-Portal as "User name". (3)
Click [Advcanced...] (4) to set private key file.
Description of UI image: The WinSCP login dialog is shown, with fields for File protocol (SFTP), Host name, Port number, User name, and an 'Advanced...' button.
Select "Authentication". (5)
Select private key file that you created into "Private key file". (6)
Click [OK]. (7)
Description of UI image: The WinSCP Advanced Site Settings dialog is shown, with 'Authentication' selected and a field for 'Private key file', and an 'OK' button.
Click [Login] (8) to SFTP login.
Description of UI image: The WinSCP login dialog is shown again, ready for login after advanced settings.
If you have set a password to decrypt the private key, click [OK] (10) button to enter the password (9) that you set.
Description of UI image: The WinSCP 'Key passphrase' dialog is shown, prompting for a password for the private key, with an 'OK' button.
If you have logged in successfully, the following image will be displayed. The left pane is your computer folder, the right is the G-Portal directory.
Description of UI image: The WinSCP interface is shown after successful login using public key authentication, displaying local computer directories on the left and the G-Portal SFTP directory on the right.