How To: Register for Starlink Cloud

Keywords: Starlink Cloud, Kognitive Cloud, Service Account

1 How To Create a New Service Account From Starlink Account Homepage

To create a Service Account from the Starlink Account Homepage, follow the below steps:

• Open the Starlink account home page. Login with the valid Starlink account credentials.

• Scroll down to the "Your Service Accounts" section.

• Select the "+" in the top right corner to create a new service account. The Create Service Account dialog box opens.

• If you do not see the section "Your Service Accounts" reach out to your Starlink account manager to inquire about access.

• Fill in the following fields as applicable:

  • "Name" - Name for the service account

  • "Secret" - The secret for the service account that will be used for authentication

  • "Grant Type" - Select "Client Credentials".

• Now that the service account is created, a system-generated client ID will populate. The client ID will be displayed in the "Your Service Accounts" section on the Starlink Account Homepage.

• This client ID can be used in combination with your client secret to request an authorization token to be able to call available API end points.

2 How to Link the Service Account To Kognitive Cloud

• Login to the Kognitive Cloud using valid credentials.

• Select the Starlink option from the left menu bar.

• Click the Admin tab.

• Click Link Service Account to link a Starlink service account.

• There are two methods to link a service account.

  • Service Account Client

  • Web Portal

2.1 Method 1 - Service Account Client

• If the User is a ‘reseller’ of Starlink services and/or has Starlink API Telemetry access, the User will be given a Client ID and Client Secret to gain access to the Starlink Cloud Telemetry API.  Please reach out to Starlink directly for any API access detail issues.

• To use the Starlink Account Client method, the user must first create a Service Account from the Starlink Account Homepage. Refer section How To Create a New Service Account From Starlink Account Homepage for more information.

• After creating a service account, select the Service Account Client option.

• Enter the Client ID generated while creating the Starlink service account.

• Enter the Client Secret provided while creating the Starlink service account.

• Click Add.

• The system validates the user credentials and if the validation is successful, the user is directed to the next step – Associating Service Line to Sub-Organization. Refer to section How to Associate Service Line to Sub-Organization for more information.

2.2 Method 2 - Web Portal

• Select the Web Portal option.

• Enter the registered Email Address of the Starlink Service Account.

• Enter the Password.

• Click Add. The user is directed to the next step – Associating Service Line to Sub-Organization. Refer to section How to Associate Service Line to Sub-Organization for more information.

3 How to Associate Service Line to Sub-Organization

• Select the Service Line from the dropdown menu.

• Select the Sub-Organization from the dropdown menu. The dropdown menu consists of all the available sub-organizations.

• If the user wants to associate the Service Line to a new Sub-Organization, select New Sub-Organization button.

• Select the Parent Organization from the dropdown menu.

• Enter the new Sub-Organization name.

• Click Create button. The new Sub-Organization will be created.

• In the Sub-Organization field, select the required Sub-Organization.

• Click Assign to associate the Service Line with the selected Sub-Organization.

4 Service Differences for Access Types

The Starlink Cloud Service has two methods by which Starlink Data can be accessed: Service Account Client and Web Portal.

4.1 Service Account Client

Service Account Client access is generally available to Starlink resellers to provide more complete metrics on terminal use, with data points on availability, latency, and throughput – among others. It requires API access to Starlink data through the internet, and the credentials must be added in Kognitive Cloud during account registration.

4.2 Web Portal

Web Portal access provides a limited amount of performance metrics but does show usage data. This metric is necessary for setting quota alerts on data usage.

The table below outlines the functionality provided for the two access methods.

Function	Service Account Client Method	Web Portal Method
Online/Offline
Usage
Drop Rate
Latency
Throughput
Obstruction or Alert Data

Click the Question mark icon on the Dashboard to view the difference between the two methods.