Registering credentials for Azure Resource Manager is a new and different process than registering for Azure “Classic”. You will be able to register only one ARM account per RS account, but a RS account can contain credentials for both Azure Classic and ARM.
You can no longer use personal accounts(gmail.com, live.com, hotmail.com) with ARM. You must authenticate with a corporate email, connected with your Azure AD Tenant.
This page walks you through the steps to connect your Azure Resource Manager account with RightScale for management purposes. If you are part of the Azure CSP program and wish to connect your partner data to RightScale for cost reporting purposes, see Connect Azure CSP to RightScale for Cost Reporting. If you wish to connect your Azure Enterprise Aggreement to RightScale for cost reporting purposes, see Connect Azure Enterprise Agreement to RightScale for Cost Reporting.
Create a Microsoft Azure Resource Manager Account
- Log in to your Microsoft account. https://login.live.com/
- Sign-up for a Microsoft Azure Resource Manager account. https://account.windowsazure.com/SignUp
- Create a subscription for the required services. Click the Sign up for a free trial option and provide the required personal and billing information.
Click add subscription.
At a minimum, please select the 'Pay-As-You-Go' option and purchase the subscription.
Click the Portal link. After going through the Microsoft Azure Resource Manager Tour, click on Settings in the left navigational pane.
Connect Microsoft Azure Resource Manager to your RightScale Account
The ARM account used to register with RightScale must have Service Admin or Global Admin of the Active Directory Tenant AND must be a User Access Administrator or Owner of the Subscription being added. If you temporarily add permissions to a user to complete registration, you may revoke those permissions after the subscription is registered, as RightScale will only use the
RightScale Service Principal for authentication.
Connect to the Cloud
After logging into the Dashboard, go to Settings > Account Settings > Clouds. Click Connect to a Cloud.
Next, click the (+) icon next to Microsoft Azure Resource Manager.
You will be taken to Microsoft Azure to complete the oauth authorization process. Click on Accept when prompted to give RightScale access.
Select the target subscription from a list of available Azure Subscriptions to register.
Next, you should see a
successfully registered with cloudsnotification on the top bar.
If the Azure account that you use to authenticate belongs to multiple AD tenants, select the tenant ID that contains the subscription you would like to register first.
If there are no subscriptions available we will present the following error:
Check the Cloud Status
On the same Clouds tab or on the Cloud Credentials widget in the Overview tab, you may check the status of your cloud. Both of these items must be valid and active (green) in order to successfully launch cloud servers: On the Dashboard, go to Settings > Account Settings > Clouds. You should be able to view all the Azure Resource Manager Regions
Once your cloud credentials have been verified, you will see that the Microsoft Azure Resource Manager cloud is enabled under the Clouds tab. You will now see all of your Microsoft Azure Resource Manager resources under the Clouds menu (Clouds > AzureRM). You may need to refresh the tab to view your newly added Azure Resource Manager cloud.
Adding Newly Supported Regions
As RightScale adds support for addtional ARM Regions, complete the steps below to view them in RightScale for your ARM subscriptions that have been previously registered.
You can only add regions using the same already-registered subscription.
- Complete the standard ARM registration steps
The RightScale-Azure Integration
RightScale uses the Azure
Service Principal approach to getting permissions to operate on your subscription, which is the recommended best practice as published by Microsoft.
In short, the RightScale
web application is added to Azure Active Directory (AD) associated with the registered subscription. Then the RightScale application service principal (which shows up as a
user) is granted the
Contributor role to the subscriptions within that AD. The service principal is then used by RightScale to authenticate and make requests on your behalf. RightScale does not store any user credentials for this access in the platform. You can read more about this approach on the Microsoft Azure docs.
The registration process above performs the following tasks:
- Adds the RightScale web application to the Azure AD (if it is not already added)
- Adds the
RightScaleapplication service principal (
user) to the specified subscription with the
- Informs RightScale which subscription to use for this RightScale account
Each of the above steps is explained in more detail below.
Add the RightScale web app to Azure AD
In order for the
RightScale service principal to be granted permissions on a subscription, the RightScale web application must first be added to Azure AD. Today, there is no way to add this application directly via the Azure Portal -- note that there is a RightScale application listed in the marketplace, but that application is used for SSO, not for cloud management integration.
The only way to add this today is to go through the cloud registration process through RightScale as specified above.
The user performing this action must have at least Service Admin on the AD, Global Admin will also work.
After registration, the only permission that the
RightScale Service Principal will have on the Azure AD tenant is
Sign-in and read user profile.
Grant RightScale permission to a subscription
In order for RightScale to be able to manage cloud resources, it must have permissions granted on the Subscriptions in Azure. The RightScale cloud registration process will automatically add the
RightScale service principal to the specified subscription with the Contributor role -- this is the required role for RightScale to have in order to perform cloud management on Azure.
While this permission can be manually granted in AD, the RightScale cloud registration steps must still be followed in order to associate the RightScale account with the correct subscription.
The user performing this action must have at least User Access Administrator on the Subscription, Owner will also work.
After registration, the
RightScale Service Principal will have Contributor access on the Subscription.
RightScale service principal's access from the subscription using the Azure Portal will prevent RightScale from acting on this subscription. The behavior in RightScale at this point will be undefined -- it will not be able to modify or read any information from the subscription.
Associating a RS account with an Azure subscription
The only method to associate a RightScale account with a subscription is to perform the RightScale cloud registration steps above.