What is Service Principal?

Introduction

Service Principal is an application within Microsoft Entra ID, which is authorized to access resources in Azure. This access is restricted by the roles assigned to the service principal, giving you control over which resources can be accessed and at which level.

Turbo360 uses the authentication tokens of the Service Principal to manage the resources, this is achieved by associating the Azure Service Principal with necessary permissions.

These permissions are restricted to exactly what Turbo360 can do.

The necessary activities to perform such restrictions include:

• Create a Service Principal.
• Authorize and Assign a role to the Service Principal.

To associate a Service Principal with Turbo360, the following values are required:

• Microsoft Entra ID - Tenant directory Id.
• Client Id - Id of the Service Principal object / App registered with the Microsoft Entra ID.
• Client Secret - Application password.

These values can be collected from the Azure portal in the following way:

Create a Service Principal

To create a service principal, perform the following steps:

1. Navigate to the Microsoft Entra ID tab in the left side menu in the Azure portal and click App registrations.

2. Click on the New registration button.

3. Provide a Name for the Service Principal. Select a supported account type, which determines who can use the application. Under Redirect URI, select Web for the type of application that needs to be created. Enter the URI to which the access token is sent to. Click on the Register button.

4. Once the Service Principal is created successfully, it will be listed in the App Registration grid.

Get Azure Tenant ID

In Azure Microsoft Entra ID, a tenant is a representative of an organization.

It is a dedicated instance of the Azure Microsoft Entra ID service that an organization receives and owns when it creates by signing up for a Microsoft Azure account.

Each Azure AD tenant is distinct and separate from other Azure Microsoft Entra ID tenants.

In order to obtain the Tenant ID, perform the following steps:

1. Click on the name of the Service Principal.

2. The required Tenant Id is the Directory (tenant) ID from the Essentials section.

Get Client ID and Client Secret

A Client ID is a 16-character string that represents the application.

Follow the below steps to obtain the Client ID:

1. Click on the name of the Service Principal.

2. The required Client Id is the Application (client) ID from the Essentials section.

Secret key is a security key that Windows Live ID uses to encrypt and sign all tokens. It is used by the application to prove its identity when requesting a token.

To obtain the Client Secret, follow the below steps:

1. Click on Certificates & secrets under the Manage section from the left pane.

2. Click on New client secret, provide the Description and Expiry time, and Click Add.

3. Once saved, it will show the Client Secret. This Key will only be shown once. This value should be copied and saved.

Authorize Service Principal and Role Assignment

To access the resources in a subscription, the application must be assigned to a role. The right permissions for each role are defined based on different use cases. The scope of the application can be set at the level of the subscription, resource group, or resource.

Permissions are inherited to lower levels of scope. For example, if an application has the Contributor / Owner role for a resource group, it can access the resource group and any resources it contains.

To authorize the service principal to access a Subscription:

1. Navigate to that Subscription. Click on Access control (IAM).

2. Select Add->Add role assignment.

3. Switch to the Job function roles tab and choose Reader.

4. Clicking Next will proceed to the role assignment screen. Choose User, group, or service principal option for the Assign access to field.

5. Multiple service principals can be assigned with the specified role acess for the relevant Azure Subscription by selecting them as its Members.
   

6. Click Review+assign to review and save the role assignment.

Why does Turbo360 need Reader access for the Service Principal?

To obtain access at the cost of the user's Azure Subscription, the permission required for a Service Principal is Reader access at the Subscription level.

Users cannot view the cost of their Azure Subscription if the required access is not provided.