Audience

This article is to support customers of Runner, a product that enables teams, developers, and engineers to quickly provision, interact, and modify their environments anywhere - CenturyLink Cloud, third-party cloud providers, and on-premises. Additionally, the responses in this FAQ document are specific to using the service through the Control Portal.

Service Account Overview

The Service Account alias is a secure store of a users credentials. These credentials are associated with a Job and a Schedule. When the schedule fires these credentials will be used to authenticate to CenturyLink Cloud to retrieve the necessary tokens to execute the job. The credentials are stored in a secure format separate from the job definition and other account identifying elements.

• Create Service Account via Runner UI
• Create Service Account via Runner API
• Get Service Account via Runner API
• Update Service Account via Runner API

Create Service Account via Runner UI

1. To create a Service Account through the Runner UI, first click the Help & Settings drop-down and select Settings.

   

2. On the left side, select Service Accounts and this will bring up a view showing you all of your existing Service Accounts. Click on the add button and a form will appear where you can enter the required information.

   

3. Input the following information:

   • The Service Account Alias, this can be anything you want but it should be descriptive.
   • The CenturyLink Cloud User Name that you want associated with this Service Account.
   • The password that corresponds with the User Name you entered above.

4. Click the Save button and your service account will be created.

Create Service Account via Runner API

The Service Account alias is a secure store of a user's credentials. These credentials are associated with a Job and a Schedule. The credentials are stored in a secure format separate from the job definition and other account identifying elements. Calls to this operation must include a token acquired from the authentication endpoint. See the Login API for information on acquiring this token.

When to use it

Use this API to create Service Account alias under your CenturyLink Cloud account and use this alias for executing scheduled jobs.

URL

Structure

POST https://api.runner.ctl.io/serviceAccounts/{accountAlias}

Example

POST https://api.runner.ctl.io/serviceAccounts/XXXX

Request

URI Parameters

Entity Definition

Response

The response will list the details of the new Service Account alias created.

Entity Definition

Example

{
  "id": "729e3136-c474-42fb-976e-53786f5fb000",
  "accountAlias": "XXXX",
  "alias": demo-account-service-account1,
  "username": "your-username",
  "password": "your-password"
}

Get Service Account via Runner API

The Service Account alias is a secure store of a users credentials. These credentials are associated with a Job and a Schedule. The credentials are stored in a secure format separate from the job definition and other account identifying elements. See the Login API for information on acquiring this token.

When to use it

Use this API to view all the Service Account alias under your CenturyLink Cloud account alias.

URL

Structure

GET https://api.runner.ctl.io/serviceAccounts/{accountAlias}

Example

GET https://api.runner.ctl.io/serviceAccounts/XXXX

Request

URI Parameters

Response

The response will provide an array of all Service Account alias created under your CenturyLink Cloud Account.

Entity Definition

Example

{
    "accounts": [
        "demo-account-service-account1",
        "demo-account-service-account2",
        "demo-account-service-account3",
        "demo-account-service-account4"
  ]
}

Update Service Account via Runner API

The Service Account alias is a secure store of a users credentials. These credentials are associated with a Job and a Schedule. The credentials are stored in a secure format separate from the job definition and other account identifying elements. See the Login API for information on acquiring this token.

When to use it

Use this API to update your existing Service Account alias credentials under your CenturyLink Cloud account.

URL

Structure

PUT https://api.runner.ctl.io/serviceAccounts/{accountAlias}/{serviceAccountAlias}

Example

PUT https://api.runner.ctl.io/serviceAccounts/XXXX/demo-account-service-account1

Request

URI Parameters

Entity Definition

Response

The response will contain the updated Service Account alias details.

Entity Definition

Example

{
  "id": "729e3136-c474-42fb-976e-53786f5fb000",
  "accountAlias": "XXXX",
  "alias": demo-account-service-account1,
  "username": "Updated - username",
  "password": "Updated - password"
}