A Service Account is an identity you create within your Root User account that has specific permissions. It shares some similarities with an IAM User Account. To clarify, both Service Accounts and IAM User Accounts are identities with permission policies that define what they can and cannot do with Greennode AI Platform resources. However, a Service Account is used by an application or machine, not a person, to make authorized API calls and access specific resources.
Step 1: Create a Service Account
To create a new Service Account:
- Access the IAM Console: https://iam.console.greennode.ai/
- Click on "Service account" in the left menu.
- Click "Create service account."
- Enter the Service Account information, including name and optional description.
- Attach the necessary policies.
- Review the settings and click "Create service account" in the upper right corner.
- Save the Client Secret Key information.
Tip: Be sure to save the Client Secret somewhere safe, as it is only displayed once.
Step 2: Assigning Permissions to a Service Account
To attach policies to a Service Account:
- Access the IAM - Service Account page at: https://iam.console.greennode.ai/service-accounts
- Log in as the Root User or a User Account with appropriate permissions. You will need to provide your username/email and password.
- Search for the Service Account by entering its name in the search bar and selecting the correct result.
- By default, you will see the "Permissions" tab on the Service Account details page.
- Click the "Attach Policies" button, and a window will pop up containing all policies.
- Search for existing policies by entering the exact policy name in the search bar.
- Select the policies from the search results and click the "Attach" button in the lower right corner of the popup window.
- Your Service Account will now have all the permissions contained in the attached policies.
Step 3: Managing Service Account Credentials
A Service Account includes credentials (Client ID and Secret Key). You need to store the Secret Key or download it after creating the Service Account. However, you can also recreate the Secret Key at any time.
- Access the Service account page in the IAM Console: https://iam.console.greennode.ai/service-accounts
- Log in as the Root User or a User Account with appropriate permissions. You will need to provide your username/email and password.
- Search for the Service Account by entering its name in the search bar and selecting the correct result from the list.
- Click the "Security credentials" tab in the Service Account details. You will see information as shown below, and you can perform the following actions:
- Copy the Client ID.
- Reset the Client Secret and remember to save the new Secret.
- Activate/Deactivate the Service Account by changing the Status.
Step 4: Deleting a Service Account
You can delete a Service Account by following these two options:
- Delete multiple Service Accounts at once:
- Access IAM with the Root User Account.
- Click on "Service account" in the left menu.
- Select the Service Accounts you want to delete (a "Delete" button will be enabled in the upper right corner when you select at least one account).
- Click the "Delete" button. A confirmation dialog will appear to ensure you are not deleting the wrong accounts. Then, click the "Confirm" button to complete the process.
- Delete a single Service Account: We recommend accessing the details of the Service Account and deleting it from there to ensure you are not deleting the wrong account.