Lab 9.1: Prepare your Azure Account 
-----------------------------------

.. note:: Estimated time to complete: **15 minutes**

.. include:: /accesslab.rst

Tasks
^^^^^
.. warning:: If you already created an Azure Application in Class 2 (Azure SSG), you do not need to recreate this item.

Setting up a Service Principal Account

.. note:: Needs to be done by an admin in the subscription

1. Registering an application

- On the Azure portal, go to Azure Active Directory → App registrations
- Click on "+ New registration"
- Enter the following values
  Name: <Name of the application>
- Click Create

.. image:: pictures/img_module5_lab1_1a.png
  :align: center
  :scale: 50%

- Click on Certificates & secrets → New client secret
- Enter a Description and select Expiration period.

.. image:: pictures/img_module5_lab1_1b.png
  :align: center
  :scale: 50%

2. Adding additional Application Owners

- On the Azure portal, go to Azure Active Directory → App registrations → <the app you created in Registering an application>
- Click on Settings → Owners → Add owner
- Enter the user's F5 email address to search
- Select the user and click on Select

.. image:: pictures/img_module5_lab1_2.png
  :align: center
  :scale: 50%

3. Generating Service Principal Secret

- On the Azure portal, go to Azure Active Directory → App registrations → <the app you created in Registering an application>
- Click on Settings → Keys
- Enter the user's name in the Description field and select "Never Expires" for the duration
- Click on Save
- Copy the Value field and save it somewhere. This needs to be provided to the user, to be able to configure an Azure provider in BIG-IQ

.. image:: pictures/img_module5_lab1_3.png
  :align: center
  :scale: 50%

4. Granting access control to the application

- On the Azure portal, go to Azure Active Directory → All Services
- Click on Subscriptions
- Click on the subscription that you are using for the application
- Click on Access Control (IAM) 
- Click on Add
- Select Role Assignment
- Select "Contributor" in the drop-down for the Role
- Type in the Application name created in Step 1.
- Click on Save

.. image:: pictures/img_module5_lab1_4.png
  :align: center
  :scale: 50%

5. Credentials needed for configuring Azure Provider in BIG-IQ

The following pieces of information are needed to configure an Azure Provider.
This information is required to make API call to Azure for resource CRUD operations, either through Java or through Ansible.

- **Subscription Id**: You can get this by clicking on Subscriptions in Azure portal and copying the ``Subscription Id``.
- **Tenant Id**: Go to Azure Active Directory → Properties and copy the value of the Directory ID. This is the ``Tenant Id``.
- **Client Id**: Go to Azure Active Directory → App registrations and copy the value of the Application ID. This is the ``Client Id``.
- **Service Principal Secret**: Copy the value saved in step 5 of generating ``Service Principal Secret``.

.. warning:: we need something unique for the Username since other students do the lab, and you may use the same Azure corporate account. 

6. Subscribe to the BIG-IP instance in the ``Azure Marketplace``

Before being able to deploy an instance in ``Azure``, you'll have to **subscribe** to this license agreement.

Go here to **subscribe** to the right F5 instance we will use in this lab: 

*F5 BIG-IP VE – ALL (BYOL, 1 Boot Location)*

Once you've subscribed, you should see something like this: 

.. image:: pictures/img_module5_lab1_5.png
  :align: center
  :scale: 50%

.. image:: pictures/img_module5_lab1_6.png
  :align: center
  :scale: 50%

7. Create the Azure environment and VPN

The below script takes Azure parameters and creates Azure resources. These resources are used in BIG-IQ as a place to our BIG-IP to be deployed and configured.

SSH Ubuntu host in the lab environment.

Navigate to: ``cd f5-azure-vpn-ssg``

Modify the **config.yml** file: ``vi config.yml``

.. note:: `How to Use the vi Editor`_
.. _How to Use the vi Editor: https://www.cs.colostate.edu/helpdocs/vi.html

Modify the following four items to reflect the Azure Application you created above:

- SUBSCRIPTION_ID: <Subscription Id>
- TENANT_ID: <Tenant Id>
- CLIENT_ID: <Client Id>
- SERVICE_PRINCIPAL_SECRET: <Service Principal Secret>
- PREFIX: Specify a prefix that will be used on each object automatically created.

Execute the Ansible scripts to create the Azure resources (including VPN between Azure and the lab), cloud provider and cloud environment.

``./000-RUN_ALL.sh ve``

.. note:: The Azure objects can take up to 15 minutes to complete.