Skip to main content

Connect your Scaleway account

Holori offers a Scaleway Finops solution to help you track and optimize Scaleway cloud costs.

To retrieve your cost data, Holori needs to be granted an access to your Scaleway cloud account. The following procedure will guide you through the required steps.

tip

You can either connect your Scaleway account via CLI or via the Scaleway Portal. The option 1 presented hereafter is via the portal, the option 2 via CLI.

In Holori App, click on your username at the bottom left of the page, then select the ""Integrations" tab and click on "+Connect now" under the Scaleway logo.

Screenshot

Option 1: Connect your account using Scaleway console​

Step 1: Create an IAM Application​

  • From your Organization Dashboard, click on "Manage Identity and Access with IAM". Then click on the "Application" tab. Alternatively, directly navigate to the Application tab using this link: https://console.scaleway.com/iam/applications

Screenshot

  • Click on "+ Create Application".

Screenshot

  • Fill in the required information, choose a name, for example "holori" in the example below.

  • Click on "Create Application" at the bottom of the page.

Screenshot

Step 2: Grant the Application access to the API​

Screenshot

  • Select "An application" as the key bearer, and then pick the one you just created (holori in our example), leave default settings as shown:

Screenshot

  • Copy and paste the access key id and secret key in Holori App.

Step 3: Grant read-only permission on cost and usage to the application​

Screenshot

  • Click on "+ Create Policy"

  • Give the policy a name, a description (optional) and tags (optional). Select an Application as the target, and pick the one you created just before (holori in our example).

Screenshot

  • Click on "Add rules".

  • On the following page, select "Access to Organization features" as the scope and validate.

Screenshot

  • On the next page, select "BillingReadOnly" permission sets from the Billing category, and validate.

Screenshot

  • On the final validation page, click on "Create Policy".

Step 4: Get the Organization and Project ID​

  • Go back to your organization's Dashboard, open the "Projet" tab. Alternatively, use this link: https://console.scaleway.com/organization/projects

  • Back on the organization dashboard, copy the "organization id" and the "default project id". Paste them into Holori app.

Screenshot

Option 2: Connect your account using CLI​

Prerequisite​

You need to have already set your CLI up. If not done already, refer to this guide. https://www.scaleway.com/en/docs/developer-tools/scaleway-cli/quickstart/

  • Check if Default Organization id is the one you want to connect to Holori app:
scw config get default-organization-id

  • If it’s the right one, copy it and move to the next step.

  • If it’s not, you’ll need to navigate to the organization dashboard (https://console.scaleway.com/organization) and select the one you want to connect to. Then, get its ID and save it for later, you’ll need to include it in commands when specified.

Get the Organization and Project ID​

  • Paste the organization ID from the previous step in the Holori app.

  • Run the following command:

scw account project list [organization-id=ORGANIZATION_ID if different than default_organization_id]
  • Copy the id of the project you want to use as default and paste it in the Holori app.

Create an IAM Application​

scw iam application create name=holori [organization-id=ORGANIZATION_ID if different than default_organization_id]
  • Copy the ID of the newly created application and save it for later.

Grant the Application access to the API​

scw iam api-key create application-id=APPLICATION_ID
  • Copy and paste secret key and access key to Holori App

Grant Read Only Permission on cost and usage to the Application​

scw iam policy create name=holori  application-id=APPLICATION_ID rules.0.permission-set-names.0=BillingReadOnly rules.0.organization-id=ORGANIZATION ID [organization-id=ORGANIZATION_ID if different than default_organization_id]