G-Portal Web Service

Specifications

• User Categories: Guest User, Registered User, Specific User
• Services Available: Vary based on user category, including online data search, browsing, product acquisition, and more
• Registration Requirement: User registration is required to download products

Product Usage Instructions

• User Categories in G-Portal:
  • The user categories in G-Portal are Guest User, Registered User, and Specific User. Each category has different levels of access and services available:
    • Guest User: Users who have not completed user registration. They can search and browse data online but cannot order or acquire products.
    • Registered User: Users who have completed user registration. They can search, browse, process, and acquire standard products online.
    • Specific User: Registered users who are collaborator specially permitted by JAXA. They can acquire special products available to those who are JAXA-approved directly from the SFTP server.
• How to Register as a G-Portal User:
  • Click on “User registration” from the left menu.
  • Read and agree to the terms of service by clicking “I Agree – Continue”.
  • Enter all required user registration information (user account, password, name, email address, etc.).
  • Review the entered information and click “Register” to complete provisional registration.
  • An email with temporary registration details will be sent. Access the URL provided in the email to finalize registration.
  • Once registration is complete, you will receive a User Registration Complete Email with your user account.

FAQs

• Q: Can guest users order products on G-Portal?
  • A: No, guest users can search and browse data online but cannot order or acquire products.
• Q: What services are available to Specific Users in G-Portal?
  • A: Specific Users, who are collaborator specially permitted by JAXA, can acquire special products directly from the SFTP server in addition to standard products available to registered users.

“`

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
Registered User
Specific User

Users who have not completed user registration
Users who have completed user registration
Register users, collaborator specially permitted by JAXA

Search and browse data online. Note that guest users are unable to order or acquire products. Search, browse, product, process and acquire standard products online. Acquire standard products and some near real-time products directly from the SFTP server. 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.
(1) Click “User registration” from the left menu.
1. Click “User registration”

2. Please check “I agree with the above terms of service”
2. Click “I Agree – Continue”

(2) 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.

(3) Enter all user information to be registered (user account, password, name, email address, organization, department, country, language, purpose of use, email delivery preference).

3. Enter user registration information

4. Click “Next”

(4) 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).

5. Confirm user registration information 6. Click “Register”

(5) 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.
(6) Click the “Register” button to perform the provisional registration procedure.

7. Temporary registration has done. 8. Registration has completed.

(7) 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.
(8) 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.

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 GPortal 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.
(1) Click “login” at menu on a left pane of the top window. Appear the login window.
1. Click “Login”

2. Enter user account and password

(2) Input your user account and password in login window. Click “login” button.

2. Click “Login”

(3) After login successfully, the “login” button at menu on left pane of the top window switches “logoff: [account name]” button.

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.

host port protocol user name password
Private key * Specific user only

ftp.gportal.jaxa.jp 2051 SFTP User account registered in G-Portal Password registered in G-Portal (Used for account authentication) 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 >_________________________________________ is displayed.

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 >

_

is displayed.

List view

Enter:

sftp > ls

_

to display a list of files and directories.

Change directly

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.”
(1) After logging in to the system, click “Account service” on the menu to display the user account service screen.
(2) 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.
(3) 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 GPortal. With this method, the public key is registered automatically, so you do not need to register it yourself.
(1) After logging in to the system, click “Account service” on the menu to display the user account service screen.
(2) 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.

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
(1) Download WinSCP Installer from the following site. WinSCP download site: https://winscp.net/eng/download.php
(2) Start WinSCP Installer. (3) Select “English” (1), and click [OK] (2).
(4) Click [Next] (3).

(5) Select “I accept the agreement” (4), and click [Next] (5). (6) Select “Typical installation (recommended)” (6), and click [Next] (7).

(7) Select “Commander” (8), and click [Next] (9). (8) Click [Install] (10).

(9) WinSCP is installed successfully, you will see the following window. Click [Finish] (11).
Connect SFTP (Account authentication) (1) Start WinSCP. (2) Select “SFTP” for the File protocol. (1) (3) Enter “ftp.gportal.jaxa.jp” as the host name. (2) (4) Enter “2051” for port number. (3) (5) Enter the user account registered in G-Portal as “user name”. (4) (6) Click [Login] to connect SFTP. (5)

(7) Enter the password registered in G-Portal and click [OK]. (6)
(8) 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.

Connect SFTP (Public key cryptographic authentication * Specific user only) (1) Start WinSCP. (2) Enter “ftp.gportal.jaxa.jp” into “Host name”. (1) (3) Enter “2051” into “Port number”. (2) (4) Enter the user account registered in G-Portal as “User name”. (3) (5) Click [Advcanced…] (4) to set private key file.

(6) Select “Authentication”. (5) (7) Select private key file that you created into “Private key file”. (6) (8) Click [OK]. (7)
(9) Click [Login] (8) to SFTP login.

(10)If you have set a password to decrypt the private key, click [OK] (10) button to enter the password (9) that you set.
(11)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.

What is the G-Portal

Globe Portal System (G-Portal) is online dissemination service of valuable products
acquired from sensors on Earth Observation Satellites of Japan Aerospace Exploration
Agency (hereafter, JAXA).
All you can use the service to cross-search products from JAXA’s many earth
observation satellites and sensors, and registered users can acquire products.
1.1. Data Policy
Precautions when using G-Portal data are as follows.
 Data is provided via the internet/an online environment.
 The offer target is a free distribution product. (Products with paid distribution are not
handled)
 Costs for providing the data are free of charge provided that no additional costs are
incurred by JAXA.
 Anybody is free to use the system, including those interested in the global environment,
or those interested in making a positive contribution to society through the use of
earth observation data.
Privacy policy when you register a user is handled in the following manner.
Your registered personal information is used to identify how the service is being used,
and to implement improvements to the service into the future. This information may also
be used to notify or contact users when JAXA conducts survey (questionnaires) regarding
improvements to system functionality.
Please refer to the Term of Use for furter information of usage. And also please refer to
the JAXA site policy (http://www.jaxa.jp/policy_j.html) for further details on the data
policy and handling of privacy policy

1.2. G-Portal user types
User types for G-Portal is outlined in Table 1.2-1. You are recommended to complete
user registration first in order to acquire products without restrictions (See “2. Register
User”).
Table 1.2-1 User Type
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, produce, process and
acquire standard products online.
Acquire standard products and near
real-time products directly from the
SFTP server.
Specified
User
Register users, collaborator
specially permitted by JAXA
Search, browse, produce, 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.

1.3. User types and service content
The service content of G-Portal is outlined in Table 1.3-1 below. The type of service
content differs depending on user types.
Table 1.3-1 Product Services for Each Type of User
Provided Service Chapter,
Section
Applicable Users
Guest
Users
Registered
Users
Specified
Users
User Authentication 2.2 － ○ ○
User Registration 2.1 ○ － －
Change user information 5.2 － ○ ○
Delete user information 5.3 － ○ ○
Change password 5.4 － ○ ○
Reissue password 2.3.2 － ○ ○
Public key registration 3.3.1 － － ○
Browse notifications (system
maintenance information, release
information, Web page update
information)
6.5
○ ○ ○
Search and browse products 4.1 ○ ○ ○
Download products（WEB） 4.3 － ○ ○
Download products(SFTP) (*2) 3 － ○ ○(*1)
Produce the product 4.4 － ○ ○
Process a product 4.5
4.6 － ○ ○
Browse and acquire spacecraft
sensor operating information (such
as quality information, data missing
information, TLE information, orbit
information)
6.2.1
○ ○ ○
Browse and acquire product
documentation (such as user’s
manual, format definitions)
6.3
○ ○ ○
Browse and acquire tools related to
products
6.4
○ ○ ○
Send inquiries to the support desk 7 ○ ○ ○

Register User

2.1. User registration
You must complete user registration to order and download products using this service.
The following outlines the procedures required for user registration.
1) Click “User registration” from the
menu.
2) To register a user, you must agree to
the terms of use. Read through the
terms and click the “I Agree – Continue”
button. The page will move to the
“User Registration window”.
User registration is not possible if you
do not agree to these terms, and use the
service as a guest user.
*If you check “I agree to the above
terms of service” for all terms of use,
you will be able to click the “I Agree –
Continue” button.
3) Enter all user information to be
registered (user account, password,
name, email address, organization,
department, country, language, purpose
of use, email delivery preference).
4) 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).
5) The entered user information will be
displayed, so check if there is any
mistake in the contents. To correct,
please click the “return” button. You
will return to the screen for entering
user information.
6) Click the “Register” button to
perform the provisional registration
procedure.
7) 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 provisional registration,
you can not log in because user
registration has not been completed
yet.
8) 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.

2.2. Login to the system
You can login to the system using a user account that has been registered in advance
(see “2.1 User registration” for the registration method) to order and download products
using G-Portal. See “1.2 G-Portal user types” for user type and usage restrictions.
2.2.1. Login on the top window

1) Click ”login” at menu on a left pane
of the top window. Appear the window
for the login.
2) Input your user accounts and
password as the login window is
displayed. Click “login” button.
3) After login successfully, The “login”
button at menu on left pane of the top
window switches “logoff: 【account
name】”button.

2.2.2. Login on the search window
1) Click the login button on the search
header and appears the pop-up login
dialog.
2) Input your user account and
password while login dialog is
appeared.
3) “Login” button on the header of the
search window switches after login
successfully.
2.2.3. Login on a pop-up window
1) The pop-up “login”window appears
through
https://gportal.jaxa.jp/gpr/auth

2) Input your user account and password and click the login button.
3) With login successfully, move to the top window.

2.3. Troubleshoot for login
2.3.1. If you have forgotten your user account
The G-Portal can automatically resend User Account Notification Email if you have
forgotten your user account.
1) Click “login dialog”or “Here, you
lose your user account
information.”link and appear the
window for informing your account
information again.
2) Input the registered e-mail address
on the G-Portal application.
3) Click the button “notify the user
account and the notification to the
e-mail address sent.

How to download products directly

It describes the procedure to download the product directly using SFTP protocols.
Using SFTP is permitted only for specific users.
3.1. Products that can be downloaded by SFTP
For SFTP, products to be downloaded are “standard product” and “near real time
product”. Regarding “standard product” and “Near real time products”, the range that can
be referred to differs depending on the belonging group.
All registered users can connect using the account authentication, but only specific
users can connect using the public key cryptography

3.1.1. Directory structure
 Directory structure of standard product
The directory structure of the standard product is as follows.
 Directory structure of quasi real-time products
The directory structure of the near real time product is as follows.

 

3.2. Downloading FTP-based products
Direct downloading via FTP will no longer be available from April 2025. Direct
downloading via SFTP will continue to be available, so please refer to “3.3. Downloading
products using SFTP”.

3.3. Downloading products using SFTP
For direct acquisition using SFTP, account authentication or user authentication by
public key cryptography is performed. Account authentication is available to all registered
users, but public key cryptography is available to specific users only.
When performing user authentication by public key cryptosystem, it is necessary to
create private key / public key beforehand and register its public key in G – Portal. Please
refer to “Create your private key · Public key yourself”, “Register public key” or “Download
private key created with G-Portal” for creating and registering private key · public key.
For the directories that can be accessed, please refer to “Products that can be
downloaded via SFTP” “Directory configuration”, for downloading methods using SFTP,
please refer to “How to download using SFTP”.
Depending on the organization to which the user belongs, access to the outside by
SFTP may be prohibited by policy. In that case, please consult with your network
administrator of your organization. G-Portal uses 2051 instead of normal 22 for the TCP
port used for SFTP in consideration of safety.

3.3.1. How to create private key and public key by yourself
(Specific use only)
This procedure is unnecessary when you take means of “Download private key created
by G-Portal” to be described later. This procedure is for UNIX(including Mac OS X),
Linux, Cygwin users to create private key and public key using commands.
(1) Open the terminal and execute the following command. (If it can not be executed,
check whether ssh is installed.)
$ ssh-keygen
(2) The following message for requesting the save directory and save name of the
public key / private key is displayed.
Enter file in which to save the key (/Users/[UserName]/.ssh/id_rsa):
To specify the save directory and save name, enter the directory name and save
name.
If you press enter without entering anything, id_rsa (private key) and id_rsa.pub
(public key) will be stored in the default directory / Users / username /.ssh.
(3) The following message will be returned requesting the passphrase for decrypting
the private key.
Enter passphrase (empty for no passphrase):
To set the password to be entered when connecting SFTP, enter the password.
This completes the creation of the public key / private key in the set directory.

3.3.2. Register public key (Specific use only)
In order to do a direct acquisition using SFTP, register the created public key in G –
Portal. (Please do not register private key.The private key is used to access SFTP server.)
(1) After logging in to the system, click “Account service” on the menu to display the
user account service screen.
(2) 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.
(3) With the “Upload” button, the specified public key is registered in this system.

3.3.3. How to acquire the private key and automatically register
the public key using the function of G-Portal (Specific use
only)
This chapter explains how to acquire the private key and register the public key
automatically using the function of G-Portal. If you take this means, your public key will
be automatically register to G-Portal. Therefore, you should not register your public key
by yourself. And if you take means “How to create private key and public key by yourself”
and “Register public key” to be described later, you don’t need to this procedure.
(1) After logging in to the system, click “Account service” on the menu to display the
user account service screen.
(2) 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 GPortal.

Change User Property To Change Password

5.1. Check registered user property
Check the properties of registered users.
1) Click “Account service”on the home
window and “Account service
window”appear.
2) Click “Change User information” on
the account service window. The
change of User information displays.
3) Check the registered user property.

5.2. Change user property
Change the properties of registered users.
1) Correct the items you want to change
via the View/Change User Property
window. Items that can be changed are
the name, email address,
organization/department, country name,
language used for email, purpose of use,
Notification Email for ready.
2) Click the “Change” button to change
the user information.
3) Confirm the change for User
property.
4) Click “Register” button under
checking User property.
5) The User Property Change
Completed window will be displayed.

5.3. Delete user property
Delete the property of registered users.
1) Click to “Erase User Information”on
the account service window. Appears
the confirmation window to erase User
Information.
2) Check the user property to be deleted.
3) Click “Delete” to delete the user. The
Deletion Complete window will be
displayed, and the user account will be
deleted. If you do not want to delete the
user account, click the “Cancel” button.
The window will return to the user
account service window.
4) The User Property Deletion Complete

5.4. Change passwords
Change the password of registered users.
1) Click “Change Password” in the User
account service window. A window
where you can change the password will
be displayed.
2) Enter your current password.
3) Enter a new password.
4) To change the password, click the
“Change Password” button. The
Change Complete window will be
displayed, and the system will be
updated with the new password.
If you do not want to change the
password, click the “Cancel” button.
The window will return to the User
account service window.
5) The Password Change Complete
window will be displayed.

Obtain Information on Products

6.1. Checking the provided spacecrafts/sensors and physical quantities
The satellite sensors provided on the G-Portal can make sure (confirm) “the product
information・mission control information”and “ Tool and Document”windows and
physical quantities displayed for“Beginners”or the guidance on the research window.
(1) Check spacecrafts/sensors
The satellite sensors Provided on“Product information・mission controll information”
and “ Tool・Document”were shown.
(2) Check physical quantities
The pysical quantities provided by“Beginners”or the guidance on research display was
shown.

6.2. Spacecrafts/sensors operational information
Information that JAXA requires to operate its spacecrafts/sensors is available as data
called Operational Information that may be valuable to users that are using products. Feel
free to check this information when using products.
The provided Operational Information is as follows.
 Orbit information
 Quality information
 Missing information
 Orbit control information
 2Line orbit element (TLE)
 Operational mode transition history
 Maneuver information
etc.

Click to“Product information/operation”on the
top window. Confirm mission information
relate to spacecraft sensors.

6.3. Download documents
Product format descriptions, algorithm descriptions and other generation
documentation is provided for each mission.
Click to“Tool/documents”on the top window.
Appears the window for downloading/a list of
document.

6.4. Download the tool kit
A range of tools are available to help utilize the available products. Please forward any
enquiries such as usage methods or operating environment directly to the tool developer.
Click to“Tool/documents”at the menu on the
homr window. Display the window for
downloading “Tool kit”.

6.5. Check announcements
You can confirm the announced information“Oshirase(notice)” from G-Portal with
clicking “Oshirase(notice)” on the top menu.
Click “Oshirase(Announcement)”on the home window, The announcement
information from G-Portal can confirm.

Other References

8.1. Recommended browsers
The following browsers are recommended to ensure that G-Portal functions smoothly
and properly. Recommended browsers are those that have already been checked as
functioning properly. Some windows may not be displayed properly when using the
system on browsers other than those that are recommended.
JavaSctipt This site uses content that operates on JavaScript. To use this service,
Javascript must be enabled in your browser.
Compatibility
View Settings
When “jaxa.jp” is set in the Compatibility View Settings, it is necessary
to delete it.
OS version Browser Browser version
Windows10 Microsoft Edge 89.0.774.45
Windows10
Firefox 86.01
Windows10
Chrome 80.0.3987.100
macOS Catalina 10.15.7
Chrome 89.0.4389.90
macOS Catalina 10.15.7
Safari 14.0.3
※As of June 9, 2022

Appendix 1 Map Operations
This section outlines the map operations that can be used in the enter search conditions
window.
1) Switch map view/satellite view
The view can be changed from
map view to satellite view.
2) Change scale
Click the “+” symbol to zoom into and display the map at one larger scale. Click the “-”
symbol to zoom out and display the map at one smaller scale.
Move the slider up and down to display the map at a scale of your own choice. If you
have a mouse with a mouse wheel, you can also use the mouse wheel to change the zoom
scale.
3) Move
Click this icon to you can move the display region of the map.
4) Specify search region
Click this icon to you can specify search region
specify format depends on the currently selected tab.

Documents / Resources

G-Portal G-Portal Web Service [pdf] User Guide G-Portal Web Service, Web Service, Service

References

• User Manual