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 | ||||||
---|---|---|---|---|---|---|
| ||||||
{"diagramDefinition":"flowchart LR\nX(GlobalScope)\nA(Reseller<br/>enterprise)\n\nsubgraph ResellerScope\n A\nend\nX-->ResellerScope"} |
To create a reseller scope:
...
\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 H\nend\n\nsubgraph Reseller hierarchy\n direction LR\n ResellerScope-->ACustomerScope\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:
Create public cloud regions for your public cloud providers. See Create a public cloud region
Go to Users → Scopes and Create a reseller scope:
Make the Name descriptive, for example,
ResellerNameScope
For the Parent scope select the
Global scope
(recommended) or no scopeFor 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.
Go to Users and Create a reseller enterprise:
For the Default scope select the reseller scope, for example,
ResellerScope
ResellerNameScope
Select the Reseller checkbox
If the reseller will use a different its own mail server to the cloud platform, enter the details of the Mail server
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
...
, as in the scope.
...
Onboard an Azure CSP account
To an onboard Azure CSP account:
Do the steps at: to Obtain Azure ARM pricing credentials for CSP
In To add the Azure credentials in Abiquo, edit the reseller enterpriseFor
Go to Credentials → Pricing, and add the Azure CSP pricing credentials
as follows
API key:
csp#tenantId#clientId#accessToken#refreshToken
API secret key: the password for the application
Go to Properties, and to use Azure billing, enter the
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:
azurecompute-arm_discount =
0
azurecompute-arm_currency_code =
USD
billing.azure.country_code =
US
azurecompute-arm_price_factor =
1
(deprecated in Abiquo 6.1)
For Abiquo 6.1 and above, go to Pricing → Price factors and create a price factor for the reseller enterprise. See Manage price factors.
5. Create a reseller customer scope
You can create a tenant hierarchy with a reseller scope at the top level and the customers below that. To create customers of your reseller, for each customer, create a customer scope and set the reseller scope as the parent scope.
Mermaid | ||||||
---|---|---|---|---|---|---|
| ||||||
{"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\n Customer1Scope\nend\nsubgraph GlobalScope\nend\nGlobalScope-->ResellerScope\nResellerScope-->Customer1Scope"} |
...
Onboard an AWS organization account
To onboard an AWS organization account:
Log in to the AWS management account.
Create a user with the security policy for AWS organization pricing
Edit the Abiquo reseller enterprise:
Go to Credentials → Pricing and add the user credentials
Go to Properties and https://abiquo.atlassian.net/wiki/spaces/doc/pages/311372049/Display+Amazon+billing+data#Configure-resellers-in-Abiquo
For Abiquo 6.1 and above, go to Pricing → Price 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:
Create a customer scope:
Go to Users → Scopes and click the + add button (or
edit an existing customer scope)
For the Name, we recommend that you
include the customer name
Scope
, for example,
Customer1Scope
CustomerScope
For the Parent scope, select the reseller scope, for example,
ResellerScope
.
For the Entities, select the datacenters and public cloud region/s.
...
Create
...
For each customer of the CSP, create a key node enterprise with the customer scope.
Mermaid | ||||||
---|---|---|---|---|---|---|
| ||||||
{"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"} |
...
a customer enterprise:
Go to Users view and at the bottom of the Enterprises list, click the + add button
For the Default scope, select the customer scope, for example,
Customer1Scope
CustomerScope
Select the Key node checkbox to support
Office365 customers
, Multiple Azure subscriptions (Plans)
, and AWS organization accounts, and so on
For Properties,add tenant metadata as required
7. Create customer subtenants
For each subscription in an Azure plan or AWS organization, create a standard enterprise:
Create a standard enterprise (not a key node)
For the Default scope, select the
CustomerScope
...
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:
Under the reseller, edit the customer, key node (for Azure Plans and Office 365), or standard enterprise
Go to Credentials → Public
For the Access key ID, enter the customer’s
TenantID
Select Only for billing
Click Add account to save the credentials. The platform will not validate the account details until it retrieves billing data from the provider
Click Save
...
Onboard an AWS customer
To onboard a customer of an AWS organization:
Under the reseller scope: https://abiquo.atlassian.net/wiki/spaces/doc/pages/311361611/Abiquo+cloud+reseller+guide#Create-a-scope-for-a-reseller-customer
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
Create a standard enterprise in the customer scope
Log in to AWS and in the customer account, create a user
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 | ||||||
---|---|---|---|---|---|---|
| ||||||
{"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<brStandard<br/>enterprise>enterprise1)\nC-.--F(Subscription1Account1)\nD-.--E(Subscription2Account2)\nA--.-P(Pricing<br/>credential)\nsubgraph ResellerScope\n A\n P\nend\nsubgraph Reseller hierarchy\n direction LR\n ResellerScope-->Customer1Scope\nend\nsubgraph GlobalScope\nend\nGlobalScope-->ResellerScope\nn 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:
Create a standard enterprise (not a key node)
For the Default scope, select the
Customer1Scope
To give the customer access to compute and billing features:
Create an app in the customer’s Active Directory.
Edit the standard enterprise, and go to Credentials → Public
Add the credentials for the Azure plan in the format
Subscription#AppID#TenantID
Go to Properties and add
azurecompute-arm_only_bill_subscription
and set the value totrue
OR
To give the customer access billing features only (including dashboard display, and billing of Office 365):
...
Edit the standard enterprise, and go to Credentials → Public
...
For the Access key ID, enter the customer’s Azure plan details in this format: Subscription##TenantID
...
For the Secret access key, enter any value
...
Select Only for billing
...
Click Add account to save the credentials. The platform will not validate the account details until it retrieves billing data from the provider
...
Go to Properties and add azurecompute-arm_only_bill_subscription
and set the value to true
...
onboard an AWS organization into a key node enterprise
Create a customer scope under the reseller scope
Create a key node enterprise in the customer scope
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:
Create a standard enterprise in the scope of the key node
Log in to AWS and in the customer account, and create a user.
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 Credentials → Pricing 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