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 - Lumen 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 Lumen 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
-
To create a Service Account through the Runner UI, first click the Help & Settings drop-down and select Settings.
-
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.
-
Input the following information:
- The Service Account Alias, this can be anything you want but it should be descriptive.
- The Lumen Cloud User Name that you want associated with this Service Account.
- The password that corresponds with the User Name you entered above.
-
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 Lumen 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
NAME | TYPE | DESCRIPTION | REQ. |
---|---|---|---|
accountAlias | string | Short code of your Lumen Cloud Account Alias. | Yes |
Entity Definition
NAME | TYPE | DESCRIPTION | REQ. |
---|---|---|---|
alias | string | Enter your Service Account Alias name. | Yes |
username | string | Your Lumen Cloud Account username. | Yes |
password | string | Your Lumen Cloud Account password. | Yes |
Response
The response will list the details of the new Service Account alias created.
Entity Definition
NAME | TYPE | DESCRIPTION |
---|---|---|
id | string | ID of your new Service Account Alias. |
accountAlias | string | Short code of your Lumen Cloud Account Alias. |
alias | string | Your Service Account Alias name. |
username | string | Your Lumen Cloud Account username. |
password | string | Your Lumen Cloud Account password. |
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 Lumen 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
NAME | TYPE | DESCRIPTION | REQ. |
---|---|---|---|
accountAlias | string | Short code of your Lumen Cloud Account Alias. | Yes |
Response
The response will provide an array of all Service Account alias created under your Lumen Cloud Account.
Entity Definition
NAME | TYPE | DESCRIPTION |
---|---|---|
accounts | array | List of Service Account Alias created. |
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 Lumen 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
NAME | TYPE | DESCRIPTION | REQ. |
---|---|---|---|
accountAlias | string | Short code of your Lumen Cloud Account Alias. | Yes |
alias | string | Your Service Account Alias name to be updated. | Yes |
Entity Definition
NAME | TYPE | DESCRIPTION | REQ. |
---|---|---|---|
username | string | Your Lumen Cloud Account username. | Yes |
password | string | Your Lumen Cloud Account password. | Yes |
Response
The response will contain the updated Service Account alias details.
Entity Definition
NAME | TYPE | DESCRIPTION |
---|---|---|
id | string | ID of your new Service Account Alias. |
accountAlias | string | Short code of your Lumen Cloud Account Alias. |
alias | string | Your Service Account Alias name. |
username | string | Your Lumen Cloud Account username. |
password | string | Your Lumen Cloud Account password. |
Example
{
"id": "729e3136-c474-42fb-976e-53786f5fb000",
"accountAlias": "XXXX",
"alias": demo-account-service-account1,
"username": "Updated - username",
"password": "Updated - password"
}