Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Info

This section page describes how to onboard an Azure CSP and/or an AWS organization account and its customers

1. Create public cloud regions

Create public cloud regions for Azure. For more details see Create a public cloud region.

2. Create a reseller scope

To use an Azure reseller (CSP) account, create a reseller scope for your reseller enterprise

into the multicloud platform as part of a reseller hierarchy.

Abiquo reseller hierarchy

This diagram shows a reseller hierarchy to manage Azure CSP or AWS organization accounts and their customers. The documentation below describes how to create this hierarchy.

Mermaid
fileNamemermaid_1675759715283
themeneutral
version1116
{"diagramDefinition":"flowchart LR\nX(GlobalScope)\nA(Reseller<br/>enterprise)\n\nsubgraph ResellerScope\nA(Reseller<br/>enterprise)\nB(ACustomer<br/>key node<br/>enterprise)\nB-->C(AStandard<br/>enterprise 1)\nB-->D(AStandard<br/>enterprise 2)\nC-.-F(ASubscription1)\nD-.-E(ASubscription2)\nG-.-H(BSubscription1)\nA-.-P(Reseller<br/>Pricing<br/>credential)\nG(BCustomer<br/>key node<br/>enterprise)\nsubgraph ResellerScope\n    A\n    P\nend\nsubgraph BCustomerScope\n    G \n    AH\nend\n\nsubgraph Reseller hierarchy base\n    direction LR\n        ResellerScope-->ACustomerScope\nend\nX-->ResellerScope"}

...

n        ResellerScope-->BCustomerScope\nend\nsubgraph GlobalScope\nend\nGlobalScope-->ResellerScope\n\nsubgraph ACustomerScope\n    direction LR\n        B\n        C\n        D\n        E\n        F\nend\n        style GlobalScope fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff\n        style A fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff\n        style P fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff,stroke-dasharray: 5 5\n        style B fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff\n        style C fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff\n        style D fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff\n        style F fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff,stroke-dasharray: 5 5\n        style E fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff,stroke-dasharray: 5 5"}

Prepare a reseller

To prepare a reseller in Abiquo:

  1. Create public cloud regions for your public cloud providers. See Create a public cloud region

  2. Go to UsersScopes and Create a reseller scope:For

    1. Make the Name

    , we recommend that you use the Reseller name + Scope,
    1. descriptive, for example,

    ResellerScope
    1. ResellerNameScope

    2. For the Parent scope select theGlobal scope (recommended) or no scope

      Create a reseller scope with the Global scope as the parent scopeImage Added
    3. For Entities, select your public cloud regions.

For full details, see Create a reseller scope

3. Create a reseller enterprise

You will need a reseller enterprise to manage the reseller credentials for your customers.

    1. Create a scope and select the public cloud regionsImage Added
  1. Go to Users and Create a reseller enterprise:

    1. For the Default scope select the reseller scope, for example, ResellerScope ResellerNameScope

    2. Select the Reseller checkbox

    3. If the reseller will use a different its own mail server to the cloud platform, enter the details of the Mail server

      Create a reseller enterprise and enter detailsImage Added
    4. For Datacenters, select the datacenters and public cloud regions that the reseller and its customers will use

For full details see Create a reseller enterprise

4. Add Azure reseller credentials and properties

In Azure, you can use reseller credentials (CSP credentials) or standard credentials. Follow the steps on these pages to obtain your Azure credentials.

    1. , as in the scope.

...

Onboard an Azure CSP account

To an onboard Azure CSP account:

  1. Do the steps to Obtain Azure ARM pricing credentials for CSP

...

  1. To add the Azure

...

  1. Edit credentials in Abiquo, edit the reseller enterpriseFor

    1. Go to Credentials → Pricing, and add the Azure CSP pricing credentials

    .
    1. as follows

      1. API keycsp#tenantId#clientId#accessToken#refreshToken

      2. API secret key: the password for the application

        Add Azure CSP credentials for the resellerImage Added
    For
    1. Go to Properties, and to use Azure billing, enter the

    billing enterprise properties in the reseller enterprise
    1. https://abiquo.atlassian.net/wiki/spaces/doc/pages/311372059/Display+Azure+billing+data#Enterprise-properties-for-the-Azure-reseller . The default values are as follows:

      1. azurecompute-arm_discount = 0

      2. azurecompute-arm_currency_code = USD

      3. billing.azure.country_code = US

      4. azurecompute-arm_price_factor = 1 (deprecated in Abiquo 6.1)

  2. For Abiquo 6.1 +and above, go to PricingPrice factors and create a price factor for the reseller enterprise. See Manage price factors.

5. Create a reseller customer scope

A reseller scope is at the top level of a tenant hierarchy. To create customers of your reseller, for each customer, create a customer scope and set the reseller scope as the parent scope.

Mermaid
fileNamemermaid_1675759715283
themeneutral
version6
{"diagramDefinition":"graph LR\nX(GlobalScope)\nX-->A(Reseller<br/>enterprise)\nA-->B(Customer1<br/>key node<br/>enterprise)\nsubgraph ResellerScope\n    A\nend\nsubgraph Customer1Scope\n    B\nend\n\nsubgraph Reseller hierarchy\n    ResellerScope\n    Customer1Scope\nend"}

...

Onboard an AWS organization account

To onboard an AWS organization account:

  1. Log in to the AWS management account.

  2. Create a user with the security policy for AWS organization pricing

  3. https://abiquo.atlassian.net/wiki/spaces/doc/pages/311372049/Display+Amazon+billing+data#Configure-AWS

  4. Edit the Abiquo reseller enterprise:

    1. Go to CredentialsPricing and add the user credentials

    2. Go to Properties and https://abiquo.atlassian.net/wiki/spaces/doc/pages/311372049/Display+Amazon+billing+data#Configure-resellers-in-Abiquo

  5. For Abiquo 6.1 and above, go to PricingPrice factors and create a price factor for the reseller enterprise. See Manage price factors.

...

Prepare to onboard a customer

To prepare Abiquo to onboard a customer:

  1. Create a customer scope:

    1. Go to UsersScopes and click the + add button (or

    select and
    1. edit an existing customer scope)

      1. For the Name, we recommend that you

    use
      1. include the customer name

    and Scope
      1. , for example,

    Customer1Scope
      1. CustomerScope

      2. For the Parent scope, select the reseller scope, for example, ResellerScope.

        Create a scope for a customer of a resellerImage Added
    1. For the Entities, select the datacenters and public cloud region/s.

...

  1. Create

...

For each customer of the CSP, create a key node enterprise with the customer scope.

Mermaid
fileNamemermaid_1675759715283
themeneutral
version8
{"diagramDefinition":"flowchart LR\nA(Reseller<br/>enterprise)\nB(Customer1<br/>key node<br/>enterprise)\nsubgraph ResellerScope\n    A\nend\nsubgraph Customer1Scope\n    B\nend\n\nsubgraph Reseller hierarchy\n    ResellerScope-->Customer1Scope\nend\nsubgraph GlobalScope\nend\nGlobalScope-->ResellerScope"}

...

  1. a customer enterprise:

    1. Go to Users view and at the bottom of the Enterprises list, click the + add button

    2. For the Default scope, select the customer scope, for example,

    Customer1Scope
    1. CustomerScope

    2. Select the Key node checkbox to support

    1. Office365 customers

    1. , Multiple Azure subscriptions (Plans)

    Other sub-tenants (e.g. AWS partner accounts)
    1. , and AWS organization accounts, and so on

       Create a customer enterprise that is a key nodeImage Added

    2. For Properties,add tenant metadata as required

    . This may include account IDs and discounts. You can also push this metadata to VM variables but do not use confidential data.

7. Create customer subtenants

...

  1. For each subscription in an Azure plan or AWS organization, create a standard enterprise:

    1. Create a standard enterprise (not a key node)

    2. For the Default scope, select the CustomerScope

       Create a standard enterpriseImage Added

...

Onboard an Azure customer for billing only

To give a customer access to billing features only for their tenant (including dashboard display), this section describes how to onboard a customer and all their subscriptions into a single tenant.

To onboard an individual subscription for billing only or to onboard an Azure subscription for compute and billing, see Add a subscription of an Azure reseller customer for billing only and

To onboard an Azure customer for billing only:

  1. Under the reseller, edit the customer, key node (for Azure Plans and Office 365), or standard enterprise

  2. Go to Credentials → Public

  3. For the Access key ID, enter the customer’s TenantID

    Add an Azure tenantID to identify a customer for billing onlyImage Added
  4. Select Only for billing

  5. Click Add account to save the credentials. The platform will not validate the account details until it retrieves billing data from the provider

  6. Click Save

...

Onboard an AWS customer

To onboard a customer of an AWS organization:

  1. Under the reseller scope: https://abiquo.atlassian.net/wiki/spaces/doc/pages/311361611/Abiquo+cloud+reseller+guide#Create-a-scope-for-a-reseller-customer

  2. In the customer scope, ereate a reseller customer as a key node https://abiquo.atlassian.net/wiki/spaces/doc/pages/311361611/Abiquo+cloud+reseller+guide#Create-a-reseller-customer

  3. Create a standard enterprise in the customer scope

  4. Log in to AWS and in the customer account, create a user

  5. In Abiquo, edit the standard enterprise and add the credentials as public cloud credentials.
    OR Add the account to the standard enterprise with public cloud credentials for billing only.
    See Add AWS and Azure credentials only for billing

...

Onboard an AWS organization into a key node

If your customer has an AWS organization account, you can onboard the organization into a key node hierarchy, by adding the pricing credential and accounts.

Mermaid
fileNamemermaid_1675759715283
themeneutral
version812
{"diagramDefinition":"flowchart LR\nA(Reseller<br/>enterprise)\nB(Customer1<br/>key node<br/>enterprise)\nB-->C>D(Subtenant1<brStandard<br/>enterprise>enterprise2)\nB-->D>C(Subtenant2<br/>enterprise)\nStandard<br/>enterprise1)\nC-.-F(Account1)\nD-.-E(Account2)\nA-.-P(Pricing<br/>credential)\nsubgraph ResellerScope\n    A\nend\nsubgraph Customer1Scope\n    BP\nend\nsubgraph Reseller hierarchy\n    direction LR\n        ResellerScope-->Customer1Scope\nend\nsubgraph GlobalScope\nend\nGlobalScope-->ResellerScope\n\n    B-.-PC(Pricing<br/>credential<br/>Organization2)\nsubgraph Customer1Scope\n    direction LR\n        B\n        C\n        D\n        E\n        F\n        PC\nend\nGlobalScope-->ResellerScope\n\n\n        style P stroke-dasharray: 5 5\n        style B fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff\n        style C fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff\n        style D fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff\n        style F fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff,stroke-dasharray: 5 5\n        style E fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff,stroke-dasharray: 5 5\n        style PC fill:#ec9032,stroke:#666,stroke-width:2px,color:#fff,stroke-dasharray: 5 5"}

To create a subtenant enterprise:onboard an AWS organization into a key node enterprise

  1. Create a customer scope under the reseller scope

  2. Create a standard enterprise (not a key node)

  3. For the Default scope, select the Customer1Scope

  4. To give the customer compute features, create an app in the customer’s Active Directory. In the standard enterprise, on the CredentialsPublic tab, add the credentials for the Azure plan.

  5. OR for the customer to use billing only (including dashboard display, and billing of Office 365), add the following credentials on the Credentials → Pricing tab:

  6. For the Access key ID use the format: Subscription##TenantID

  7. For the Secret access key, enter any value

  8. Select Only for billing

    key node enterprise in the customer scope

  9. Do the steps in “Onboard an AWS Organization” section using the new organization, but add the credentials to the key node as pricing credentials (instead of adding the credentials to the reseller as pricing credentials)

To add an existing account in this organization:

  1. Create a standard enterprise in the scope of the key node

  2. Log in to AWS and in the customer account, and create a user.

  3. In Abiquo, edit the standard enterprise and add the credentials as public cloud credentials.
    OR Add the account to the standard enterprise as public cloud credentials for billing only.
    See Add AWS and Azure credentials only for billing

Run billing

You can now run billing for the reseller:

  • Edit the enterprise and go to CredentialsPricing and click the right arrow button:

  • Or go to the Billing tab, select the provider, and click Regenerate billing.

You can try to run billing for the last 2 months to display it on the Abiquo dashboard

Or you can wait for the automatic billing process that will run every day. (You can Customize Abiquo billing dashboard processes and configure the billing run with an Abiquo property).

You can also set currency conversions for the billing dashboard. See Configure billing dashboard currency conversions .

Onboard VMs and resources

If the credentials have compute capabilities, and there are VMs for the subscription, you can capture the VMs to manage them with Abiquo by onboarding their virtual network or VPC to create a virtual datacenter in Abiquo. See Onboard from public cloud